本文详解如何使用 php 内置函数 parse_str() 将标准 url 查询字符串（如 postman 发送的 x-www-form-urlencoded 数据）安全、准确地转换为键值对关联数组，并涵盖编码处理、空值防范及常见陷阱。
本文详解如何使用 php 内置函数 parse_str() 将标准 url 查询字符串（如 postman 发送的 x-www-form-urlencoded 数据）安全、准确地转换为键值对关联数组，并涵盖编码处理、空值防范及常见陷阱。
在 Web 开发中，常需处理来自表单提交、Postman 测试或第三方接口的 application/x-www-form-urlencoded 格式数据，例如：
rq_uuid=e53473de-0483-44f5-91f0-2be74e58c277&rq_datetime=2022-03-09%2016%3A33%3A16&sender_id=TESS&receiver_id=SGRQWES
注意：真实场景中，空格、冒号等特殊字符通常已被 URL 编码（如空格 → %20，: → %3A）。PHP 的 parse_str() 函数专为此类字符串设计——它能自动解码并构建成关联数组，无需手动 urldecode()。
✅ 正确用法：parse_str() + 目标数组变量
<?php $queryString = 'rq_uuid=e53473de-0483-44f5-91f0-2be74e58c277&rq_datetime=2022-03-09%2016%3A33%3A16&sender_id=TESS&receiver_id=SGRQWES'; // 关键：传入第二个参数（数组变量），避免污染当前作用域 parse_str($queryString, $params); print_r($params); ?>
输出结果：
Array
(
[rq_uuid] => e53473de-0483-44f5-91f0-2be74e58c277
[rq_datetime] => 2022-03-09 16:33:16
[sender_id] => TESS
[receiver_id] => SGRQWES
)? 提示：parse_str() 会自动对 %xx 编码进行解码，因此 2022-03-09%2016%3A33%3A16 被正确还原为带空格和冒号的日期时间字符串。
立即学习“PHP免费学习笔记（深入）”；
⚠️ 注意事项与最佳实践
- 禁止省略第二个参数：若仅写 parse_str($str)，PHP 会将键名作为变量名直接注入当前作用域（如生成 $rq_uuid 变量），极易引发变量污染与安全风险。始终显式传入目标数组。
- 确保输入格式合法：parse_str() 要求字符串为标准 key=value&key2=value2 格式；若含非法字符（如未编码的空格、换行或 # 片段标识符），可能导致截断或解析失败。建议先用 trim() 清理首尾空白。
- 处理空值与重复键：当出现 key=&key=abc 时，后出现的值会覆盖前者；若仅 key=，对应值为 ''（空字符串），而非 null。如有业务需求区分“未传”与“传空”，需额外校验。
- 不适用于 JSON 或 multipart 数据：此方法仅适用于 x-www-form-urlencoded。若请求体是 JSON，请用 json_decode($input, true)；若是文件上传混合表单（multipart），应通过 $_POST 直接获取。
✅ 安全封装建议（生产环境推荐）
<?php
function parseUrlEncodedString(string $input): array
{
$input = trim($input);
if ($input === '') {
return [];
}
$result = [];
parse_str($input, $result);
return $result;
}
// 使用示例
$params = parseUrlEncodedString($_SERVER['QUERY_STRING'] ?? file_get_contents('php://input'));
// 注意：对于 POST x-www-form-urlencoded 请求体，php://input 可读取原始数据（需确保未被 $_POST 消耗）
?>掌握 parse_str() 的正确用法，可高效、可靠地完成 URL 编码字符串到结构化数组的转换，是构建健壮 API 解析层的基础能力之一。
