萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP parse_str() 解析查詢字串完整指南:從 URL 參數到陣列的標準化處理

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'=>'']

實戰場景

1. 解析完整 URL 的查詢部分

$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']

2. 重建查詢字串(搭配 http_build_query)

$params = ['search' => 'php', 'page' => 2, 'sort' => 'desc'];
$newQuery = http_build_query($params); // search=php&page=2&sort=desc
// 反向操作完美互補

3. 處理非標準格式(如 Cookie 字串)

$cookieStr = 'session_id=abc123; user_pref=dark_mode; lang=zh-TW';
// 先轉為 & 分隔
$str = str_replace('; ', '&', $cookieStr);
parse_str($str, $cookies);
// 注意:Cookie 值可能包含分號,實際建議用正則或專用解析器

關鍵注意事項

⚠️ magic_quotes_gpc 歷史遺毒(PHP 5.4+ 已移除)

舊版 PHP 若開啟 magic_quotes_gpc,parse_str() 會自動 addslashes()。現代 PHP 無此問題,但若維護舊專案需注意:

if (get_magic_quotes_gpc()) {
    $str = stripslashes($str);
}
parse_str($str, $arr);

⚠️ 不支援 JSON 請求體

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() 處理完整 URL
  • 配合 http_build_query() 實現雙向轉換
  • JSON/CSV/XML 等格式請使用對應專用解析器
copyright © 萬盛學電腦網 all rights reserved