萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP ini_set() 與 ini_get() 完整指南:執行期配置修改、常用選項、陷阱與最佳實務

核心函數對照

函數用途回傳值影響範圍
ini_set(string $option, string $value)設定配置選項舊值 (字串),失敗回傳 false當前腳本執行期間
ini_get(string $option)取得配置選項值字串值,布林值回傳 "1"/"0"讀取當前生效值
ini_get_all(string $extension? = null)取得所有配置關聯陣列 ['global_value', 'local_value', 'access']完整配置快照
ini_restore(string $option)恢復原始值bool當前腳本

常用可修改選項 (PHP_INI_ALL / PHP_INI_PERDIR)

<?php
// 錯誤報告與顯示
ini_set('display_errors', '1');           // 開發環境開啟
ini_set('display_startup_errors', '1');
ini_set('error_reporting', E_ALL);        // 回報所有錯誤
ini_set('log_errors', '1');               // 記錄錯誤日誌
ini_set('error_log', '/var/log/php_errors.log'); // 指定日誌路徑

// 執行限制
ini_set('max_execution_time', '300');     // 最大執行秒數 (0=無限制)
ini_set('memory_limit', '256M');          // 記憶體上限
ini_set('max_input_time', '60');          // 輸入解析時間
ini_set('post_max_size', '50M');          // POST 資料上限
ini_set('upload_max_filesize', '50M');    // 上傳檔案上限

// Session 設定
ini_set('session.gc_maxlifetime', '7200'); // 生命週期 2小時
ini_set('session.cookie_httponly', '1');   // HttpOnly
ini_set('session.cookie_secure', '1');     // Secure (需 HTTPS)
ini_set('session.use_strict_mode', '1');   // 嚴格模式

// 日期時區 (必須在 date() 之前設定)
ini_set('date.timezone', 'Asia/Taipei');

// 檔案上傳
ini_set('file_uploads', '1');
ini_set('max_file_uploads', '20');

// 輸出緩衝
ini_set('output_buffering', '4096');       // 4KB 緩衝
ini_set('implicit_flush', '0');            // 關閉隱性刷新

// 開發除錯
ini_set('xdebug.mode', 'develop,debug');   // 若安裝 Xdebug
?>

不可修改選項 (PHP_INI_SYSTEM)

需修改 php.ini 並重啟 PHP-FPM/Apache:

  • extension= 擴充套件載入
  • zend_extension= (opcache, xdebug)
  • date.timezone (某些系統限制)
  • open_basedir
  • disable_functions
  • session.save_handler

實用封裝:Config 管理類

<?php
class PhpConfig {
    private static array $original = [];
    
    /** 設定選項並記錄原值 (可還原) */
    public static function set(string $option, string $value): bool {
        if (!array_key_exists($option, self::$original)) {
            self::$original[$option] = ini_get($option);
        }
        return ini_set($option, $value) !== false;
    }
    
    /** 取得選項值 (自動型別轉換) */
    public static function get(string $option): mixed {
        $val = ini_get($option);
        // 布林值轉換
        if (in_array(strtolower($val), ['on', 'true', 'yes', '1'])) return true;
        if (in_array(strtolower($val), ['off', 'false', 'no', '0', ''])) return false;
        // 數值轉換
        if (is_numeric($val)) return $val + 0;
        return $val;
    }
    
    /** 批次設定 */
    public static function setMultiple(array $options): void {
        foreach ($options as $k => $v) self::set($k, (string)$v);
    }
    
    /** 還原所有已修改選項 */
    public static function restoreAll(): void {
        foreach (self::$original as $opt => $val) {
            ini_restore($opt);
        }
        self::$original = [];
    }
    
    /** 檢查選項是否可在執行期修改 */
    public static function isChangeable(string $option): bool {
        return (ini_get_all()[$option]['access'] ?? 0) > 0; // PHP_INI_USER=1, PHP_INI_PERDIR=2, PHP_INI_SYSTEM=4
    }
}

// 使用
PhpConfig::setMultiple([
    'display_errors' => '1',
    'memory_limit' => '512M',
    'max_execution_time' => '0',
]);

// 程式結束時自動還原 (配合 register_shutdown_function)
register_shutdown_function([PhpConfig::class, 'restoreAll']);
?>

常見陷阱與避坑指南

  1. ini_set 位置:必須在相關功能使用之前呼叫。例如 `session_start()` 前設定 session 選項、`date()` 前設定 timezone。
  2. 單位陷阱:`memory_limit`、`post_max_size` 需帶單位 (K/M/G),`max_execution_time` 為秒 (整數字串)。
  3. 布林值回傳:`ini_get('display_errors')` 回傳 `"1"` 或 `"0"` 字串,非 boolean。
  4. .user.ini 優先級:PHP-FPM 模式下,目錄下的 `.user.ini` 會覆蓋 `ini_set()`,延遲生效 (預設 300 秒快取)。
  5. 共享主機限制:許多虛擬主機禁用 `ini_set()`,需透過面板或 `.user.ini` 設定。

除錯技巧

<?php
// 顯示所有與 memory 相關的設定
print_r(ini_get_all('memory'));

// 檢查特定選項存取層級
$all = ini_get_all();
echo "max_execution_time access: " . ($all['max_execution_time']['access'] ?? 'N/A') . "\n";
// 1=PHP_INI_USER, 2=PHP_INI_PERDIR, 4=PHP_INI_SYSTEM, 7=ALL

// 比較 php.ini vs 當前生效值
echo "php.ini value: " . $all['memory_limit']['global_value'] . "\n";
echo "Current value: " . $all['memory_limit']['local_value'] . "\n";
?>
copyright © 萬盛學電腦網 all rights reserved