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

<?php

// このスクリプトは、PHPの parse_ini_file 関数を使ってINIファイルを読み込む方法を示します。
// INIファイルは、設定情報をキーと値のペアで保存するテキストファイルです。

// 1. サンプルとなるINIファイルの内容を定義します。
//    [セクション名] を使うことで、設定をグループ化できます。
$iniContent = <<<INI
; これはINIファイル内のコメントです。セミコロン(;)でコメントを開始します。

[database]
host = "localhost"
user = "root"
password = "mysecretpassword"
port = 3306 ; 数値は自動的にPHPの数値型に変換されます
enabled = true ; 'true', 'false', 'on', 'off', 'yes', 'no' は真偽値に変換されます

[api]
key = "abcdef12345"
endpoint = "https://api.example.com/v1"
timeout_seconds = 10
INI;

// 2. 定義したINIファイルの内容を一時ファイルに書き込みます。
//    parse_ini_file 関数が実際に読み込めるファイルを用意するためです。
$tempIniFile = tempnam(sys_get_temp_dir(), 'php_ini_example_'); // 一時ファイル名を作成

if ($tempIniFile === false) {
    echo "エラー: 一時ファイルの作成に失敗しました。\n";
    exit(1);
}

if (file_put_contents($tempIniFile, $iniContent) === false) {
    unlink($tempIniFile); // 失敗した場合でも一時ファイルを削除
    echo "エラー: INIファイルの書き込みに失敗しました: " . $tempIniFile . "\n";
    exit(1);
}

echo "一時INIファイルが作成されました: " . $tempIniFile . "\n\n";

// --- parse_ini_file 関数の使用例 ---

// parse_ini_file 関数は、INIファイルを解析し、その設定を配列として返します。
// 引数:
//   $filename           : 読み込むINIファイルのパス。
//   $process_sections   : trueの場合、セクション名も処理し、多次元配列で返します。
//                         false (デフォルト) の場合、セクションを無視し、フラットな配列で返します。
//   $scanner_mode       : 解析モード。INI_SCANNER_NORMAL (デフォルト) や INI_SCANNER_TYPED などがあります。
//                         INI_SCANNER_TYPED は文字列ではない値 (true/false, 数値など) を適切なPHPの型に変換します。

// 例1: セクションを処理しない場合 (process_sections = false)
//      すべての設定が単一の配列としてフラットに返されます。
//      異なるセクションに同じキーがある場合、最後の値が優先されます。
echo "--- セクションを処理しない場合 (process_sections = false) ---\n";
$configNoSections = parse_ini_file($tempIniFile, false, INI_SCANNER_TYPED);

if ($configNoSections === false) {
    echo "エラー: INIファイルの解析に失敗しました (セクションなし)。\n";
} else {
    echo "解析結果:\n";
    print_r($configNoSections);
    echo "database.host の値: " . ($configNoSections['host'] ?? 'N/A') . "\n";
    echo "api.key の値: " . ($configNoSections['key'] ?? 'N/A') . "\n";
    echo "database.port の型: " . gettype($configNoSections['port']) . "\n"; // INI_SCANNER_TYPEDにより整数型
}
echo "\n";

// 例2: セクションを処理する場合 (process_sections = true)
//      セクション名がキーとなる多次元配列として返されます。
echo "--- セクションを処理する場合 (process_sections = true) ---\n";
$configWithSections = parse_ini_file($tempIniFile, true, INI_SCANNER_TYPED);

if ($configWithSections === false) {
    echo "エラー: INIファイルの解析に失敗しました (セクションあり)。\n";
} else {
    echo "解析結果:\n";
    print_r($configWithSections);

    // 特定のセクションや値へのアクセス例
    echo "\n[database] セクションから 'host' を取得: " . ($configWithSections['database']['host'] ?? 'N/A') . "\n";
    echo "[api] セクションから 'key' を取得: " . ($configWithSections['api']['key'] ?? 'N/A') . "\n";
    echo "[database] セクションから 'port' を取得: " . ($configWithSections['database']['port'] ?? 'N/A') . "\n";
    echo "database.port の型: " . gettype($configWithSections['database']['port']) . "\n"; // INI_SCANNER_TYPEDにより整数型
}
echo "\n";


// 4. 使用済みの一時ファイルを削除します。
//    これにより、スクリプト実行後に不要なファイルが残りません。
if (unlink($tempIniFile)) {
    echo "一時INIファイルが削除されました: " . $tempIniFile . "\n";
} else {
    echo "一時INIファイルの削除に失敗しました: " . $tempIniFile . "\n";
}

?>

PHPのparse_ini_file関数は、INI形式の設定ファイルを読み込み、その内容をPHPの配列として解析する際に使用されます。INIファイルは、キーと値のペアで設定情報を保存するテキストファイルで、プログラムの設定管理によく用いられます。

この関数は、最初の引数$filenameに指定されたINIファイルのパスを解析します。2番目の引数$process_sectionsは、INIファイル内のセクション（[database]のような見出し）をどのように扱うかを制御します。false（デフォルト）を設定するとセクションを無視して設定をフラットな一次元配列として返し、trueを設定するとセクション名がキーとなる多次元配列として設定をグループ化して返します。

3番目の引数$scanner_modeには、解析モードを指定します。INI_SCANNER_TYPEDを指定すると、INIファイル内のtrue/falseや数値などの値を、PHPの適切な型（真偽値、整数など）に自動的に変換してくれます。

関数がINIファイルの解析に成功した場合、設定情報を格納した配列を返します。しかし、ファイルが見つからないなどのエラーが発生した場合は、falseを返しますので、戻り値の確認は重要です。この関数を利用することで、外部の設定ファイルをPHPスクリプトで簡単に扱えるようになります。

<?php

/**
 * INIファイルをパースし、セクションを含む多次元配列として取得するサンプルコード。
 *
 * `parse_ini_file` 関数の第2引数に `true` を指定することで、
 * INIファイルのセクションをトップレベルのキーとする多次元配列を生成します。
 */
function parseIniFileMultidimensionalExample(): void
{
    // 一時的なINIファイル名
    $iniFilename = 'config.ini';

    // INIファイルの内容を定義。
    // [database] や [api_settings] のようなセクションが多次元配列のトップレベルのキーになります。
    $iniContent = <<<INI
; アプリケーションの設定例

[database]
host = localhost
port = 3306
username = root
password = secure_password123

[api_settings]
base_url = https://api.example.com/v1
api_key = abcdef123456
timeout_seconds = 30
INI;

    // 単体で動作可能なサンプルとするため、INIファイルをスクリプト実行時に生成します。
    if (file_put_contents($iniFilename, $iniContent) === false) {
        echo "エラー: INIファイルの書き込みに失敗しました。\n";
        return;
    }

    echo "INIファイル '{$iniFilename}' を作成しました。\n\n";

    // `parse_ini_file` 関数を使用してINIファイルをパースします。
    // 第2引数に `true` を指定することで、セクション名がトップレベルのキーとなる
    // 多次元配列として結果を返します。これが `multidimensional array` の実現方法です。
    $config = parse_ini_file($iniFilename, true);

    // パースが成功したかを確認します。失敗した場合は `false` が返されます。
    if ($config === false) {
        echo "エラー: INIファイルのパースに失敗しました。\n";
    } else {
        echo "INIファイルの内容を多次元配列としてパースしました:\n";
        // 結果の配列を読みやすい形式で出力します。
        print_r($config);

        // パースされた多次元配列から特定の設定値へアクセスする例です。
        echo "\n--- 特定の設定値へのアクセス例 ---\n";
        echo "データベースホスト: " . ($config['database']['host'] ?? '未設定') . "\n";
        echo "APIベースURL: " . ($config['api_settings']['base_url'] ?? '未設定') . "\n";
        echo "APIタイムアウト: " . ($config['api_settings']['timeout_seconds'] ?? '未設定') . "秒\n";
    }

    // サンプルの実行後、作成したINIファイルを削除します。
    // 必要に応じてこの行をコメントアウトして、生成されたファイルを確認できます。
    if (file_exists($iniFilename)) {
        unlink($iniFilename);
        echo "\nINIファイル '{$iniFilename}' を削除しました。\n";
    }
}

// 関数を実行します。
parseIniFileMultidimensionalExample();

PHPのparse_ini_file関数は、設定情報を記述するINI形式のファイルをPHPの配列に変換するために利用されます。INIファイルは[セクション名]とキー=値の形式で構成されるシンプルなテキストファイルで、アプリケーションの設定管理によく用いられます。

この関数は、第1引数にINIファイルのパスを受け取ります。最も重要な点として、第2引数にtrueを指定することで、INIファイル内の[セクション名]をトップレベルのキーとする**多次元配列（multidimensional array）**として設定情報を取得できます。例えば、[database]セクション内のhost=localhostという設定は、PHPの配列では['database']['host']としてアクセス可能になります。この機能は、設定を論理的なグループに分けて管理する際に大変便利です。

処理が成功した場合、パースされたINIファイルの内容が連想配列として返されます。もしファイルが見つからない、またはパースに失敗した場合はfalseが戻り値となるため、エラーハンドリングのために戻り値を確認することが推奨されます。

サンプルコードでは、一時的にconfig.iniファイルを作成し、parse_ini_fileに第2引数としてtrueを渡して実行しています。これにより、[database]や[api_settings]といったINIファイルのセクションが、PHPの配列のキーとなり、それぞれのセクション内の設定がさらにその下の階層の配列に格納される多次元配列として出力される様子が示されています。これにより、$config['database']['host']のように簡潔な記述で特定の設定値にアクセスできることを確認できます。