http_build_query用法,挺方便的

http_build_query

(PHP 5)

http_build_query -- 生成 url-encoded 之后的请求字符串描述string http_build_query ( array formdata [, string numeric_prefix] )

使用给出的关联(或下标)数组生成一个 url-encoded 请求字符串。参数 formdata 可以是数组或包含属性的对象。一个formdata 数组可以是简单的一维结构,也可以是由数组组成的数组(其依次可以包含其它数组)。如果在基础数组中使用了数字下标同时给出了 numeric_prefix 参数,此参数值将会作为基础数组中的数字下标元素的前缀。这是为了让 PHP 或其它 CGI 程序在稍后对数据进行解码时获取合法的变量名。

例子 1. http_build_query() 使用示例

<?php 
$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 
*/ 
?>

例子 2. http_build_query() 使用数字下标的元素

<?php 
$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 
*/ 
?>

例子 3. http_build_query() 使用复杂的数组

<?php 
$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 下的元素)则不需要为了合法的变量名而加上前缀。 
*/ 
?>

例子 4. http_build_query() 使用对象

<?php 
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()就是将一个数组转换成url 问号?后面的参数字符串,并且会自动进行urlencode处理。

还是引用一下官方的解释:

http_build_query

http_build_query -- 生成 url-encoded 之后的请求字符串描述string http_build_query ( array formdata [, string numeric_prefix] )

使用给出的关联(或下标)数组生成一个 url-encoded 请求字符串。参数 formdata 可以是数组或包含属性的对象。一个 formdata 数组可以是简单的一维结构,也可以是由数组组成的数组(其依次可以包含其它数组)。如果在基础数组中使用了数字下标同时给出了 numeric_prefix 参数,此参数值将会作为基础数组中的数字下标元素的前缀。这是为了让 PHP 或其它 CGI 程序在稍后对数据进行解码时获取合法的变量名。

还是看一些简单的例子吧:

01 $data array(
02     'foo'=>'bar',
03     'baz'=>'boom',
04     'site'=>'www.nowamagic.net',
05     'name'=>'nowa magic');
06      
07 echo http_build_query($data);
08  
09 /* output
10     foo=bar&baz=boom&cow=milk&php=hypertext+processor
11 */

如果是索引数组与关联数组混合而成的数组又如何呢?

01 $data array(
02     'foo',
03     'bar',
04     'site'=>'www.nowamagic.net',
05     'name'=>'nowa magic');
06      
07 echo http_build_query($data);
08  
09 /* output
10     0=foo&1=bar&site=www.nowamagic.net&name=nowa+magic
11 */

它会自动添加数字索引。

http_build_query 还有一个参数,可以给数字索引加前缀,我们再试试:

01 $data array(
02     'foo',
03     'bar',
04     'site'=>'www.nowamagic.net',
05     'name'=>'nowa magic');
06      
07 echo http_build_query($data"nm_");
08  
09 /* output
10     nm_0=foo&nm_1=bar&site=www.nowamagic.net&name=nowa+magic
11 */

再复杂一些的数组又如何呢?比如二维数组什么的。

01 $data array(
02     'user'=>array(   'name'=>'Bob Smith',
03                     'age'=>47,
04                     'sex'=>'M',
05                     'dob'=>'5/12/1956'),
06       'pastimes'=>array('golf''opera''poker''rap'),
07       'children'=>array('bobby'=>array('age'=>12,
08                                        'sex'=>'M'),
09                         'sally'=>array('age'=>8,
10                                        'sex'=>'F')),
11       'CEO');

它的输出结果则是:

1 user%5Bname%5D=Bob+Smith&user%5Bage%5D=47&user%5Bsex%5D=M&user%5Bdob%5D=5%2F12%2F1956
2 &pastimes%5B0%5D=golf&pastimes%5B1%5D=opera&pastimes%5B2%5D=poker
3 &pastimes%5B3%5D=rap&children%5Bbobby%5D%5Bage%5D=12&children%5Bbobby%5D%5Bsex%5D=M
4 &children%5Bsally%5D%5Bage%5D=8&children%5Bsally%5D%5Bsex%5D=F&0=CEO

为了可读性对其进行了折行:

1 user[name]=Bob+Smith&user[age]=47&user[sex]=M&user[dob]=5%1F12%1F1956&
2 pastimes[0]=golf&pastimes[1]=opera&pastimes[2]=poker&pastimes[3]=rap&
3 children[bobby][age]=12&children[bobby][sex]=M&children[sally][age]=8&
4 children[sally][sex]=F&flags_0=CEO

注意:只有基础数组中的数字下标元素“CEO”才获取了前缀,其它数字下标元素(如 pastimes 下的元素)则不需要为了合法的变量名而加上前缀。

不只是数组,连对象也能转化为URL字符串:

01 class myClass {
02    var $foo;
03    var $baz;
04    function myClass() {
05     $this->foo = 'bar';
06     $this->baz = 'boom';
07    }
08 }
09 $data new myClass();
10      
11 echo http_build_query($data);

末尾,再提几个函数,很可能在你搜索 http_build_query 时需要了解的:

  • parse_str:将一个url ?后面的参数转换成一个数组,array parse_str(url,arr)。
  • parse_url:将一个完整的url解析成数组,array parse_url(string url)。
  • http_build_query:再简要解释下,将一个数组转换成url ?后面的参数字符串,会自动进行urlencode处理,string http_build_query ( array formdata [, string numeric_prefix]),后面的给数组中没有指定键或者键为数字的加下标。

 

posted @ 2016-01-11 19:45  ╭(╯3╰)╮尝尝鲜  阅读(503)  评论(0编辑  收藏  举报