PHP parse_ini_file()関数

PHP Filesystem ファンクション

定義と使用法

parse_ini_file()関数は設定ファイルを解析し、配列形式でその設定を返します。

文法

parse_ini_file(file,process_sections)
パラメータ 説明
file 必須です。チェックするiniファイルを指定します。
process_sections オプションです。trueに設定すると、設定ファイルの各セクションの名前と設定を含む多層配列を返します。デフォルトはfalseです。

説明

iniファイルの構造はphp.iniと似ています。

定数もiniファイルで解析できます。したがって、parse_ini_file()を実行する前に定数としてiniの値として定義された場合、結果に統合されます。評価されるのはiniの値のみです。

数字で構成されたキー名とセクション名はPHPで整数として処理されます。したがって、0で始まる数字は8進数として、0xで始まる数字は16進数として処理されます。

ヒントとコメント

注記：この関数は、あなたのアプリケーションの設定ファイルを読み込むために使用できます。この関数はphp.iniファイルとは関係がなく、スクリプトの実行中に既に処理されています。

注記：ini ファイルの値に非アルファベット数字の文字が含まれている場合、それをダブルクォート（"）で括ります。

注記：null、yes、no、true、false など、一部の保留語は ini ファイルのキー名として使用できません。null、no、false の値は "" に等しい、yes、true の値は "1" に等しいです。{}|"~![()" などの文字もキー名のどこにも使用できません。これらの文字はオプション値に特別な意味を持っています。

注記：PHP 5.0 版から、この関数はオプション値内の新しい行も処理します。

インスタンス

例 1

"test.ini" の内容：

[names]
me = Robert
you = Peter
[urls]
first = "http://www.example.com"
second = "http://www.codew3c.com"

PHP コード：

<?php
print_r(parse_ini_file("test.ini"));
?>

出力：

Array
(
[me] => Robert
[you] => Peter
[first] => http://www.example.com
[second] => http://www.codew3c.com
)

例 2

"test.ini" の内容：

[names]
me = Robert
you = Peter
[urls]
first = "http://www.example.com"
second = "http://www.codew3c.com"

PHP コード（process_sections 設定為 true）：

<?php
print_r(parse_ini_file("test.ini",true));
?>

出力：

Array
(
[names] => Array
  (
  [me] => Robert
  [you] => Peter
  )
[urls] => Array
  (
  [first] => http://www.example.com
  [second] => http://www.codew3c.com
  )
)

PHP Filesystem ファンクション