(PHP 5 >= 5.3.0, PHP 7, PHP 8)
parse_ini_string — 設定文字列をパースする
$ini_string, bool $process_sections = false, int $scanner_mode = INI_SCANNER_NORMAL): array|false
parse_ini_string() は、文字列
ini_string の設定を連想配列で返します。
文字列の構造は、php.ini の構造と同じです。
ini_stringパースしたい ini ファイルの内容。
process_sections
process_sections
を true に設定すると、セクション名と設定を含む多次元配列を返します。
process_sections のデフォルトは false です。
scanner_mode
INI_SCANNER_NORMAL (デフォルト) あるいは
INI_SCANNER_RAW。INI_SCANNER_RAW
を指定すると、オプションの値はパースされません。
PHP 5.6.1 以降では INI_SCANNER_TYPED も指定できるようになりました。
このモードでは、boolean や null そして integer の型を、可能な限り維持します。
文字列 "true"、"on" そして "yes"
は true に変換されます。"false"、"off"、"no"
そして "none" は false だとみなされます。このモードでは、"null" は null
に変換されます。また数値形式の文字列も、可能な限り integer 型に変換されます。
成功した場合に設定を連想配列形式で返します。
失敗した場合に false を返します。
注意: ini ファイル上でキーとして使ってはいけない単語があります。
null,yes,no,true,false,on,off,noneなどです。null,off,noおよびfalseは""となり、on,yesおよびtrueは"1"となります。 ただしINI_SCANNER_TYPEDモードを使っている場合は別です。 次の文字?{}|&~![()^"は、キーで使ってはいけません。 また、値の中で特別な意味を持ちます。