PHP - http_build_query方法详解（自动拼接生成URL参数字符串）

2016-09-27 发布：hangge 阅读：27239

在开发中我们常常会需要拼接一些带参数的 url 字符串。比如：http://hangge.com/post.php?content=111&list=12&user=12
如果后面参数简单的话手动拼接也没什么问题。如果数据量比较大，比如将一个数组里所有元素、或一个对象里的所有属性都拼接成参数字符串，那么我们就需要循环遍历来实现。其实借助 PHP 自带的 http_build_query() 函数即可轻松满足我们的需求。

1，http_build_query函数介绍

（1）http_build_query() 作用是生成通过 URL 编码后的查询字符串。（即上面的 content=111&list=12&user=12 这个部分）

（2）查询字符串既可以通过数组生成，也可以通过对象生成。而且支持多层次结构。

2，简单的使用样例（简单数组）

<?php
$data = array('foo'=>'航歌',
             'baz'=>'111',
             'cow'=>'222',
             'php'=>'hypertext processor');
             
echo http_build_query($data);
?>

输出结果：

3，没属性名的，自动使用数字索引

对于数组中的基本数据类型，通过 http_build_query() 生成的字符串会自动使用该元素的下标索引作为属性值。

同时对于这种数据，我们还可以自定义统一添加的前缀（不影响其他数据）。

<?php
$data = array('foo', 'bar', 'cow' => 'milk');
          
echo http_build_query($data);
echo "<br>";
echo http_build_query($data, 'hangge_');
?>

输出结果：

4，复杂的数组（多级嵌套）

<?php
$data = array('user'=>array('name'=>'Bob Smith',
                           'age'=>47,
                           'sex'=>'M',
                           'dob'=>'5/12/1956'),
             'pastimes'=>array('golf', 'opera', 'poker', 'rap')
);
                                               
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

http_build_query 将特殊符号（[]）进行了转义，我们这里将其还原，可以将结果看得更清楚些：

user[name]=Bob+Smith&user[age]=47&user[sex]=M&user[dob]=5%2F12%2F1956&pastimes[0]=golf&pastimes[1]=opera&pastimes[2]=poker&pastimes[3]=rap

5，使用对象

<?php
class myClass {
  var $foo;
  var $baz;
  
  function myClass() 
  {
   $this->foo = 'bar';
   $this->baz = 'boom';
  }
}

$data = new myClass();
echo http_build_query($data);
?>

输出结果：