本文实例讲述了PHP使用http_build_query()构造URL字符串的方法。

简单来说，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 程序在稍后对数据进行解码时获取合法的变量名。

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

$data = array(
    'foo'=>'bar',
    'baz'=>'boom',
    'site'=>'www.nowamagic.net',
    'name'=>'nowa magic');
echo http_build_query($data);
/* output
 foo=bar&baz=boom&cow=milk&php=hypertext+processor
*/

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

$data = array(
    'foo',
    'bar',
    'site'=>'www.nowamagic.net',
    'name'=>'nowa magic');
echo http_build_query($data);
/* output
    0=foo&1=bar&site=www.nowamagic.net&name=nowa+magic
*/

它会自动添加数字索引。

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

$data = array(
    'foo',
    'bar',
    'site'=>'www.nowamagic.net',
    'name'=>'nowa magic');
echo http_build_query($data, "nm_");
/* output
nm_0=foo&nm_1=bar&site=www.nowamagic.net&name=nowa+magic
*/

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

$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');

它的输出结果则是：

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&0=CEO

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

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

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

class myClass {
  var $foo;
  var $baz;
  function myClass() {
  $this->foo = 'bar';
  $this->baz = 'boom';
  }
}
$data = new myClass();
echo http_build_query($data);

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

1. parse_str：将一个url ?后面的参数转换成一个数组，array parse_str(url,arr)。

2. parse_url：将一个完整的url解析成数组，array parse_url(string url)。

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

http_build_query函数带来的困扰

http_build_query是用来生成URL请求字符串的函数,很简单.不过今天却出现了一点小意外,在本机安装公司社区时,出现了无法登录的情况.但在测试服务器正常.经过地毯式排错,找到问题代码(仅演示,屏蔽敏感内容):

$Args = array( 
“usr” => “touchboy”, 
“pwd” => “123456″, 
“ip” => “127.0.0.1″, 
“src” => “account” 
); 
$query= http_build_query( $Args ); 

测试服务器得到结果为:
usr=touchboy&pwd=123456&ip=127.0.0.1&src=account
而我本地结果为:
usr=touchboy &pwd=123456 &ip=127.0.0.1 &src=account
中间的连接符出现了差异,服务器为正常的”&”,而我本地却是转义后的”&”,最终导致本地提交数据错误.
查看手中的PHP手册,http_build_query一节对此问题只字未提.所以想到的补救方法就只有用htmlspecialchars_decode($query)还原连接符.不过始终觉得可疑,为什么两台机子结果不一样.开始怀疑是Linux(服务器)和windows(本机)的差异,但经过对另一台windows机子的测试,结果正常.后就怀疑是环境配置的问题,经过一番google,果然真相大白.问题元凶在php.ini配置中一行:
arg_separator.output = “&”
将arg_separator.output定义为”&”,重启apache,问题解决!
顺带说下PHP手册的问题,因我用的手册是之前比较经典的《PHP5中文手册文档版》(2006-11-05编译),2年半以前的东东,内容应该停留在PHP 5.1.0的阶段.很多内容已经滞后了.之后下载了陈浩(Haohappy)的《PHP中文手册》(2009-02-15编译),查看http_build_query一节,发现里面出现一行相关提示:
Note: 用 arg_separator.output 来分隔参数。 
到官方查看最新手册,发现里面有更详尽阐述,说明在5.1.2版增加了$arg_separator 参数可以解决此问题.看来中文的手册滞后还是很严重,5.1.2应该是一年前发布的,而2009-02-15编译的最新中文手册仍未收录相关内容.
简而言之,遇到PHP函数故障,节省时间的最好解决方法:
1.第一时间到PHP官方查找答案.
2.保证自己手中的PHP手册是最新的.

• PHP
• http