【PHP8.x】ini_get_all関数の使い方

<?php

/**
 * PHPのすべてのINI設定を取得し、整形して表示します。
 *
 * ini_get_all関数を使用し、php.iniで定義されている設定の
 * マスター値、ローカル値、変更モードなどの詳細情報を取得します。
 */
function displayAllIniSettings(): void
{
    // ini_get_all関数を呼び出し、すべてのPHP設定を詳細情報付きで取得します。
    // 引数を省略すると、デフォルトで全ての拡張機能の設定が取得されます。
    $iniSettings = ini_get_all();

    // 設定の取得に失敗した場合の処理（メモリ不足など稀なケース）
    if ($iniSettings === false) {
        echo "エラー: ini_get_all関数で設定の取得に失敗しました。\n";
        return;
    }

    echo "--- PHPのすべてのINI設定の取得結果 ---\n";

    // 取得した設定は連想配列として返されます。
    // print_r を使うと、配列の構造と内容を人間が読みやすい形式で出力できます。
    print_r($iniSettings);

    echo "\n--- 特定の設定へのアクセス例 ---\n";
    // 例: 'display_errors' 設定の値にアクセスする方法
    // 各設定はさらに配列になっており、'global_value' (マスター値) や 'local_value' (現在の値) を持ちます。
    if (isset($iniSettings['display_errors'])) {
        echo "display_errors (マスター値): " . $iniSettings['display_errors']['global_value'] . "\n";
        echo "display_errors (ローカル値): " . $iniSettings['display_errors']['local_value'] . "\n";
    } else {
        echo "注: 'display_errors' 設定が見つかりませんでした。\n";
    }
}

// 関数を実行し、PHP設定を表示します。
displayAllIniSettings();

PHPのini_get_all関数は、php.iniファイルで定義されている設定や、実行時に変更された設定など、PHPに関するすべての設定情報を取得するために使用されます。この関数は、システムの現在の状態をプログラムから確認したり、デバッグを行う際に非常に役立ちます。

引数$extensionを省略するかnullを指定すると、すべてのPHP拡張機能の設定が対象となります。また、$details引数をtrue（デフォルト値）に設定すると、各設定のマスター値（php.iniで定義された初期値）、ローカル値（現在の実行環境で有効な値）、変更モードといった詳細情報も取得できます。戻り値は設定情報を格納した連想配列、または取得に失敗した場合はfalseを返します。

サンプルコードでは、引数なしでini_get_all()を呼び出し、PHPの全設定を詳細情報付きで取得しています。取得した設定情報は$iniSettings変数に連想配列として格納され、print_r関数によってその構造と内容が分かりやすく出力されます。例えば、display_errors設定のように、各設定はさらに配列となっており、global_value（マスター値）やlocal_value（現在の有効値）といったキーを通じてそれぞれの値にアクセスできます。設定の取得に失敗した場合は、エラーメッセージを表示して処理を終了します。この関数を使うことで、PHP環境の詳細な設定状況をプログラムから確認し、必要に応じて利用することが可能です。