query_data
可以是数组或包含属性的对象。
一个
query_data 数组可以是简单的一维结构,也可以是由数组组成的数组(其依次可以包含其它数组)。
如果
query_data 是一个对象,只有 public 的属性会加入结果。
numeric_prefix
如果在基础数组中使用了数字下标同时给出了该参数,此参数值将会作为基础数组中的数字下标元素的前缀。
这是为了让 PHP 或其它 CGI 程序在稍后对数据进行解码时获取合法的变量名。
arg_separator
除非指定并使用了这个参数,否则会用 arg_separator.output 来分隔参数。
enc_type
默认使用
PHP_QUERY_RFC1738。
如果
enc_type 是
PHP_QUERY_RFC1738,则编码将会以 » RFC 1738 标准和
application/x-www-form-urlencoded 媒体类型进行编码,空格会被编码成加号(
+)。
如果
enc_type 是
PHP_QUERY_RFC3986,将根据 » RFC 3986 编码,空格会被百分号编码(
%20)。
代码演示
$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
?>
$data = array('foo', 'bar', 'baz', 'boom', 'cow' => 'milk', 'php' =>'hypertext processor');
echo http_build_query($data);
输出:
0=foo&1=bar&2=baz&3=boom&cow=milk&php=hypertext+processor
echo http_build_query($data, 'myvar_');
myvar_0=foo&myvar_1=bar&myvar_2=baz&myvar_3=boom&cow=milk&php=hypertext+processor
?>
$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[name]=Bob+Smith&user[age]=47&user[sex]=M&user[dob]=5%1F12%1F1956&
pastimes[0]=golf&pastimes[1]=opera&pastimes[2]=poker&pastimes[3]=rap&
children[bobby][age]=12&children[bobby][sex]=M&children[sally][age]=8&
children[sally][sex]=F&flags_0=CEO
注意:只有基础数组中的数字下标元素“CEO”才获取了前缀,其它数字下标元素(如
pastimes 下的元素)则不需要为了合法的变量名而加上前缀。
?>
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
?>