http_build_query 生成 URL-encode 之后的请求字符串
发表日期：2021-07-01 08:56:30 | 来源： | | 浏览(874) 分类：URL 函数
http_build_query
(PHP 5, PHP 7, PHP 8)
http_build_query — 生成 URL-encode 之后的请求字符串
说明
mixed
$query_data,string
$numeric_prefix = ?,string
$arg_separator = ?,int
$enc_type = PHP_QUERY_RFC1738): string
使用给出的关联（或下标）数组生成一个经过 URL-encode 的请求字符串。
参数
-
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）。
返回值
返回一个 URL 编码后的字符串。
更新日志
| 版本 | 说明 |
|---|---|
| 5.4.0 |
加入了 enc_type 参数。
|
| 5.1.3 | 方括号也会被转义。 |
| 5.1.2 |
加入了参数 arg_separator。
|
范例
示例 #1 http_build_query() 使用示例
<?php
$data = array('foo'=>'bar', 'baz'=>'boom', 'cow'=>'milk', 'php'=>'hypertext processor');
echo http_build_query($data) . "\n";
echo http_build_query($data, '', '&
');
?>
以上例程会输出：
foo=bar&baz=boom&cow=milk&php=hypertext+processor 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) . "\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() 使用复杂的数组
<?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%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
注意:
只有基础数组中的数字下标元素“CEO”才获取了前缀，其它数字下标元素（如 pastimes 下的元素）则不需要为了合法的变量名而加上前缀。
示例 #4 http_build_query() 使用对象
<?php
class parentClass {
public $pub = 'publicParent';
protected $prot = 'protectedParent';
private $priv = 'privateParent';
public $pub_bar = Null;
protected $prot_bar = Null;
private $priv_bar = Null;
public function __construct(){
$this->pub_bar = new childClass();
$this->prot_bar = new childClass();
$this->priv_bar = new childClass();
}
}
class childClass {
public $pub = 'publicChild';
protected $prot = 'protectedChild';
private $priv = 'privateChild';
}
$parent = new parentClass();
echo http_build_query($parent);
?>
以上例程会输出：
pub=publicParent&pub_bar%5Bpub%5D=publicChild
参见
- parse_str() - 将字符串解析成多个变量
- parse_url() - 解析 URL，返回其组成部分
- urlencode() - 编码 URL 字符串
- array_walk() - 使用用户自定义函数对数组中的每个元素做回调处理
- PHP（0）
- PHP杂项（34）
- PHP基础-李炎恢系列课程（20）
- 中文函数手册（0）
- 错误处理 函数（13）
- OPcache 函数（6）
- PHP 选项/信息 函数（54）
- Zip 函数（10）
- Hash 函数（15）
- OpenSSL 函数（63）
- Date/Time 函数（51）
- 目录函数（9）
- Fileinfo 函数（6）
- iconv 函数（11）
- 文件系统函数（81）
- 多字节字符串 函数（57）
- GD 和图像处理 函数（114）
- 可交换图像信息（5）
- Math 函数（50）
- 程序执行函数（11）
- PCNTL 函数（23）
- JSON 函数（4）
- SPL 函数（15）
- URL 函数（10）
- base64_decode 对使用 MIME base64 编码的数据进行解码（0）
- base64_encode 使用 MIME base64 对数据进行编码（0）
- get_headers 取得服务器响应一个 HTTP 请求所发送的所有标头（0）
- get_meta_tags 从一个文件中提取所有的 meta 标签 content 属性，返回一个数组（0）
- http_build_query 生成 URL-encode 之后的请求字符串（0）
- parse_url 解析 URL，返回其组成部分（0）
- rawurldecode 对已编码的 URL 字符串进行解码（0）
- rawurlencode 按照 RFC 3986 对 URL 进行编码（0）
- urldecode 解码已编码的 URL 字符串（0）
- urlencode 编码 URL 字符串（0）
- cURL 函数（32）
- 网络 函数（33）
- FTP 函数（36）
- Session 函数（23）
- PCRE 函数（11）
- PCRE 正则语法（19）
- 数组 函数（81）
- 类/对象 函数（18）
- 函数处理 函数（13）
- 变量处理 函数（37）
- SimpleXML 函数（3）
- 杂项 函数（31）
- 字符串 函数（101）
宁公网安备 64010402001209号