http_build_query 用于将数组生成 url 编码的查询字符串，支持关联/索引/嵌套数组及对象（仅 public 属性），自动编码空格、中文等；传入索引数组会生成数字键如 0=a&1=b，需 numeric_prefix 添加前缀，arg_separator 自定义分隔符，enc_type 可选 rfc1738（空格→+）或 rfc3986（空格→%20）；null 值被忽略，false→空字符串，true→1，对象需预处理，不适用于 json 或 multipart 场景。
http_build_query 生成 URL 查询字符串的基本用法
直接传入关联数组，http_build_query 就能拼出标准的 a=1&b=2&c=hello%20world 这种格式，自动做 URL 编码，不用自己调 urlencode。
常见错误是传入索引数组却期望键名保留：比如 ['a', 'b'] 会变成 0=a&1=b，而不是 a&b。真要扁平参数（如 GET 表单提交无名字段），得手动处理或改用其他方式。
- 支持嵌套数组，例如
['user' => ['name' => '张三', 'age' => 25]]→user[name]=%E5%BC%A0%E4%B8%89&user[age]=25 - 第二个参数可指定前缀，比如
http_build_query($arr, 'prefix_')，所有键名会加prefix_前缀 - 第三个参数是分隔符，默认是
&，可换为;或自定义，但注意服务端是否兼容 - 第四个参数是编码模式，
PHP_QUERY_RFC1738（空格→+）和PHP_QUERY_RFC3986（空格→%20），后者更现代、推荐
中文、特殊字符和 null/bool 值怎么处理
http_build_query 默认用 PHP_QUERY_RFC1738，对中文会编码成 %E4%BD%A0%E5%A5%BD，但空格变成 +，有些 API（尤其是 RESTful 接口）要求空格必须是 %20，这时得显式传 PHP_QUERY_RFC3986。
null 值会被跳过，false 变成空字符串，true 变成 1——这点容易引发 bug：比如 ['active' => false] 生成 active=，而某些后端把空值当 true 处理；['flag' => null] 则完全不出现该参数。
- 想让
false变成0，得提前转换：$data['flag'] = (int)$data['flag'] - 想保留
null并输出为flag=null，不能依赖原生行为，需手动替换或预处理数组 - 避免直接传对象，会触发
Notice: Array to string conversion，先用(array)$obj或get_object_vars()
和 curl、file_get_contents 搭配发 GET 请求时的坑
很多人把 http_build_query 的结果直接拼到 URL 后面，比如 $url . '?' . http_build_query($params)，这在 $url 已含查询参数时会出错（变成 ?a=1&?b=2）。必须先解析原 URL，合并后再重建。
另一个典型问题是没过滤掉空值或敏感字段（如 token、password），导致泄露。生成前应做白名单校验或 unset。
- 安全做法：用
parse_url($url)提取query，再用parse_str转成数组，与新参数合并，最后http_build_query - curl 中若用
CURLOPT_POSTFIELDS发 POST，传数组会自动调用http_build_query（且强制 RFC1738），但传字符串则不会——所以 POST 场景下，明确传字符串更可控 - 如果目标接口要求 JSON，就别用
http_build_query，那是表单编码，不是 JSON
替代方案：什么时候不该用 http_build_query
当你需要生成非 application/x-www-form-urlencoded 格式的数据时，http_build_query 就不适用了。它只负责一种编码规则，不是通用序列化工具。
比如构建 multipart/form-data（文件上传）、JWT payload、或带签名的请求串，都得绕开它。另外，如果参数里有大量重复键（如 ['tag' => ['a', 'b']]），默认行为是 tag[a]=a&tag[b]=b，但有些接口要 tag=a&tag=b，就得用循环 + 手动拼接。
- 重复键需求：用
array_map和http_build_query分别处理每个值，再 implode - 要保留原始键顺序且 PHP 版本
- PHP 8.1+ 支持
http_build_query($array, '', '&', PHP_QUERY_RFC3986)第三个参数可为空字符串，但实际仍需分隔符，空字符串会导致结果无分隔——这是文档没写清的隐性限制
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
