本文介绍如何在 php 中将标准 url 查询字符串（如 postman 发送的 raw form-data 或 application/x-www-form-urlencoded 数据）高效、准确地转换为键值对关联数组，重点讲解内置函数 parse_str() 的正确用法、编码注意事项及常见陷阱。
本文介绍如何在 php 中将标准 url 查询字符串（如 postman 发送的 raw form-data 或 application/x-www-form-urlencoded 数据）高效、准确地转换为键值对关联数组，重点讲解内置函数 parse_str() 的正确用法、编码注意事项及常见陷阱。
在 Web 开发中，经常需要处理来自客户端（如 Postman、前端表单或第三方 API）传递的 URL 编码格式字符串，例如：
rq_uuid=e53473de-0483-44f5-91f0-2be74e58c277&rq_datetime=2022-03-09%2016%3A33%3A16&sender_id=TESS&receiver_id=SGRQWES
注意：实际传输中空格、冒号等特殊字符会被 URL 编码（如空格 → %20，: → %3A），因此原始字符串必须是合法的 URL 编码格式，否则 parse_str() 行为不可预期。
✅ 正确解析方式：使用 parse_str()
PHP 提供了原生函数 parse_str()，专用于将 URL 查询字符串解析为 PHP 关联数组。其语法简洁且无需手动 urldecode() —— 函数内部会自动解码所有百分号编码（URL-decode）：
<?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); ?>
输出结果为：
立即学习“PHP免费学习笔记（深入）”；
Array
(
[rq_uuid] => e53473de-0483-44f5-91f0-2be74e58c277
[rq_datetime] => 2022-03-09 16:33:16
[sender_id] => TESS
[receiver_id] => SGRQWES
)✅ 关键特性说明：
- 第二个参数 $params 是引用传入的数组变量，解析结果直接写入其中；
- 自动处理 +（代表空格）、%xx 编码，无需额外 urldecode()；
- 支持嵌套键名（如 user[name]=John&user[age]=30 → 自动转为多维数组）；
- 若字符串含重复键名（如 id=1&id=2），后出现的值将覆盖前者（PHP 默认行为）。
⚠️ 注意事项与最佳实践
不要省略第二个参数：
❌ 错误写法：parse_str($queryString);
→ 这会将键名作为变量名注入当前作用域（如创建 $rq_uuid 变量），存在安全与命名冲突风险。
✅ 始终显式传入目标数组：parse_str($queryString, $data);确保输入是干净的查询字符串：
若原始字符串以 ? 开头（如 ?rq_uuid=...），需先用 ltrim($str, '?') 去除；
若含 URL 路径或完整 URL（如 https://api.example.com/?...），请先用 parse_url() 提取 query 部分。字符编码兼容性：
parse_str() 按当前脚本的默认编码（通常是 UTF-8）解码。若源数据为 GBK 等非 UTF-8 编码，需先转换编码再解析（不推荐，应统一使用 UTF-8）。空值与布尔值处理：
parse_str() 不识别 true/false 字面量，foo=true 仍返回字符串 'true'；如需类型转换，请后续用 (bool) 或自定义映射逻辑处理。
? 总结
parse_str() 是 PHP 解析 URL 编码字符串的标准、安全、高效方案。它规避了正则拆分、explode() 手动解析等易出错方式，同时兼顾兼容性与性能。只要确保输入格式规范（标准 query string）、始终传入目标数组变量，并注意编码一致性，即可稳定获得结构清晰的关联数组，适用于 API 请求解析、日志回放、测试数据模拟等多种场景。
