php.ini 文件配置詳解

;;;;;;;;;;;;;;;;
;; 作者：金步國
;; 日期：2006.11.12
;;;;;;;;;;;;;;;;
;;  版權聲明  ;;
;;;;;;;;;;;;;;;;
; 本文作者是一位自由軟件愛好者，所以本文雖然不是軟件，但是本著 GPL 的精神發布。
; 任何人都可以自由使用、轉載、復制和再分發，但必須保留作者署名，
; 亦不得對聲明中的任何條款作任何形式的修改，也不得附加任何其它條件。
; 您可以自由鏈接、下載、傳播此文檔，但前提是必須保證全文完整轉載，包括完整的版權信息和作譯者聲明。
;
; 本文作者十分願意與他人共享勞動成果，如果你對我的其他翻譯作品或者技術文章有興趣，
; 可以在如下位置查看現有作品的列表：
; http://lamp.linux.gov.cn/jinbuguo_florilegium.html
;
;;;;;;;;;;;;;;;;;;;;;;;;;
;; BUG報告，切磋與探討 ;;
;;;;;;;;;;;;;;;;;;;;;;;;;
; 由於作者水平有限，因此不能保證作品內容准確無誤，請在閱讀中自行鑒別。
; 如果你發現了作品中的錯誤，請您來信指出，哪怕是錯別字也好，任何提高作品質量的建議我都將虛心接納。
; 如果你願意就作品中的相關內容與我進行進一步切磋與探討，也歡迎你與我聯系。
; 聯系方式：Email: [email protected] ； QQ: 70171448 ； MSN: [email protected]
;
;;;;;;;;;;;;;;
;;   簡介   ;;
;;;;;;;;;;;;;;
; 本文並非是對英文版 php.ini 的簡單翻譯，而是參考了眾多資料以後，結合自己的理解，
; 在原有 php.ini 基礎上增加了一些實用模塊的配置說明，同時對文件內容的安排進行了調整。
; 由於作者不喜歡 no-free 的玩意兒，所以刪除了除 MySQL 和 PostgreSQL 以外的其他數據庫模塊配置選項。

;;;;;;;;;;;;;;;;;
;; 關於php.ini ;;
;;;;;;;;;;;;;;;;;
; 這個文件必須命名為'php.ini'並放置在httpd.conf中的PHPIniDir指令指定的目錄中。
; 最新版本的php.ini可以在下面兩個位置查看：
; http://cvs.php.net/viewvc.cgi/php-src/php.ini-recommended?view=co
; http://cvs.php.net/viewvc.cgi/php-src/php.ini-dist?view=co


;;;;;;;;;;;;
;;  語法  ;;
;;;;;;;;;;;;
; 該文件的語法非常簡單。空白字符和以分號開始的行被簡單地忽略。
; 章節標題(例如: [php])也被簡單地忽略，即使將來它們可能有某種意義。
;
; 設置指令的格式如下：
; directive = value
; 指令名(directive)是大小寫敏感的！所以"foo=bar"不同於"FOO=bar"。
; 值(value)可以是：
; 1. 用引號界定的字符串(如："foo")
; 2. 一個數字(整數或浮點數，如：0, 1, 34, -1, 33.55)
; 3. 一個PHP常量(如：E_ALL, M_PI)
; 4. 一個INI常量(On, Off, none)
; 5. 一個表達式(如：E_ALL & ~E_NOTICE)
;
; INI文件中的表達式僅使用：位運算符、邏輯非、圓括號：
; | 位或
; & 位與
; ~ 位非
; ! 邏輯非
;
; 布爾標志用 On 表示打開，用 Off 表示關閉。
;
; 一個空字符串可以用在等號後不寫任何東西表示，或者用 none 關鍵字：
; foo =         ; 將foo設為空字符串
; foo = none    ; 將foo設為空字符串
; foo = "none"  ; 將foo設為字符串'none'
;
; 如果你在指令值中使用動態擴展(PHP擴展或Zend擴展)中的常量，
; 那麼你只能在加載這些動態擴展的指令行之後使用這些常量。


;;;;;;;;;;;;;;;;;;
;;  httpd.conf  ;;
;;;;;;;;;;;;;;;;;;
; 還可以在httpd.conf中覆蓋php.ini的值，以進行更靈活的配置：
; php_value name value  ;設置非bool型的指令，將value設為none則清除先前的設定
; php_flag  name on|off ;僅用於設置bool型的指令
;
; PHP常量(如E_ALL)僅能在php.ini中使用，在httpd.conf中必須使用相應的掩碼值。
; 帶"SYS"標志的指令只能在httpd.conf中的全局配置部分使用，
; 帶"ini"標志的指令不能在httpd.conf中使用，它們僅能用於php.ini中。


;==========================================================================================
;;=====================================配置指令詳解========================================
;==========================================================================================
; 以下每個指令的設定值都與 PHP-5.2.0 內建的默認值相同。
; 也就是說，如果'php.ini'不存在，或者你刪掉了某些行，默認值與之相同。

;;;;;;;;;;;;;;
;;  Apache  ;;
;;;;;;;;;;;;;;
[Apache]
; 僅在將PHP作為Apache模塊時才有效。

engine = On
; 是否啟用PHP解析引擎。
; 可以在httpd.conf中基於目錄或者虛擬主機來打開或者關閉PHP解析引擎。

last_modified = Off
; 是否在Last-Modified應答頭中放置該PHP腳本的最後修改時間。

xbithack = Off
; 是否不管文件結尾是什麼，都作為PHP可執行位組來解析。

child_terminate = Off
; PHP腳本在請求結束後是否允許使用apache_child_terminate()函數終止子進程。
; 該指令僅在UNIX平台上將PHP安裝為Apache1.3的模塊時可用。其他情況下皆不存在。


;;;;;;;;;;;;;;;
;;  PHP核心  ;;
;;;;;;;;;;;;;;;

[PHP-Core-DateTime]
; 前四個配置選項目前僅用於date_sunrise()和date_sunset()函數。

date.default_latitude = 31.7667
; 默認緯度

date.default_longitude = 35.2333
; 默認經度

date.sunrise_zenith = 90.583333
; 默認日出天頂

date.sunset_zenith = 90.583333
; 默認日落天頂

date.timezone =
; 未設定TZ環境變量時用於所有日期和時間函數的默認時區。
; 中國大陸應當使用"PRC"
; 應用時區的優先順序為：
; 1. 用date_default_timezone_set()函數設定的時區(如果設定了的話)
; 2. TZ 環境變量(如果非空的話)
; 3. 該指令的值(如果設定了的話)
; 4. PHP自己推測(如果操作系統支持)
; 5. 如果以上都不成功，則使用 UTC


[PHP-Core-Assert]

assert.active = On
; 是否啟用assert()斷言評估

assert.bail = Off
; 是否在發生失敗斷言時中止腳本的執行

assert.callback =
; 發生失敗斷言時執行的回調函數

assert.quiet_eval = Off
; 是否使用安靜評估(不顯示任何錯誤信息，相當於error_reporting=0)。
; 若關閉則在評估斷言表達式的時候使用當前的error_reporting指令值。

assert.warning = On
; 是否對每個失敗斷言都發出警告


[PHP-Core-SafeMode]
; 安全模式是為了解決共享服務器的安全問題而設立的。
; 但試圖在PHP層解決這個問題在結構上是不合理的，
; 正確的做法應當是修改web服務器層和操作系統層。
; 因此在PHP6中廢除了安全模式，並打算使用open_basedir指令取代之。

safe_mode = Off
;SYS
; 是否啟用安全模式。
; 打開時，PHP將檢查當前腳本的擁有者是否和被操作的文件的擁有者相同，
; 相同則允許操作，不同則拒絕操作。

safe_mode_gid = Off
;SYS
; 在安全模式下，默認在訪問文件時會做UID比較檢查。
; 但有些情況下嚴格的UID檢查反而是不適合的，寬松的GID檢查已經足夠。
; 如果你想將其放寬到僅做GID比較，可以打開這個參數。

safe_mode_allowed_env_vars = "PHP_"
;SYS
; 在安全模式下，用戶僅可以更改的環境變量的前綴列表(逗號分隔)。
; 允許用戶設置某些環境變量，可能會導致潛在的安全漏洞。
; 注意: 如果這一參數值為空，PHP將允許用戶更改任意環境變量！

safe_mode_protected_env_vars = "LD_LIBRARY_PATH"
;SYS
; 在安全模式下，用戶不能更改的環境變量列表(逗號分隔)。
; 這些變量即使在safe_mode_allowed_env_vars指令設置為允許的情況下也會得到保護。

safe_mode_exec_dir = "/usr/local/php/bin"
;SYS
; 在安全模式下，只有該目錄下的可執行程序才允許被執行系統程序的函數執行。
; 這些函數是：system, escapeshellarg, escapeshellcmd, exec, passthru,
; proc_close, proc_get_status, proc_nice, proc_open, proc_terminate, shell_exec

safe_mode_include_dir =
;SYS
; 在安全模式下，該組目錄和其子目錄下的文件被包含時，將跳過UID/GID檢查。
; 換句話