http_build_query

(PHP 5)

http_build_query - формирует строку запроса URL на основании переданного ассоциативного массива

string http_build_query ( array $formdata [, string $numeric_prefix [, string $arg_separator ]] )

formdata Может быть массив или объект, содержащий свойства. Может быть простой одномерной структуры, либо массив массивов (который в свою очередь, может содержать другие массивы). Numeric_prefix Если числовые индексы, используемые в базе массива и этот параметр, то она будет prepended для числовых Индекс элемента в массиве только базу. Это означало, чтобы для юридических когда имена переменных данных декодирован PHP или другого CGI приложений позже on.arg_separator arg_separator.output используется в качестве разделителя аргументов, если этот параметр не определен, а затем использоваться.

Пример 1 Simple usage of http_build_query()

$data = array('foo'=>'bar',
 'baz'=>'boom',
 'cow'=>'milk',
 'php'=>'hypertext processor');

echo http_build_query($data); // foo=bar&baz=boom&cow=milk&php=hypertext+processor
echo http_build_query($data, '', '&'); // foo=bar&baz=boom&cow=milk&php=hypertext+processor

Пример 2 http_build_query() with numerically index elements.

$data = array('foo', 'bar', 'baz', 'boom', 'cow' => 'milk', 'php' =>'hypertext processor');

echo http_build_query($data) . "\n";
echo http_build_query($data, 'myvar_');

Результат выполнения данного примера:

0=foo&1=bar&2=baz&3=boom&cow=milk&php=hypertext+processor myvar_0=foo&myvar_1=bar&myvar_2=baz&myvar_3=boom&cow=milk&php=hypertext+processor

Пример 3 http_build_query() with complex arrays

$data = array('user'=>array('name'=>'Bob Smith',
 'age'=>47,
 'sex'=>'M',
 'dob'=>'5/12/1956'),
 'pastimes'=>array('golf', 'opera', 'poker', 'rap'),
 'children'=>array('bobby'=>array('age'=>12,
 'sex'=>'M'),
 'sally'=>array('age'=>8,
 'sex'=>'F')),
 'CEO');

echo http_build_query($data, 'flags_');
user%5Bname%5D=Bob+Smith&user%5Bage%5D=47&user%5Bsex%5D=M& user%5Bdob%5D=5%2F12%2F1956&pastimes%5B0%5D=golf&pastimes%5B1%5D=opera& pastimes%5B2%5D=poker&pastimes%5B3%5D=rap&children%5Bbobby%5D%5Bage%5D=12& children%5Bbobby%5D%5Bsex%5D=M&children%5Bsally%5D%5Bage%5D=8& children%5Bsally%5D%5Bsex%5D=F&flags_0=CEO

Замечание: Only the numerically indexed element in the base array "CEO" received a prefix. The other numeric indices, found under pastimes, do not require a string prefix to be legal variable names.

Пример #4 Using http_build_query() with an object

class myClass {
 var $foo;
 var $baz;

 function myClass() {
 $this->foo = 'bar';
 $this->baz = 'boom';
 }
}

$data = new myClass();

echo http_build_query($data); // foo=bar&baz=boom
Эмулятор функции http_build_query()
if(!function_exists('http_build_query')) {

    function http_build_query($data , $prefix = null , $sep = ") {
        $ret = array();
        foreach((array) $data as $k => $v) {
            $k = urlencode ( $k );
            if(is_int($k) && $prefix != NULL) {
                $k = $prefix . $k ;
            }
            if( is_array($v) || is_object($v)) {
                array_push($ret , http_build_query($v , ", $sep, $k));
            } else {
                array_push($ret , $k . "=" . urlencode($v));
            }
        }
        if(empty($sep)) {
            $sep = ini_get("arg_separator.output");
        }
        return implode($sep , $ret);
    }
}

Смотрите также parse_str(), parse_url(), urlencode(), array_walk().

Все функции array
Все функции перекодирование
Описание на ru2.php.net
Описание на php.ru