【PHP8.x】INI_SCANNER_RAW定数の使い方

INI_SCANNER_RAW定数は、PHPのiniファイルを解析する際の挙動を制御するオプションを表す定数です。この定数は、主にparse_ini_file()関数やparse_ini_string()関数で、iniファイルやini形式の文字列を連想配列として読み込む際に利用されます。

通常、これらの関数はiniファイル内の値を読み込む際、例えば"true", "false", "on", "off", "none"といったキーワードや、数値形式の文字列に対して、それぞれPHPの適切なデータ型（ブール値、整数、浮動小数点数など）に自動的に変換します。しかし、INI_SCANNER_RAW定数を指定して解析を行うと、このような自動的な型変換は行われず、すべての値が文字列としてそのまま保持されます。

これは、iniファイルに定義された値が、PHPによって意図しないデータ型に変換されてしまうのを避けたい場合に非常に有効です。例えば、my_option = trueという設定があった場合、INI_SCANNER_RAWを指定しないとPHPのブール値trueとしてパースされますが、この定数を指定すると文字列の"true"としてパースされます。このように、設定値を厳密に文字列として扱いたい場合や、後続のプログラムで明示的に型変換を行いたい場合に、INI_SCANNER_RAWは柔軟な設定値の処理を可能にします。

Copy
1<?php
2var_dump(INI_SCANNER_RAW);
3?>

引数なし

引数はありません

int

INI_SCANNER_RAWは、parse_ini_file() 関数などでINIファイルを解析する際に、設定値を文字列としてそのまま取得するための定数です。この定数を指定すると、設定値はエスケープシーケンスなどが展開されずに、元の文字列のまま返されます。