深入解析parse_str函數

一、parsestring

parse_str函數是PHP自帶的一個函數，主要作用是將一個字元串解析成多個變數。

語法格式：

void parse_str ( string $encoded_string , array &$result )

其中，encoded_string是需要解析的字元串，result是可選的輸出變數數組，如果不設置，則會自動創建一個數組。

二、parsestrategy

parse_str函數的解析策略如下：

首先按照&將字元串分割成多個鍵值對，然後再按照=將每個鍵值對分割成鍵和值。此時，一般情況下，鍵和值會被URL編碼（使用rawurlencode函數），也就是將一些特殊字元轉換成%XX的形式（其中XX表示轉換後的字元ASCII碼的十六進位表示）。

如果一個鍵值對中出現了數組形式，例如a[]=1&a[]=2，那麼結果數組中，a鍵對應的值就是一個數組。

三、parsestream

parse_str函數同樣支持從輸入流中解析字元串，使用方式如下：

parse_str(file_get_contents("php://input"), $data);  // 獲取POST請求的body中字元串，並解析成數組

這個特性在AJAX請求中特別有用，當請求參數中包含數組或者嵌套的數組時，可以通過json_encode和json_decode來方便地處理。

四、parsestring命令

parse_str函數同樣可以與命令行結合使用，解析命令行傳參的字元串，使用方式如下：

parse_str(implode('&', array_slice($argv, 1)), $_GET);  // 獲取運行腳本時傳遞的參數，並解析成數組

這在寫命令行工具時非常有用，可以方便地獲取傳遞參數。

五、parsestring函數

parse_str函數的API非常簡單，實際上可以通過下面的代碼來實現基本相同的功能：

function parse_string($str){
    parse_str($str, $output);
    return $output;
}

這樣做的意義在於，我們常常需要將一個字元串解析成數組，並在某些地方使用，如果在每個需要解析的地方都寫一遍parse_str，會十分麻煩。我們可以封裝一個函數，以後只需要調用這個函數，就可以方便地獲得解析後的數組了。

六、parsestringitem

parse_str函數有一個細節，就是它可以用於解析一個用於URL傳參的查詢字元串，例如a=1&b=2。然而，它不會對數組中的鍵做進一步的解析，例如a[b]=2，會被解析成一個”a”鍵，對應一個數組，其元素為”b”鍵和對應的值。對於這種情況，我們可以通過手動解析字元串來實現。例如：

function parse_string_item($str) {
    $result = array();
    $pairs = explode("&", $str);
    foreach($pairs as $pair) {
        $kvp = explode("=", $pair);
        $k = urldecode($kvp[0]);
        $v = urldecode($kvp[1]);
        preg_match('/^[^\[]+/i', $k, $matches);
        $key = $matches[0];
        if (preg_match_all('/\[([^\]]*)\]/i', $k, $matches)) {
            $levels = $matches[1];
            array_push($levels, $v);
            $walk = &$result;
            foreach ($levels as $level) {
                if ($level == "") {
                    $walk = &$walk[];
                } else {
                    if (!isset($walk[$level])) {
                        $walk[$level] = array();
                    }
                    $walk = &$walk[$level];
                }
            }
            unset($walk);
        } else {
            $result[$key] = $v;
        }
    }
    return $result;
}

這個代碼使用正則表達式解析了類似a[b][c]=1這樣的字元串格式，能夠方便地得到一個嵌套的數組。

七、parsestring skill

最後，我們給出一個根據特定的鍵名獲取一個數組的某個值的技巧：

$url = "https://www.example.com?a=1&b[c]=2";
$params = parse_str($url);

// 假設我們需要獲取b[c]這個鍵對應的值
$key = "b[c]";
$value = $params;
foreach (explode('[', $key) as $chunk) {
    $chunk = rtrim($chunk, ']');
    if (isset($value[$chunk])) {
        $value = $value[$chunk];
    } else {
        $value = null;
        break;
    }
}
echo $value;

這段代碼的輸出為2。

總結

通過本文的介紹，我們可以了解到parse_str函數的基本用法以及一些應用技巧，其中包括從字元串、輸入流、命令行解析參數、手動解析包含嵌套數組的查詢字元串，以及根據鍵名獲取嵌套數組的值等。parse_str非常實用，可以極大地簡化代碼編寫的難度，提高開發效率。