php_ini_scanned_files

関数の概要

php_ini_scanned_files は、PHPが起動時に読み込んだ追加の php.ini 設定ファイルの一覧を文字列で取得するための組み込み関数です。通常、PHPはメインの php.ini ファイルのほかに特定のディレクトリ内の設定ファイルを複数読み込むことがあり、それらがどれか確認したい場合に便利です。

パラメータの説明

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

戻り値

読み込まれた追加の設定ファイルのパスをカンマ区切りの文字列として返します。もし追加の設定ファイルがなければ空の文字列を返します。

使用例

基本的な使い方

<?php
// PHPが読み込んだ追加のphp.iniファイル一覧を取得
$scannedFiles = php_ini_scanned_files();
echo "読み込まれた追加設定ファイル一覧: " . $scannedFiles;
?>

このコードは、追加で読み込まれている設定ファイルのパスを表示します。設定ファイルが無ければ空文字が表示されます。

存在しない場合の対処

<?php
$files = php_ini_scanned_files();

if ($files === '') {
    echo "追加のphp.iniファイルは読み込まれていません。";
} else {
    echo "読み込んだ設定ファイル: " . $files;
}
?>

追加設定ファイルが無い場合はメッセージを表示し、ある場合は一覧を表示します。

配列にして扱う例

<?php
$files = php_ini_scanned_files();

if ($files !== '') {
    $fileArray = explode(',', $files);
    foreach ($fileArray as $file) {
        echo "設定ファイル: " . trim($file) . "<br>";
    }
} else {
    echo "追加設定ファイルは読み込まれていません。";
}
?>

取得した文字列をカンマ区切りで分割し、1ファイルずつ表示する例です。複数の設定ファイルがある場合はこちらの使い方が実用的です。

関連する関数

  • php_ini_loaded_file() – 現在読み込まれているメインの php.ini ファイルのパスを返す関数
  • ini_get() – 指定した設定項目の現在の値を取得する関数
  • phpinfo() – PHPの設定内容や環境情報を表示する関数

まとめ

php_ini_scanned_files 関数は、PHPが追加で読み込んだ構成ファイルの一覧を簡単に取得できる関数です。環境設定の調査やトラブルシューティングの際に非常に役立ちます。パラメータ不要でシンプルに利用できるため、初心者から実務者まで活用しやすい関数です。メインの設定ファイルは php_ini_loaded_file() と組み合わせて確認すると、PHPの設定全体を把握しやすくなります。

スポンサーリンク