php_ini_scanned_files
(PHP 4 >= 4.3.0, PHP 5, PHP 7)
php_ini_scanned_files — 追加の ini ディレクトリにある .ini ファイルのリストを取得する
説明
php_ini_scanned_files ( ) : string
php_ini_scanned_files()は、php.ini
をパースした
後で、設定ファイルのリストをカンマ区切りで返します。
ファイルを探すディレクトリは、コンパイル時のオプションで指定します。
また、実行時に環境変数で指定することもできます。詳細は
インストールガイド
を参照ください。
戻り値のファイル名は、フルパス形式となります。
返り値
成功すると、.iniファイルをカンマ区切りにした文字列が返されます。
--with-config-file-scan-dir
がセットされておらず、かつ環境変数 PHP_INI_SCAN_DIR
も設定されていない場合は
false
を返します。指定されたディレクトリが空であれば、
空文字列が返されます。ファイルが認識できないものであれば、
そのファイルは文字列には含まれますが同時にPHPがエラーを起こします。
このエラーはコンパイルの時と、php_ini_scanned_files()
関数を使用したときの両方で発生します。
例
例1 返される ini ファイルを一覧する例
<?phpif ($filelist = php_ini_scanned_files()) { if (strlen($filelist) > 0) { $files = explode(',', $filelist); foreach ($files as $file) { echo "<li>" . trim($file) . "</li>\n"; } }}?>
参考
- ini_set() - 設定オプションの値を設定する
- phpinfo() - PHP の設定情報を出力する
- php_ini_loaded_file() - 読み込まれた php.ini ファイルのパスを取得する