| 函數 | 用途 | 回傳值 | 影響範圍 |
|---|---|---|---|
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_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 並重啟 PHP-FPM/Apache:
extension= 擴充套件載入zend_extension= (opcache, xdebug)date.timezone (某些系統限制)open_basedirdisable_functionssession.save_handler<?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']);
?>
.user.ini 優先級:PHP-FPM 模式下,目錄下的 `.user.ini` 會覆蓋 `ini_set()`,延遲生效 (預設 300 秒快取)。<?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";
?>