PHP 設定檔 php.ini 中文註釋完整版

前言

php.ini 控制 PHP 眾多行為。本文提供詳細的中文註釋，協助開發者快速理解各項設定，解決常見錯誤。

檔案載入順序

1. 目前工作目錄
2. 環境變數 PHPRC 指定路徑
3. 編譯時指定路徑 (Windows 為安裝目錄)
4. CLI 模式可用 -c 參數覆蓋

語法規則

• 空白行與 ; 開頭的行會被忽略
• 區段標題 (如 [Foo]) 目前被忽略
• 指令格式：指令 = 值，指令名稱大小寫敏感
• 值可為字串、數字、PHP 常數、INI 常數 (On/Off/True/False/Yes/No/None)、運算式 (位元運算)、帶引號字串
• 布林值：1, On, True, Yes 為開啟；0, Off, False, No 為關閉
• 空字串：foo = 或 foo = none；foo = "none" 為字串 "none"

主要設定區塊節錄

語言選項

engine = On                  ; 啟用 PHP 引擎
short_open_tag = On          ; 允許 <? 簡短標籤
asp_tags = Off               ; 允許 ASP 風格 <% %>
precision = 14               ; 浮點數顯示精度
y2k_compliance = Off         ; 年 2000 相容性
output_buffering = Off       ; 輸出緩衝
implicit_flush = Off         ; 強制每次輸出後 flush
allow_call_time_pass_reference = On ; 允許呼叫時傳址 (已棄用)

安全模式

safe_mode = Off
safe_mode_exec_dir =
safe_mode_allowed_env_vars = PHP_
safe_mode_protected_env_vars = LD_LIBRARY_PATH
disable_functions =          ; 禁用特定函數，不受 safe_mode 影響

語法高亮顏色

highlight.string = #DD0000
highlight.comment = #FF8000
highlight.keyword = #007700
highlight.bg = #FFFFFF
highlight.default = #0000BB
highlight.html = #000000

雜項

expose_php = Off             ; 隱藏 PHP 版本資訊 (Header X-Powered-By)

資源限制

max_execution_time = 30      ; 腳本最大執行秒數
memory_limit = 8388608       ; 腳本最大記憶體 (8MB)

錯誤處理與記錄

error_reporting = E_ALL & ~E_NOTICE ; 顯示所有錯誤除提醒
display_errors = On          ; 直接輸出錯誤 (生產環境建議 Off)
log_errors = Off             ; 記錄錯誤至日誌
track_errors = Off           ; 保存最後錯誤至 $php_errormsg
error_log = filename         ; 指定錯誤日誌檔案

資料處理

variables_order = "EGPCS"    ; 變數註冊順序 (Environment, Get, Post, Cookie, Server)
register_globals = On        ; 將 EGPCS 註冊為全域變數 (建議 Off)
register_argc_argv = On      ; 宣告 $argv, $argc
track_vars = On              ; 啟用 $HTTP_*_VARS 陣列

完整設定請參考官方 php.ini-dist 或 php.ini-recommended。