php5.2 的 php.ini 中文版

php5.2 的 php.ini 中文版文章來源：網絡
########
##   簡介   ##
#########
# 本文並非是對英文版 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 內建的默認值相同。
# 也就是說，如果'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檢查。
# 換句話說，如果此處的值爲空，任何UID/GID不符合的文件都不允許被包含。
# 這裏設置的目錄必須已經存在於include_path指令中或者用完整路徑來包含。
# 多個目錄之間用冒號(Win下爲分號)隔開。
# 指定的限制實際上是一個前綴，而非一個目錄名，
# 也就是說"/dir/incl"將允許訪問"/dir/include"和"/dir/incls"
# 如果您希望將訪問控制在一個指定的目錄，那麼請在結尾加上斜線。

sql.safe_mode = Off
#SYS
# 是否使用SQL安全模式。
# 如果打開，指定默認值的數據庫連接函數將會使用這些默認值代替支持的參數。
# 對於每個不同數據庫的連接函數，其默認值請參考相應的手冊頁面。


[PHP-Core-Safe]

allow_url_fopen = On
#ini
# 是否允許打開遠程文件

allow_url_include = Off
#SYS
# 是否允許include/require遠程文件。

disable_classes =
#ini
# 該指令接受一個用逗號分隔的類名列表，以禁用特定的類。

disable_functions =
#ini
# 該指令接受一個用逗號分隔的函數名列表，以禁用特定的函數。

enable_dl = On
#SYS
# 是否允許使用dl()函數。dl()函數僅在將PHP作爲apache模塊安裝時纔有效。
# 禁用dl()函數主要是出於安全考慮，因爲它可以繞過open_basedir指令的限制。
# 在安全模式下始終禁用dl()函數，而不管此處如何設置。

expose_php = On
#ini
# 是否暴露PHP被安裝在服務器上的事實(在http頭中加上其簽名)。
# 它不會有安全上的直接威脅，但它使得客戶端知道服務器上安裝了PHP。

open_basedir =
#SYS
# 將PHP允許操作的所有文件(包括文件自身)都限制在此組目錄列表下。
# 當一個腳本試圖打開一個指定目錄樹之外的文件時，將遭到拒絕。
# 所有的符號連接都會被解析，所以不可能通過符號連接來避開此限制。
# 特殊值'.'指定了存放該腳本的目錄將被當做基準目錄。
# 但這有些危險，因爲腳本的工作目錄可以輕易被chdir()改變。
# 對於共享服務器，在httpd.conf中靈活設置該指令將變得非常有用。
# 在Windows中用分號分隔目錄，UNIX系統中用冒號分隔目錄。
# 作爲Apache模塊時，父目錄中的open_basedir路徑將自動被繼承。
# 指定的限制實際上是一個前綴，而非一個目錄名，
# 也就是說"/dir/incl"將允許訪問"/dir/include"和"/dir/incls"，
# 如果您希望將訪問控制在一個指定的目錄，那麼請在結尾加上一個斜線。
# 默認是允許打開所有文件。


[PHP-Core-Error]

error_reporting = E_ALL & ~E_NOTICE
# 錯誤報告級別是位字段的疊加，推薦使用 E_ALL | E_STRICT
#    1  E_ERROR             致命的運行時錯誤
#    2  E_WARNING           運行時警告(非致命性錯誤)
#    4  E_PARSE             編譯時解析錯誤
#    8  E_NOTICE            運行時提醒(經常是bug，也可能是有意的)
#   16  E_CORE_ERROR        PHP啓動時初始化過程中的致命錯誤
#   32  E_CORE_WARNING      PHP啓動時初始化過程中的警告(非致命性錯)
#   64  E_COMPILE_ERROR     編譯時致命性錯
#  128  E_COMPILE_WARNING   編譯時警告(非致命性錯)
#  256  E_USER_ERROR        用戶自定義的致命錯誤
#  512  E_USER_WARNING      用戶自定義的警告(非致命性錯誤)
# 1024  E_USER_NOTICE       用戶自定義的提醒(經常是bug，也可能是有意的)
# 2048  E_STRICT            編碼標準化警告(建議如何修改以向前兼容)
# 4096  E_RECOVERABLE_ERROR 接近致命的運行時錯誤，若未被捕獲則視同E_ERROR
# 6143  E_ALL               除E_STRICT外的所有錯誤(PHP6中爲8191,即包含所有)

track_errors = Off
# 是否在變量$php_errormsg中保存最近一個錯誤或警告消息。

display_errors = On
# 是否將錯誤信息作爲輸出的一部分顯示。
# 在最終發佈的web站點上，強烈建議你關掉這個特性，並使用錯誤日誌代替(參看下面)。
# 在最終發佈的web站點打開這個特性可能暴露一些安全信息，
# 例如你的web服務上的文件路徑、數據庫規劃或別的信息。

display_startup_errors = Off
# 是否顯示PHP啓動時的錯誤。
# 即使display_errors指令被打開，關閉此參數也將不顯示PHP啓動時的錯誤。
# 建議你關掉這個特性，除非你必須要用於調試中。

report_memleaks = On
# 是否報告內存泄漏。這個參數只在以調試方式編譯的PHP中起作用，
# 並且必須在error_reporting指令中包含 E_WARNING

report_zend_debug = On
# 尚無說明文檔

html_errors = On
# 是否在出錯信息中使用HTML標記。
# 注意: 不要在發佈的站點上使用這個特性！

docref_root =  #"http://localhost/phpmanual/"
docref_ext =   #".html"
# 如果打開了html_errors指令，PHP將會在出錯信息上顯示超連接，
# 直接鏈接到一個說明這個錯誤或者導致這個錯誤的函數的頁面。
# 你可以從http://www.php.net/docs.php下載php手冊，
# 並將docref_root指令指向你本地的手冊所在的URL目錄。
# 你還必須設置docref_ext指令來指定文件的擴展名(必須含有'.')。
# 注意: 不要在發佈的站點上使用這個特性。

error_prepend_string =  #"<font color=#f00>"
# 用於錯誤信息前輸出的字符串
error_append_string =   #"</font>"
# 用於錯誤信息後輸出的字符串

xmlrpc_errors = Off
xmlrpc_error_number = 0
# 尚無文檔


[PHP-Core-Logging]

define_syslog_variables = Off
# 是否定義各種系統日誌變量，如：$LOG_PID, $LOG_CRON 等等。
# 關掉它以提高效率的好主意。
# 你可以在運行時調用define_syslog_variables()函數來定義這些變量。

error_log =
# 將錯誤日誌記錄到哪個文件中。該文件必須對Web服務器用戶可寫。
# syslog 表示記錄到系統日誌中(NT下的事件日誌, Unix下的syslog(3))
# 如果此處未設置任何值，則錯誤將被記錄到Web服務器的錯誤日誌中。

log_errors = Off
# 是否在日誌文件裏記錄錯誤，具體在哪裏記錄取決於error_log指令。
# 強烈建議你在最終發佈的web站點時使用日誌記錄錯誤而不是直接輸出，
# 這樣可以讓你既知道那裏出了問題，又不會暴露敏感信息。

log_errors_max_len = 1024
# 設置錯誤日誌中附加的與錯誤信息相關聯的錯誤源的最大長度。
# 這裏設置的值對顯示的和記錄的錯誤以及$php_errormsg都有效。
# 設爲 0 可以允許無限長度。

ignore_repeated_errors = Off
# 記錄錯誤日誌時是否忽略重複的錯誤信息。
# 錯誤信息必須出現在同一文件的同一行才被被視爲重複。

ignore_repeated_source = Off
# 是否在忽略重複的錯誤信息時忽略重複的錯誤源。


[PHP-Core-Mail]
# 要使郵件函數可用，PHP必須在編譯時能夠訪問sendmail程序。
# 如果使用其它的郵件程序，如qmail或postfix，確保使用了相應的sendmail包裝。
# PHP首先會在系統的PATH環境變量中搜索sendmail，接着按以下順序搜索：
# /usr/bin:/usr/sbin:/usr/etc:/etc:/usr/ucblib:/usr/lib
# 強烈建議在PATH中能夠找到sendmail。
# 另外，編譯PHP的用戶必須能夠訪問sendmail程序。

SMTP = "localhost"
# mail()函數中用來發送郵件的SMTP服務器的主機名稱或者IP地址。僅用於win32。

smtp_port = 25
# SMTP服務器的端口號。僅用於win32。

sendmail_from =
# 發送郵件時使用的"From:"頭中的郵件地址。僅用於win32
# 該選項還同時設置了"Return-Path:"頭。

sendmail_path = "-t -i"
#SYS
# 僅用於unix，也可支持參數(默認的是'sendmail -t -i')
# sendmail程序的路徑，通常爲"/usr/sbin/sendmail或/usr/lib/sendmail"。
# configure腳本會嘗試找到該程序並設定爲默認值，但是如果失敗的話，可以在這裏設定。
# 不使用sendmail的系統應將此指令設定爲sendmail替代程序(如果有的話)。
# 例如，Qmail用戶通常可以設爲"/var/qmail/bin/sendmail"或"/var/qmail/bin/qmail-inject"。
# qmail-inject 不需要任何選項就能正確處理郵件。

mail.force_extra_parameters =
# 作爲額外的參數傳遞給sendmail庫的強制指定的參數附加值。
# 這些參數總是會替換掉mail()的第5個參數，即使在安全模式下也是如此。


[PHP-Core-ResourceLimit]

default_socket_timeout = 60
# 默認socket超時(秒)

max_execution_time = 30
# 每個腳本最大允許執行時間(秒)，0 表示沒有限制。
# 這個參數有助於阻止劣質腳本無休止的佔用服務器資源。
# 該指令僅影響腳本本身的運行時間，任何其它花費在腳本運行之外的時間，
# 如用system()/sleep()函數的使用、數據庫查詢、文件上傳等，都不包括在內。
# 在安全模式下，你不能用ini_set()在運行時改變這個設置。

memory_limit = 16M
# 一個腳本所能夠申請到的最大內存字節數(可以使用K和M作爲單位)。
# 這有助於防止劣質腳本消耗完服務器上的所有內存。
# 要能夠使用該指令必須在編譯時使用"--enable-memory-limit"配置選項。
# 如果要取消內存限制，則必須將其設爲 -1 。
# 設置了該指令後，memory_get_usage()函數將變爲可用。

max_input_time = -1
# 每個腳本解析輸入數據(POST, GET, upload)的最大允許時間(秒)。
# -1 表示不限制。

post_max_size = 8M
# 允許的POST數據最大字節長度。此設定也影響到文件上傳。
# 如果POST數據超出限制，那麼___FCKpd___0
POST和___FCKpd___0
FILES將會爲空。
# 要上傳大文件，該值必須大於upload_max_filesize指令的值。
# 如果啓用了內存限制，那麼該值應當小於memory_limit指令的值。

realpath_cache_size = 16K
#SYS
# 指定PHP使用的realpath(規範化的絕對路徑名)緩衝區大小。
# 在PHP打開大量文件的系統上應當增大該值以提高性能。

realpath_cache_ttl = 120
#SYS
# realpath緩衝區中信息的有效期(秒)。
# 對文件很少變動的系統，可以增大該值以提高性能。


[PHP-Core-FileUpLoad]

file_uploads = On
#SYS
# 是否允許HTTP文件上傳。
# 參見upload_max_filesize, upload_tmp_dir, post_max_size指令

upload_max_filesize = 2M
# 允許上傳的文件的最大尺寸。

upload_tmp_dir =
#SYS
# 文件上傳時存放文件的臨時目錄(必須是PHP進程用戶可寫的目錄)。
# 如果未指定則PHP使用系統默認的臨時目錄。


[PHP-Core-MagicQuotes]
# PHP6將取消魔術引號，相當於下列指令全部爲 Off

magic_quotes_gpc = On
# 是否對輸入的GET/POST/Cookie數據使用自動字符串轉義( '  "  \  NULL )。
# 這裏的設置將自動影響 ___FCKpd___0
GEST ___FCKpd___0
POST ___FCKpd___0
COOKIE 數組的值。
# 若將本指令與magic_quotes_sybase指令同時打開，則僅將單引號(')轉義爲('')，
# 其它特殊字符將不被轉義，即( "  \  NULL )將保持原樣！！
# 建議關閉此特性，並使用自定義的過濾函數。

magic_quotes_runtime = Off
# 是否對運行時從外部資源產生的數據使用自動字符串轉義( '  "  \  NULL )。
# 若打開本指令，則大多數函數從外部資源(數據庫,文本文件等)返回數據都將被轉義。
# 例如：用SQL查詢得到的數據，用exec()函數得到的數據，等等
# 若將本指令與magic_quotes_sybase指令同時打開，則僅將單引號(')轉義爲('')，
# 其它特殊字符將不被轉義，即( "  \  NULL )將保持原樣！！
# 建議關閉此特性，並視具體情況使用自定義的過濾函數。

magic_quotes_sybase = Off
# 是否採用Sybase形式的自動字符串轉義(用 '' 表示 ')


[PHP-Core-HighLight]

highlight.bg = "#FFFFFF"
highlight.comment = "#FF8000"
highlight.default = "#0000BB"
highlight.html = "#000000"
highlight.keyword = "#007700"
highlight.string = "#DD0000"
# 語法高亮模式的色彩(通常用於顯示 .phps 文件)。
# 只要能被<font color=xxx>接受的東西就能正常工作。


[PHP-Core-Langue]

short_open_tag = On
# 是否允許使用"<? ?>"短標識。否則必須使用"<?php ?>"長標識。
# 除非你的php程序僅在受控環境下運行，且只供自己使用，否則請不要使用短標記。
# 如果要和XML結合使用PHP，可以選擇關閉此選項以方便直接嵌入"<?xml ... ?>"，
# 不然你必須用PHP來輸出：<? echo '<?xml version="1.0"'# ?>
# 本指令也會影響到縮寫形式"<?="，它和"<? echo"等價，要使用它也必須打開短標記。

asp_tags = Off
# 是否允許ASP風格的標記"<% %>"，這也會影響到縮寫形式"<%="。
# PHP6中將刪除此指令

arg_separator.output = "&"
# PHP所產生的URL中用來分隔參數的分隔符。
# 另外還可以用"&amp#"或","等等。

arg_separator.input = "&"
# PHP解析URL中的變量時使用的分隔符列表。
# 字符串中的每一個字符都會被當作分割符。
# 另外還可以用",&"等等。

allow_call_time_pass_reference = On
# 是否強迫在函數調用時按引用傳遞參數(每次使用此特性都會收到一條警告)。
# php反對這種做法，並在將來的版本里不再支持，因爲它影響到了代碼的整潔。
# 鼓勵的方法是在函數聲明裏明確指定哪些參數按引用傳遞。
# 我們鼓勵你關閉這一選項，以保證你的腳本在將來版本的語言裏仍能正常工作。

auto_globals_jit = On
# 是否僅在使用到___FCKpd___0
SERVER和___FCKpd___0
ENV變量時才創建(而不是在腳本一啓動時就自動創建)。
# 如果並未在腳本中使用這兩個數組，打開該指令將會獲得性能上的提升。
# 要想該指令生效，必須關閉register_globals和register_long_arrays指令。

auto_prepend_file =
auto_append_file  =
# 指定在主文件之前/後自動解析的文件名。爲空表示禁用該特性。
# 該文件就像調用了include()函數被包含進來一樣，因此會使用include_path指令的值。
# 注意：如果腳本通過exit()終止，那麼自動後綴將不會發生。

variables_order = "EGPCS"
# PHP註冊 Environment, GET, POST, Cookie, Server 變量的順序。
# 分別用 E, G, P, C, S 表示，按從左到右註冊，新值覆蓋舊值。
# 舉例說，設爲"GP"將會導致用POST變量覆蓋同名的GET變量，
# 並完全忽略 Environment, Cookie, Server 變量。
# 推薦使用"GPC"或"GPCS"，並使用getenv()函數訪問環境變量。

register_globals = Off
# 是否將 E, G, P, C, S 變量註冊爲全局變量。
# 打開該指令可能會導致嚴重的安全問題，除非你的腳本經過非常仔細的檢查。
# 推薦使用預定義的超全局變量：___FCKpd___0
ENV, ___FCKpd___0
GET, ___FCKpd___0
POST, ___FCKpd___0
COOKIE, ___FCKpd___0
SERVER
# 該指令受variables_order指令的影響。
# PHP6中已經刪除此指令。

register_argc_argv = On
# 是否聲明$argv和$argc全局變量(包含用GET方法的信息)。
# 建議不要使用這兩個變量，並關掉該指令以提高性能。

register_long_arrays = On
# 是否啓用舊式的長式數組(HTTP_*_VARS)。
# 鼓勵使用短式的預定義超全局數組，並關閉該特性以獲得更好的性能。
# PHP6中已經刪除此指令。

always_populate_raw_post_data = Off
# 是否總是生成$HTTP_RAW_POST_DATA變量(原始POST數據)。
# 否則，此變量僅在遇到不能識別的MIME類型的數據時才產生。
# 不過，訪問原始POST數據的更好方法是 php://input 。
# $HTTP_RAW_POST_DATA對於enctype="multipart/form-data"的表單數據不可用。

unserialize_callback_func =
# 如果解序列化處理器需要實例化一個未定義的類，
# 這裏指定的回調函數將以該未定義類的名字作爲參數被unserialize()調用，
# 以免得到不完整的"__PHP_Incomplete_Class"對象。
# 如果這裏沒有指定函數，或指定的函數不包含(或實現)那個未定義的類，將會顯示警告信息。
# 所以僅在確實需要實現這樣的回調函數時才設置該指令。
# 若要禁止這個特性，只需置空即可。

y2k_compliance = On
# 是否強制打開2000年適應(可能在非Y2K適應的瀏覽器中導致問題)。

zend.ze1_compatibility_mode = Off
# 是否使用兼容Zend引擎I(PHP 4.x)的模式。
# 這將影響對象的複製、構造(無屬性的對象會產生FALSE或0)、比較。
# 兼容模式下，對象將按值傳遞，而不是默認的按引用傳遞。

precision = 14
# 浮點型數據顯示的有效位數。