［PHP］ini_get_all関数とは？設定値を一括取得する方法を詳しく解説

PHP

PHPアプリケーションを開発していると、「現在のPHP設定がどうなっているか確認したい」「本番環境と開発環境の設定の違いを調べたい」といった場面に遭遇することがあります。そんな時に活躍するのがini_get_all()関数です。

この記事では、ini_get_all()関数の使い方から実践的な活用方法まで、初心者にもわかりやすく解説していきます。

ini_get_all関数とは

ini_get_all()は、PHPの設定ディレクティブ（php.iniで設定される項目）を一括で取得できる関数です。個別の設定値を取得するini_get()関数の拡張版として位置づけられます。

基本的な構文

ini_get_all(?string $extension = null, bool $details = true): array|false

パラメータ：

  • $extension：特定の拡張モジュールの設定のみを取得したい場合に指定（オプション）
  • $details：詳細情報を含めるかどうか（デフォルト：true）

戻り値：

  • 成功時：設定情報の配列
  • 失敗時：false

基本的な使い方

最もシンプルな使い方から見ていきましょう。

全ての設定を取得

<?php
$all_settings = ini_get_all();
var_dump($all_settings);
?>

この実行結果は膨大な量になるため、実際の開発では目的に応じて絞り込んで使用します。

特定の拡張モジュールの設定のみ取得

<?php
// MySQLの設定のみを取得
$mysql_settings = ini_get_all('mysql');
print_r($mysql_settings);

// cURLの設定のみを取得
$curl_settings = ini_get_all('curl');
print_r($curl_settings);
?>

簡単な形式で取得

<?php
// 詳細情報を省略して値のみ取得
$simple_settings = ini_get_all(null, false);
print_r($simple_settings);
?>

戻り値の構造を理解する

ini_get_all()の戻り値は、設定項目名をキーとした連想配列です。$detailsパラメータの値によって構造が変わります。

詳細情報あり（$details = true）の場合

<?php
$settings = ini_get_all('session');
/*
出力例：
Array
(
    [session.save_handler] => Array
        (
            [global_value] => files
            [local_value] => files
            [access] => 7
        )
    [session.save_path] => Array
        (
            [global_value] => 
            [local_value] => 
            [access] => 7
        )
    // ...
)
*/
?>

各設定項目には以下の情報が含まれます：

  • global_value：php.iniで設定されたグローバル値
  • local_value：実行時に変更された現在の値
  • access：設定変更可能なレベル（数値）

簡単形式（$details = false）の場合

<?php
$settings = ini_get_all('session', false);
/*
出力例：
Array
(
    [session.save_handler] => files
    [session.save_path] => 
    [session.name] => PHPSESSID
    // ...
)
*/
?>

この場合は、設定名と現在の値のみのシンプルな連想配列になります。

実践的な活用例

1. デバッグ情報の表示

開発時に現在のPHP設定を確認するためのデバッグ関数を作成してみましょう。

<?php
function showPhpConfig($extension = null) {
    $settings = ini_get_all($extension);
    
    if ($settings === false) {
        echo "設定の取得に失敗しました。\n";
        return;
    }
    
    echo "<h2>PHP設定情報</h2>\n";
    echo "<table border='1'>\n";
    echo "<tr><th>設定項目</th><th>グローバル値</th><th>ローカル値</th></tr>\n";
    
    foreach ($settings as $key => $value) {
        $global = htmlspecialchars($value['global_value'] ?? '');
        $local = htmlspecialchars($value['local_value'] ?? '');
        
        echo "<tr>";
        echo "<td>{$key}</td>";
        echo "<td>{$global}</td>";
        echo "<td>{$local}</td>";
        echo "</tr>\n";
    }
    
    echo "</table>\n";
}

// 使用例
showPhpConfig('mysqli'); // MySQL関連の設定のみ表示
?>

2. 設定値の比較チェック

本番環境と開発環境で設定が異なっていないかチェックする関数です。

<?php
function compareSettings($expectedSettings) {
    $currentSettings = ini_get_all(null, false);
    $differences = [];
    
    foreach ($expectedSettings as $key => $expectedValue) {
        $currentValue = $currentSettings[$key] ?? null;
        
        if ($currentValue !== $expectedValue) {
            $differences[$key] = [
                'expected' => $expectedValue,
                'actual' => $currentValue
            ];
        }
    }
    
    return $differences;
}

// 使用例
$expected = [
    'display_errors' => '0',
    'log_errors' => '1',
    'max_execution_time' => '30'
];

$diff = compareSettings($expected);
if (!empty($diff)) {
    echo "設定の違いが見つかりました：\n";
    print_r($diff);
}
?>

3. セキュリティ設定のチェック

セキュリティに関する重要な設定が適切に行われているかチェックする関数です。

<?php
function checkSecuritySettings() {
    $settings = ini_get_all(null, false);
    $securityChecks = [
        'display_errors' => ['recommended' => '0', 'reason' => 'エラー情報の漏洩防止'],
        'expose_php' => ['recommended' => '0', 'reason' => 'PHPバージョン情報の隠蔽'],
        'allow_url_fopen' => ['recommended' => '0', 'reason' => 'リモートファイル読み込みの無効化'],
        'session.cookie_httponly' => ['recommended' => '1', 'reason' => 'XSS攻撃の防止']
    ];
    
    echo "<h2>セキュリティ設定チェック</h2>\n";
    
    foreach ($securityChecks as $setting => $check) {
        $currentValue = $settings[$setting] ?? 'undefined';
        $status = ($currentValue === $check['recommended']) ? '✅ OK' : '⚠️ 要確認';
        
        echo "<p><strong>{$setting}</strong>: {$currentValue} {$status}<br>";
        echo "推奨値: {$check['recommended']} ({$check['reason']})</p>\n";
    }
}

checkSecuritySettings();
?>

注意点とベストプラクティス

パフォーマンスへの配慮

ini_get_all()は全設定を取得するため、必要以上に頻繁に実行するとパフォーマンスに影響する可能性があります。

<?php
// 良い例：結果をキャッシュする
class ConfigChecker {
    private static $cache = null;
    
    public static function getAllSettings() {
        if (self::$cache === null) {
            self::$cache = ini_get_all();
        }
        return self::$cache;
    }
}
?>

エラーハンドリング

関数が失敗する可能性を考慮してエラーハンドリングを行いましょう。

<?php
function safeGetAllIni($extension = null) {
    $settings = ini_get_all($extension);
    
    if ($settings === false) {
        throw new RuntimeException("ini_get_all() failed for extension: " . ($extension ?? 'all'));
    }
    
    return $settings;
}

try {
    $settings = safeGetAllIni('nonexistent_extension');
} catch (RuntimeException $e) {
    echo "エラー: " . $e->getMessage();
}
?>

本番環境での使用

本番環境では、デバッグ情報の表示は避け、ログファイルへの出力を検討しましょう。

<?php
function logPhpConfig($logFile = 'php_config.log') {
    $settings = ini_get_all(null, false);
    $logData = [
        'timestamp' => date('Y-m-d H:i:s'),
        'settings' => $settings
    ];
    
    file_put_contents($logFile, json_encode($logData) . PHP_EOL, FILE_APPEND);
}
?>

まとめ

ini_get_all()関数は、PHPの設定値を包括的に取得できる強力なツールです。開発時のデバッグ、環境間の設定比較、セキュリティチェックなど、様々な場面で活用できます。

適切に使用することで、より安全で保守性の高いPHPアプリケーションの開発に役立てることができるでしょう。パフォーマンスとセキュリティに配慮しながら、効果的に活用してください。

この関数を使いこなして、PHP開発をより効率的に進めていきましょう！

タイトルとURLをコピーしました