【PHP8.x】php_ini_loaded_file()関数の使い方

Copy
1<?php
2
3/**
4 * 現在ロードされているPHP設定ファイル (php.ini) のパスを表示します。
5 *
6 * この関数は、PHPがどの設定ファイルを使用しているかを確認する際に役立ちます。
7 * システムエンジニアを目指す初心者にとって、PHPの動作を理解し、
8 * デバッグを行うための第一歩となります。
9 *
10 * PHPの「全ての」設定（キーワード「php_ini_all」が示唆する内容）を
11 * 調査する際、まずどの設定ファイルがロードされているかを知ることが重要です。
12 */
13function displayLoadedPhpIniFile(): void
14{
15    // php_ini_loaded_file() は、ロードされた php.ini ファイルのパスを文字列で返します。
16    // もし php.ini ファイルがロードされていない場合、false を返します。
17    $iniFilePath = php_ini_loaded_file();
18
19    if ($iniFilePath !== false) {
20        // php.ini ファイルが見つかった場合、そのパスを出力します。
21        echo "現在ロードされている php.ini ファイル: " . $iniFilePath . PHP_EOL;
22    } else {
23        // php.ini ファイルが見つからなかった場合。
24        // これはPHPがデフォルト設定を使用しているか、
25        // コマンドライン引数などで直接設定されていることを意味します。
26        echo "php.ini ファイルはロードされていません。" . PHP_EOL;
27        echo "PHPはデフォルト設定、または別の方法で設定されています。" . PHP_EOL;
28    }
29
30    // 参考: PHPの全ての設定値を確認したい場合は、phpinfo() 関数や ini_get_all() 関数が利用できます。
31    // 例: var_dump(ini_get_all()); // 全ての設定を配列で取得
32    // 例: phpinfo(); // 詳細な情報をHTML形式で表示 (本番環境での使用はセキュリティに注意)
33}
34
35// 関数を実行して結果を表示します。
36displayLoadedPhpIniFile();
37

php_ini_loaded_file関数は、現在PHPにロードされている設定ファイル（php.ini）の正確なパスを教えてくれる関数です。システムエンジニアを目指す初心者の方にとって、PHPがどの設定ファイルを使って動作しているかを把握することは、PHPアプリケーションの動作を理解し、設定に関する問題を解決する上で非常に重要な第一歩となります。

この関数は引数を取らず、PHPが使用しているphp.iniファイルのパスを文字列として返します。もしphp.iniファイルがロードされていない場合は、falseを返します。PHPの全ての設定（php_ini_allというキーワードが示唆するように）を詳細に調査する前に、まずどの設定ファイルが読み込まれているかを確認することが、問題の切り分けや適切な設定変更を行う上で不可欠です。

サンプルコードでは、php_ini_loaded_file()の戻り値を$iniFilePath変数に格納しています。$iniFilePathがfalseでない場合（つまり、php.iniファイルがロードされている場合）は、そのパスを表示します。falseが返された場合（php.iniファイルが見つからなかった場合）は、PHPがデフォルト設定や別の方法で設定されていることをユーザーに伝えます。このように、設定ファイルの場所を知ることで、PHP環境の管理がより容易になります。

Copy
1<?php
2
3/**
4 * PHPがロードしているphp.iniファイルのパスを確認し、表示します。
5 * php.iniファイルがロードされていない場合は、その旨を通知します。
6 */
7function checkLoadedIniFile(): void
8{
9    // php_ini_loaded_file() 関数は、PHP がロードした設定ファイル (php.ini) のパスを取得します。
10    // もし php.ini がロードされていない場合、この関数は false を返します。
11    $iniFile = php_ini_loaded_file();
12
13    if ($iniFile !== false) {
14        // php.ini ファイルが正常にロードされている場合、そのパスを表示します。
15        echo "ロードされた php.ini ファイル: " . $iniFile . PHP_EOL;
16    } else {
17        // php.ini ファイルがロードされていない場合、その旨を通知します。
18        // これは、PHPがデフォルト設定を使用しているか、INIファイルが明示的に指定されていない場合に発生します。
19        echo "php.ini ファイルはロードされていません。" . PHP_EOL;
20    }
21}
22
23// 関数を呼び出して実行します。
24checkLoadedIniFile();
25
26?>

php_ini_loaded_file関数は、PHPが現在ロードしているphp.ini設定ファイルのパスを確認するために使用されます。システムエンジニアを目指す初心者の方にとって、PHPの動作環境がどの設定ファイルに基づいているかを把握する上で非常に重要な情報です。

この関数は引数を一切必要とせず、php_ini_loaded_file()と呼び出すだけで利用できます。戻り値は二つのパターンがあります。一つは、php.iniファイルが正常にロードされている場合で、このとき関数はそのファイルの完全なパスを文字列（string）として返します。もう一つは、php.iniファイルがロードされていない場合で、この場合はブール値のfalseを返します。例えば、PHPがデフォルト設定を使用している場合などがこれに該当します。

サンプルコードでは、この戻り値を利用して処理を分岐させています。もし関数がfalse以外の値（すなわちファイルのパス）を返した場合は、そのパスを画面に表示します。一方で、falseが返された場合は、「php.ini ファイルはロードされていません」というメッセージを表示し、現在の状況を分かりやすく伝えています。これにより、PHPの設定が意図通りに適用されているか、あるいはどの設定が使われているのかを簡単に確認することができます。