萬盛學電腦網

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

PHP ini_set 運行時配置修改完全指南

函數原型

string ini_set(string $varname, string $newvalue)

運行時修改 `php.ini` 配置,僅影響**當前腳本執行期間**,腳本結束自動恢復。無需修改 `php.ini` 文件,虛擬主機/共享環境極其實用。

常用配置項速查表

配置項說明推薦值/示例注意
memory_limit腳本最大可用內存256M / 512M / -1(無限制)慎用 -1,防止失控腳本耗盡內存
display_errors是否直接輸出錯誤到瀏覽器開發: 1 / 生產: 0生產環境必須關閉,配合 log_errors
error_reporting錯誤報告級別E_ALL & ~E_NOTICE & ~E_DEPRECATED開發建議 E_ALL
log_errors是否記錄錯誤到日誌1生產環境必開
error_log錯誤日誌文件路徑/var/log/php_errors.log需寫入權限
max_execution_time腳本最大執行秒數30 / 60 / 300 / 0(無限制)CLI 模式默認 0
post_max_sizePOST 數據最大體積8M / 20M / 100M需配合 upload_max_filesize
upload_max_filesize上傳文件最大體積2M / 10M / 50M≤ post_max_size
session.auto_start請求開始自動啟動 Session0 (關閉)開啟會阻礙手動控制
session.gc_maxlifetimeSession 服務端存活秒數1440 (24分鐘)配合 cookie_lifetime
session.cookie_httponlyCookie 僅 HTTP 可訪問(防 XSS)1PHP 5.2+
session.cookie_secureCookie 僅 HTTPS 傳輸1 (需 HTTPS)PHP 5.2+
session.use_strict_mode拒絕未初始化的 Session ID1PHP 5.5+ 防 Session Fixation
default_charset默認字符編碼UTF-8PHP 5.6+ 默認即為 UTF-8

使用示例

<?php
// 開發環境調試
ini_set('display_errors', 1);
ini_set('error_reporting', E_ALL);

// 生產環境錯誤處理
ini_set('display_errors', 0);
ini_set('log_errors', 1);
ini_set('error_log', __DIR__ . '/logs/php_errors.log');

// 大數據導出/導入
ini_set('memory_limit', '512M');
ini_set('max_execution_time', 300); // 5分鐘

// 文件上傳
ini_set('post_max_size', '50M');
ini_set('upload_max_filesize', '40M');

// Session 安全
ini_set('session.cookie_httponly', 1);
ini_set('session.cookie_secure', 1); // 僅 HTTPS
ini_set('session.use_strict_mode', 1);
ini_set('session.gc_maxlifetime', 1800); // 30分鐘

// 禁用危險函數(需 php.ini 中 disable_functions,ini_set 無效)
// ini_set('disable_functions', 'exec,passthru,shell_exec,system'); // 無效!
?>

不可用 ini_set 修改的配置(PHP_INI_SYSTEM/PHP_INI_PERDIR)

  • `disable_functions` / `disable_classes`
  • `extension` / `zend_extension`
  • `open_basedir`
  • `session.save_handler` / `session.save_path`(部分環境可用)
  • `date.timezone`(建議在代碼用 `date_default_timezone_set()`)

查看完整列表:PHP 官方 ini 列表(關注 "Changeable" 欄)。

獲取當前值

echo ini_get('memory_limit'); // 返回字符串 "128M"
echo ini_get('display_errors'); // "1" 或 "0"

最佳實踐

  1. **集中管理**:在入口文件/公共配置文件統一設置,避免分散難維護。
  2. **環境區分**:配置文件按環境(dev/test/prod)加載不同值。
  3. **安全優先**:生產環境強制關閉 `display_errors`,開啟 `log_errors`。
  4. **測試驗證**:修改後用 `ini_get()` 確認生效,並編寫測試用例覆蓋關鍵配置。
copyright © 萬盛學電腦網 all rights reserved