php http_build_query 函数布尔值处理及 post/get 请求差异分析
本文探讨了 PHP 中 http_build_query 函数处理布尔值时，POST 请求与 GET 请求结果差异巨大的问题。 如下图所示，该问题源于 http_build_query 函数的布尔值转换机制。
http_build_query 函数遵循 RFC1738 编码规范，该规范未明确定义布尔值的编码方式。PHP 将布尔值转换为字符串 "1" (true) 或 "0" (false)，这与某些后端系统期望的 "true" 或 "false" 字符串不符，从而导致 POST 请求类型检查失败。GET 请求通常不受影响，可能是因为后端处理 GET 请求的方式不同。Python 请求正常则表明 Python 的请求库处理布尔值的方式与 PHP 不同。
为了解决此问题，建议在使用 http_build_query 之前，先将数组中的布尔值转换为字符串 "true" 或 "false"。可以使用 array_walk_recursive 函数递归遍历数组，进行如下替换：
立即学习“PHP免费学习笔记（深入）”；
<?php
$arr = [
'id' => 1,
'is_admin' => false,
'permissions' => [
'write' => false,
'read' => true,
'delete' => false,
'edit' => true,
'advanced' => [
'report' => true,
'down' => true,
],
],
];
array_walk_recursive($arr, function (&$val) {
if (is_bool($val)) {
$val = $val ? 'true' : 'false';
}
});
echo http_build_query($arr);
// 输出：id=1&is_admin=false&permissions[write]=false&permissions[read]=true&permissions[delete]=false&permissions[edit]=true&permissions[advanced][report]=true&permissions[advanced][down]=true
?>
此外，如果后端使用 JSON 格式接收数据，则应直接发送 JSON 数据，而非使用 http_build_query 生成的查询字符串。 POST 请求与 GET 请求的差异也可能与后端如何处理 x-www-form-urlencoded 编码的数据有关，建议检查后端代码以确认其处理方式。 Python 请求的正常运行则提示需要检查 Python 客户端发送的请求数据格式。
