http_build_query 函数

适用PHP版本

PHP 4.0.0 及以上版本

函数说明

http_build_query 函数将一个关联数组或对象转化为 URL 编码后的查询字符串。它常用于生成 GET 请求的查询部分。

函数语法

http_build_query(array $data, string $numeric_prefix = "", string $arg_separator = "&", int $enc_type = PHP_QUERY_RFC1738): string

参数

• array $data: 必需。一个包含数据的数组或对象。
• string $numeric_prefix: 可选。为数字键添加前缀（默认为空字符串）。
• string $arg_separator: 可选。指定参数分隔符，默认为“&”。
• int $enc_type: 可选。指定查询字符串编码方式，默认为 PHP_QUERY_RFC1738，可以是 PHP_QUERY_RFC3986 或 PHP_QUERY_RFC1738。

返回值

返回构建的 URL 编码查询字符串。如果输入参数无效，则返回空字符串。

示例

以下是如何使用 http_build_query 函数的示例：

示例代码 1：

$data = array("name" => "John", "age" => 30, "city" => "New York");
$queryString = http_build_query($data);
echo $queryString;

示例代码说明：在这个示例中，$data 是一个关联数组，包含了三个键值对。"name"、"age" 和 "city"。调用 http_build_query 函数后，它会将数组转化为 URL 编码的查询字符串：“name=John&age=30&city=New+York”。

示例代码 2：

$data = array("name" => "John", "age" => 30);
$queryString = http_build_query($data, "", "&", PHP_QUERY_RFC3986);
echo $queryString;

示例代码说明：在这个示例中，我们指定了使用 RFC 3986 编码方式来生成查询字符串。输出的查询字符串为： "name=John&age=30"。