PHP INI 配置四大核心函數實戰指南：ini_get、ini_set、ini_get_all、ini_restore

核心價值：運行時動態控制 PHP 行為

PHP 的 ini_* 函數族提供了「無需重啟 PHP-FPM/Apache，即時讀寫配置」的能力。這在共享主機、無權限修改 php.ini、根據環境動態調整策略（如調試模式、上傳限制、錯誤報告）的場景極具價值。

一、ini_get()：讀取配置值

語法與返回值規則

ini_get(string $option): string|false

• 布爾值：On/True/Yes → "1"；Off/False/No → ""（空字符串）
• 數值/字符串：返回原始字符串（如 "8M"、"30"）
• 不存在的選項：返回 false

實戰場景：兼容魔術引號的輸入過濾

function safeInput(string $str): string {
    // 檢查 magic_quotes_gpc 是否開啟（PHP 5.4+ 已移除，但舊項目可能仍需兼容）
    if (ini_get('magic_quotes_gpc') === '1') {
        return $str; // 已自動轉義
    }
    return addslashes($str); // 手動轉義
}

二、ini_set()：運行時修改配置

語法與作用域

ini_set(string $option, string $value): string|false

• 僅影響當前腳本執行周期，腳本結束自動恢復
• 並非所有選項可修改（參見 官方列表，標記 PHP_INI_USER 或 PHP_INI_ALL 可修改）
• 返回舊值，失敗返回 false

高頻實戰用例

三、ini_get_all()：獲取所有配置快照

返回結構

[
    'option_name' => [
        'global_value' => 'php.ini 中的值',
        'local_value'  => '當前生效值（可能被 ini_set 修改）',
        'access'       => 7  // 位掩碼：1=PHP_INI_USER, 2=PHP_INI_PERDIR, 4=PHP_INI_SYSTEM
    ],
    ...
]

實戰：生成配置審計報告

function auditIniSecurity(): array {
    $all = ini_get_all();
    $risky = [
        'allow_url_fopen' => 'Off',
        'allow_url_include' => 'Off',
        'expose_php' => 'Off',
        'register_globals' => 'Off',
        'display_errors' => 'Off',
        'log_errors' => 'On',
        'open_basedir' => '非空',
        'disable_functions' => '包含 exec,system 等',
    ];
    $report = [];
    foreach ($risky as $opt => $expected) {
        $cur = $all[$opt]['local_value'] ?? '未設置';
        $report[$opt] = [
            'expected' => $expected,
            'current'  => $cur,
            'status'   => checkCompliance($opt, $cur, $expected) ? 'PASS' : 'FAIL'
        ];
    }
    return $report;
}

四、ini_restore()：恢復配置原值

ini_restore(string $option): void

將指定選項恢復為 php.ini 定義的值（或啟動時的值）。常用於「臨時修改 → 執行敏感操作 → 恢復」模式：

// 臨時開啟錯誤顯示調試特定邏輯
ini_set('display_errors', '1');
try {
    riskyOperation();
} finally {
    ini_restore('display_errors'); // 確保恢復，防止影響後續邏輯
}

五、最佳實踐總結

1. 讀多寫少：優先用 ini_get 適配環境，謹慎用 ini_set 改變全局行為。
2. 配合常量封裝：定義 INI_DISPLAY_ERRORS = 'display_errors' 避免魔術字符串。
3. 文檔化運行時修改：每處 ini_set 必須註明業務原因、影響範圍、恢復邏輯。
4. 測試環境驗證：CI 流程中跑配置審計腳本，確保生產環境基線合規。