PHP的http_build_query函数处理布尔值时，POST请求与GET请求为何差异巨大？

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
$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%5Bwrite%5D=false&permissions%5Bread%5D=true&permissions%5Bdelete%5D=false&permissions%5Bedit%5D=true&permissions%5Badvanced%5D%5Breport%5D=true&permissions%5Badvanced%5D%5Bdown%5D=true
?>

此外，如果后端使用 JSON 格式接收数据，则应直接发送 JSON 数据，而非使用 http_build_query 生成的查询字符串。 POST 请求与 GET 请求的差异也可能与后端如何处理 x-www-form-urlencoded 编码的数据有关，建议检查后端代码以确认其处理方式。 Python 请求的正常运行则提示需要检查 Python 客户端发送的请求数据格式。