php_ini_scanned_files

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

php_ini_scanned_files — 追加の ini ディレクトリにある .ini ファイルのリストを取得する

説明

function php_ini_scanned_files(): string|false

php_ini_scanned_files()は、php.iniをパースした後で、設定ファイルのリストをカンマ区切りで返します。ファイルを探すディレクトリは、コンパイル時のオプションで指定します。また、実行時に環境変数で指定することもできます。詳細はインストールガイドを参照ください。

戻り値のファイル名は、フルパス形式となります。

パラメータ

この関数にはパラメータはありません。

戻り値

成功すると、.iniファイルをカンマ区切りにした文字列が返されます。 --with-config-file-scan-dir がセットされておらず、かつ環境変数 PHP_INI_SCAN_DIR も設定されていない場合は falseを返します。指定されたディレクトリが空であれば、空文字列が返されます。ファイルが認識できないものであれば、そのファイルは文字列には含まれますが同時にPHPがエラーを起こします。このエラーはコンパイルの時と、php_ini_scanned_files() 関数を使用したときの両方で発生します。

例

例1 返される ini ファイルを一覧する例

<?php
if ($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 ファイルのパスを取得する

関連キーワード:

files scanned filelist loaded カンマ区切りコンパイル環境変数 sapi パース実行時詳細ガイドフルパス成功 config scan セット認識同時両方 strlen explode foreach