php.ini 是 PHP 引擎核心設定檔。本文依官方文檔結構,整理核心指令分類說明,附常見誤區與最佳實踐。
php.ini,放置於 PHPIniDir(Apache)或 PHP 安裝目錄。directive = value,指令名大小寫敏感。| & ~、邏輯非 !)。On/Off、1/0、true/false、yes/no。foo = 或 foo = none。| 指令 | 預設 | 說明 |
|---|---|---|
engine | On | 啟用 PHP 解析引擎,可在 httpd.conf 目錄/虛擬主機覆蓋 |
last_modified | Off | 回應標頭加入腳本最後修改時間 |
xbithack | Off | 忽略副檔名,以執行位元判斷是否解析 |
child_terminate | Off | 允許 apache_child_terminate() 結束子進程(僅 Apache 1.3 UNIX) |
date.timezone:必設,中國大陸用 PRC 或 Asia/Shanghai。優先序:date_default_timezone_set() > TZ 環境變數 > 此指令 > PHP 推測 > UTC。date.default_latitude/longitude、date.sunrise_zenith/sunset_zenith:供 date_sunrise()/date_sunset() 使用。assert.active=On、assert.bail=Off(失敗是否終止)、assert.warning=On、assert.callback(自訂回調)。已棄用,改用 open_basedir、disable_functions、權限隔離。僅供舊專案維護參考:
safe_mode=Off、safe_mode_gid=Off(改用 GID 檢查)safe_mode_allowed_env_vars=PHP_、safe_mode_protected_env_vars=LD_LIBRARY_PATHsafe_mode_exec_dir:系統函數允許執行的目錄safe_mode_include_dir:包含檔案跳過 UID/GID 檢查的目錄| 指令 | 預設 | 建議生產值 | 說明 |
|---|---|---|---|
error_reporting | E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED | E_ALL & ~E_DEPRECATED & ~E_STRICT | 開發建議 E_ALL,生產記錄日誌不顯示 |
display_errors | On | Off | 生產必關,配合 log_errors |
log_errors | Off | On | 錯誤寫入日誌 |
error_log | 空 | /var/log/php/error.log | 指定日誌路徑,需寫入權限 |
memory_limit | 128M | 256M/512M | 單腳本記憶體上限 |
max_execution_time | 30 | 30-300 | 秒,0=無限制(CLI 預設 0) |
post_max_size | 8M | 50M+ | POST 總資料上限,需 > upload_max_filesize |
upload_max_filesize | 2M | 50M+ | 單檔上傳上限 |
max_file_uploads | 20 | 20-100 | 單次上傳檔案數上限 |
open_basedir | 空 | /var/www/:/tmp/ | 限制 PHP 可存取路徑,加強安全 |
disable_functions | 空 | exec,passthru,shell_exec,system,proc_open,popen,curl_exec,curl_multi_exec,parse_ini_file,show_source | 禁用危險函數 |
session.save_handler | files | redis/memcached | 分散式 Session 儲存 |
session.gc_maxlifetime | 1440 | 7200+ | Session 生命週期(秒) |
opcache.enable | On | On | 生產必開啟 OPcache |
opcache.memory_consumption | 128 | 256-512 | OPcache 共享記憶體(MB) |
realpath_cache_size | 4M | 4M-16M | 路徑快取,大型專案需調大 |
php_value name value # 非布林指令,value=none 清除設定
php_flag name on|off # 僅布林指令
PHP 常數(如 E_ALL)不可在 httpd.conf 使用,需用對應數值(如 32767)。