parse_str() 是 PHP 專門解析「查詢字串」(Query String,如 a=1&b=2)為變數或陣列的內建函式。它能自動處理 URL 編碼、多值參數、巢狀結構,是處理 URL、API 回傳、表單資料的標準工具。
parse_str(string $string, array &$result): void
$string:查詢字串(不含 開頭 ?)$result:引用參數,解析後的關聯陣列將存入此變數$result,會直接在當前符號表建立變數(不推薦,污染命名空間、安全風險)<?php
$str = 'id=123&name=John+Doe&tags=php&tags=laravel&tags=api&filter[status]=active&filter[page]=1';
parse_str($str, $output);
print_r($output);
/*
Array
(
[id] => 123
[name] => John Doe
[tags] => Array
(
[0] => php
[1] => laravel
[2] => api
)
[filter] => Array
(
[status] => active
[page] => 1
)
)
*/
| 特性 | 說明 | 範例輸入 → 結果 |
|---|---|---|
| URL 解碼 | 自動 urldecode() | name=John%20Doe → John Doe |
| 同名參數陣列化 | 括號 [] 或重複鍵名 | tags=a&tags=b → ['tags'=>['a','b']] |
| 巢狀結構 | 方括號語法 | filter[status]=1 → ['filter'=>['status'=>'1']] |
| 點號轉底線 | 歷史相容性 | a.b=1 → ['a_b'=>1] |
| 空值處理 | 保留空字串 | empty= → ['empty'=>''] |
$url = 'https://example.com/api?search=php&page=2&sort=desc';
$parts = parse_url($url);
parse_str($parts['query'] ?? '', $params);
// $params = ['search'=>'php', 'page'=>'2', 'sort'=>'desc']
$params = ['search' => 'php', 'page' => 2, 'sort' => 'desc'];
$newQuery = http_build_query($params); // search=php&page=2&sort=desc
// 反向操作完美互補
$cookieStr = 'session_id=abc123; user_pref=dark_mode; lang=zh-TW';
// 先轉為 & 分隔
$str = str_replace('; ', '&', $cookieStr);
parse_str($str, $cookies);
// 注意:Cookie 值可能包含分號,實際建議用正則或專用解析器
舊版 PHP 若開啟 magic_quotes_gpc,parse_str() 會自動 addslashes()。現代 PHP 無此問題,但若維護舊專案需注意:
if (get_magic_quotes_gpc()) {
$str = stripslashes($str);
}
parse_str($str, $arr);
parse_str() 僅處理 application/x-www-form-urlencoded 格式。JSON 需用 json_decode(file_get_contents('php://input'), true)。
超大查詢字串(>1MB)解析會消耗較多記憶體,考慮流式解析或分批處理。
function parseQueryString(string $str): array {
$result = [];
$pairs = explode('&', $str);
foreach ($pairs as $pair) {
if ($pair === '') continue;
[$key, $value] = array_pad(explode('=', $pair, 2), 2, '');
$key = urldecode($key);
$value = urldecode($value);
// 處理陣列語法 key[] 或 key[subkey]
if (preg_match('/^([^[]+)\[(.*?)\]$/', $key, $m)) {
$base = $m[1];
$sub = $m[2];
if ($sub === '') {
$result[$base][] = $value;
} else {
$result[$base][$sub] = $value;
}
} else {
$result[$key] = $value;
}
}
return $result;
}
parse_str($str, $arr) 兩參數形式parse_url() 處理完整 URLhttp_build_query() 實現雙向轉換