PHPのparse_str()関数とは？使い方とサンプルコードをわかりやすく解説

PHPのparse_str()関数は、「name=value&name=value」といったURLクエリ形式で記述された文字列を解析し、その内容を変数や配列に格納するための関数です。この関数は戻り値を持ちません。

基本構文

parse_str(str, arr)

パラメータ

• str：解析対象となる入力文字列。URLクエリ文字列と同じ形式で指定します。

• arr：解析結果を格納する配列の名前。この引数を指定すると、現在のスコープ内の変数が上書きされることなく、指定した配列に結果が保存されます。

戻り値

parse_str()関数は値を返しません（void）。解析結果は、第2引数として渡した配列に格納されます。

使用例1：基本的な使い方

以下は、クエリ形式の文字列を配列に変換する基本的な例です。

<?php
    parse_str("studentname=Jack&amp;marks=95", $arr);
    print_r($arr);
?>

出力結果

Array
(
    [studentname] => Jack
    [marks] => 95
)

使用例2：複数のキーと値を持つ文字列の解析

次に、複数の項目を含む文字列を解析する例を見てみましょう。

<?php
    parse_str("studentname=Tom&amp;studentmarks=95&amp;studentsubject=Maths", $arr);
    print_r($arr);
?>

出力結果

Array
(
    [studentname] => Tom
    [studentmarks] => 95
    [studentsubject] => Maths
)

注意点：セキュリティと非推奨事項

第2引数を省略して呼び出した場合、PHP 7.2以降ではこの挙動が非推奨（E_DEPRECATED）となり、PHP 8.0以降では第2引数の指定が必須になっています。また、GETやPOSTなどユーザーからの入力を直接parse_str()に渡すと、意図しない変数の上書きが発生する危険性があります。必ず第2引数を指定し、入力値の検証を行うことが強く推奨されます。