php.ini 核心配置選項說明

該列表只包含核心的 php.ini 配置選項。擴展的配置選項在各個擴展的文檔頁面分別被描述。有關 session 的選項可以在 sessions 頁面找到。

Httpd 選項

表 H-3. Httpd 選項

名稱默認值可修改範圍更新記錄
async_send"0"PHP_INI_ALL 

語言選項

表 H-4. 語言和雜類配置選項

名稱默認值可修改範圍更新記錄
short_open_tag"1"PHP_INI_PERDIR在 PHP <= 4.0.0 時是 PHP_INI_ALL。
asp_tags"0"PHP_INI_PERDIR在 PHP <= 4.0.0 時是 PHP_INI_ALL。
precision"14"PHP_INI_ALL 
y2k_compliance"1"PHP_INI_ALL 
allow_call_time_pass_reference"1"PHP_INI_PERDIR在 PHP <= 4.0.0 時是 PHP_INI_ALL。
expose_php"1"僅可在 php.ini 中配置。 
zend.ze1_compatibility_mode"0"PHP_INI_ALL從 PHP 5.0.0 起可用。

以下是配置選項的簡要解釋。

short_open_tag boolean

決定是否允許使用 PHP 代碼開始標誌的縮寫形式()。如果要和 XML 結合使用 PHP,可以禁用此選項以便於嵌入使用 。否則還可以通過 PHP 來輸出,例如:。如果禁用了,必須使用 PHP 代碼開始標誌的完整形式()。

注意: 本指令也會影響到縮寫形式 ,它和 等價。使用此縮寫需要 short_open_tag 的值為 On。

asp_tags boolean

除了通常的 標誌之外還允許使用 ASP 風格的標誌 <% %>。這也包括了輸出變量值的縮寫 <%= $value %>。更多信息見從 HTML 中分離一節。

注意: ASP 風格標誌的支持是 3.0.4 版新加的。

precision integer

浮點數中顯示有效數字的位數。

y2k_compliance boolean

強制 2000 年兼容(在不兼容的瀏覽器中會出問題)。

allow_call_time_pass_reference boolean

在函數調用時參數被按照引用傳遞時是否發出警告。此方法已不被贊成並在 PHP/Zend 未來的版本中很可能不再支持。鼓勵使用的方法是在函數定義中指定哪些參數應該用引用傳遞。鼓勵大家嘗試關閉此選項並確保腳本能夠正常運行,以確保該腳本也能在未來的版本中運行(每次使用此特性都會收到一條警告)。

在函數調用時通過引用傳遞參數是不推薦的,因為它影響到了代碼的整潔。如果函數的參數沒有聲明作為引用傳遞,函數可以通過未寫入文檔的方法修改其參數。要避免其副作用,最好僅在函數聲明時指定那個參數需要通過引用傳遞。

參見引用的解釋

expose_php boolean

決定是否暴露 PHP 被安裝在服務器上(例如在 Web 服務器的信息頭中加上其簽名)。沒有任何安全上的威脅,只是讓客戶端能夠知道是否在服務器中安裝了 PHP。

zend.ze1_compatibility_mode boolean

啟用 Zend 引擎 1(PHP 4) 兼容模式。這影響到了對象的複製、構造(無屬性的對象會產生 FALSE 或 0)及比較。此模式下,對像將以值傳遞,而不是默認的引用傳遞。

參見從 PHP 4 移植到 PHP 5

資源限制

表 H-5. 資源限制

名稱默認值可修改範圍更新記錄
memory_limit"8M"PHP_INI_ALL 

以下是配置選項的簡要解釋。

memory_limit integer

本指令設定了一個腳本所能夠申請到的最大內存字節數。這有助於防止寫得不好的腳本消耗光服務器上的可用內存。要使用此指令必須在編譯的時候激活。因此 configure 一行中應該包括:--enable-memory-limit。如果不需要任何內存上的限制,必須將其設為 -1。

自 4.3.2 起,當激活了 memory_limit,PHP 函數 memory_get_usage() 便可以使用了。

當使用 integer 類型時,其值以字節為度量單位。還可以用簡化符號,說明見此 FAQ

參見 max_execution_time

性能調整

表 H-6. 性能調整

名稱默認值可修改範圍更新記錄
realpath_cache_size"16K"PHP_INI_SYSTEM自 PHP 5.1.0 起可用。
realpath_cache_ttl"120"PHP_INI_SYSTEM自 PHP 5.1.0 起可用。

以下是配置選項的簡要解釋。

realpath_cache_size integer

決定 PHP 所使用的真實路徑緩衝區的大小。此值在 PHP 會打開很多文件的系統下應增大,以反映出所執行文件操作的數量。

realpath_cache_ttl integer

對給定文件或目錄以秒為單位的真實路徑信息緩衝的時間。對文件很少改變的系統,可以考慮增大辭職。

數據處理

表 H-7. 數據處理配置選項

名稱默認值可修改範圍更新記錄
track_vars"On"PHP_INI_?? 
arg_separator.output"&"PHP_INI_ALL從 PHP 4.0.5 起可用。
arg_separator.input"&"PHP_INI_PERDIR從 PHP 4.0.5 起可用。
variables_order"EGPCS"PHP_INI_PERDIR在 PHP <= 5.0.5 時是 PHP_INI_ALL。
auto_globals_jit"1"PHP_INI_PERDIR從 PHP 5.0.0 起可用。
register_globals"0"PHP_INI_PERDIR在 PHP <= 4.2.3 時是 PHP_INI_ALL。
register_argc_argv"1"PHP_INI_PERDIR在 PHP <= 4.2.3 時是 PHP_INI_ALL。
register_long_arrays"1"PHP_INI_PERDIR從 PHP 5.0.0 起可用。
post_max_size"8M"PHP_INI_PERDIR在 PHP <= 4.2.3 時是 PHP_INI_ALL。從 PHP 4.0.3 起可用。
gpc_order"GPC"PHP_INI_ALL 
auto_prepend_fileNULLPHP_INI_PERDIR在 PHP <= 4.2.3 時是 PHP_INI_ALL。
auto_append_fileNULLPHP_INI_PERDIR在 PHP <= 4.2.3 時是 PHP_INI_ALL。
default_mimetype"text/html"PHP_INI_ALL 
default_charset""PHP_INI_ALL 
always_populate_raw_post_data"0"PHP_INI_PERDIR在 PHP <= 4.2.3 時是 PHP_INI_ALL。從 PHP 4.1.0 起可用。
allow_webdav_methods"0"PHP_INI_PERDIR 

以下是配置選項的簡要解釋。

track_vars boolean

如果激活,則環境變量,GET,POST,Cookie 和 Server 變量都能夠分別在全局關聯數組中找到:$_ENV$_GET$_POST$_COOKIE$_SERVER

注意自 PHP 4.0.3 起,track_vars 總是打開的。

arg_separator.output string

PHP 所產生的 URL 中來分隔參數的分隔符。

arg_separator.input string

PHP 用來將 URL 解析為變量的分隔符列表。

注意: 本指令中的每個字符都會被當成分隔符!

variables_order string

設定 EGPCS(Environment,GET,POST,Cookie,Server)變量解析的順序。默認設定為「EGPCS」。舉例說,將其設為「GP」,會導致 PHP 完全忽略環境變量,cookies 和 server 變量,並用 GET 方法的變量覆蓋 POST 方法的同名變量。

參見 register_globals

auto_globals_jit boolean

啟用後,SERVER 和 ENV 變量在他們第一次使用後 (Just In Time) 便被創建,而不是等到腳本開始運行時。如果這些變量沒有在腳本總使用,啟用這個變量會提高服務器性能。

要使此選項有效,PHP 配置選項 register_globals, register_long_arrays, 和 register_argc_argv 必須禁用。

register_globals boolean

決定是否將 EGPCS(Environment,GET,POST,Cookie,Server)變量註冊為全局變量。

PHP 4.2.0 開始,本選項默認為 off

相關信息請閱讀安全一章中的使用 register_globals

請注意 register_globals 不能在運行時設定(ini_set()),儘管如以上說明在主機允許時可以用 .htaccess。一個 .htaccess 項目的例子:php_flag register_globals off

注意: register_globalsvariables_order 選項的影響。

register_argc_argv boolean

決定 PHP 是否定義 argv & argc 變量(可能包含有 GET 信息)。

參見命令行方式。此外,本選項自 PHP 4.0.0 起可用,在此之前總是「On」。

register_long_arrays boolean

設定 PHP 是否註冊已過時的 $HTTP_*_VARS 之類的預定義變量。如果為 On(默認值),則類似 $HTTP_GET_VARS 的 PHP 變量會被註冊。如果不使用,為性能考慮建議關閉此選項,而使用超全局數組例如 $_GET 替代之。

本指令自 PHP 5.0.0 起可用。

post_max_size integer

設定 POST 數據所允許的最大大小。此設定也影響到文件上傳。要上傳大文件,該值必須大於 upload_max_filesize

如果配置腳本中激活了內存限制,memory_limit 也會影響文件上傳。通常說,memory_limit 應該比 post_max_size 要大。

當使用 integer 類型時,其值以字節為度量單位。還可以用簡化符號,說明見此 FAQ

如果 POST 數據尺寸大於 post_max_size $_POST$_FILES superglobals 便會為空。這可以以多種方式證明,例如,傳遞 $_GET 變量到腳本以處理數據, 也就是

, 然後查看 $_GET['processed'] 是否被設置。

gpc_order string

設定 GET/POST/COOKIE 變量解析的順序,默認為「GPC」。舉例說,將其設為「GP」,會導致 PHP 完全忽略 cookie 變量,並用 GET 方法的變量覆蓋 POST 方法的同名變量。

注意: 本選項不能用於 PHP 4。用 variables_order 替代之。

auto_prepend_file string

指定在主文件之前自動解析的文件名。該文件就像調用了 include() 函數一樣被包含進來,因此會使用 include_path

特殊值 none 禁止了自動前綴。

auto_append_file string

指定在主文件之後自動解析的文件名。該文件就像調用了 include() 函數一樣被包含進來,因此會使用 include_path

特殊值 none 禁止了自動後綴。

注意: 如果腳本通過 exit() 終止,則自動後綴不會發生。

default_mimetype string

default_charset string

自 4.0b4 起,PHP 總是默認在 HTTP 信息頭 Content-type: 中輸出字符編碼。要禁止發送字符集,將本選項設為空即可。

always_populate_raw_post_data boolean

總是產生 $HTTP_RAW_POST_DATA 變量包含有原始的 POST 數據。否則,此變量僅在碰到未識別 MIME 類型的數據時產生。不過,訪問原始 POST 數據的更好方法是 php://input$HTTP_RAW_POST_DATA 對於 enctype="multipart/form-data" 表單數據不可用。

allow_webdav_methods boolean

允許在 PHP 腳本中處理 WebDAV 的 HTTP 請求(例如 PROPFIND,PROPPATCH,MOVE,COPY 等)。此選項在 PHP 4.3.2 以後便不存在了。如果要取得這些請求的 POST 數據,也要設定 always_populate_raw_post_data

參見 magic_quotes_gpcmagic-quotes-runtimemagic_quotes_sybase

路徑和目錄

表 H-8. 路徑和目錄配置選項

名稱默認值可修改範圍更新記錄
include_path".;/path/to/php/pear"PHP_INI_ALL 
doc_rootNULLPHP_INI_SYSTEM 
user_dirNULLPHP_INI_SYSTEM 
extension_dir"/path/to/php"PHP_INI_SYSTEM 
extensionNULL僅限於 php.ini 
cgi.fix_pathinfo"1"PHP_INI_ALL從 PHP 4.3.0 起可用
cgi.force_redirect"1"PHP_INI_ALL從 PHP 4.2.0 起可用
cgi.redirect_status_envNULLPHP_INI_ALL從 PHP 4.2.0 起可用
fastcgi.impersonate"0"PHP_INI_ALL從 PHP 4.3.0 起可用
cgi.rfc2616_headers"0"PHP_INI_ALL從 PHP 4.3.0 起可用

以下是配置選項的簡要解釋。

include_path string

指定一組目錄用於 require()include()fopen_with_path() 函數來尋找文件。格式和系統的 PATH 環境變量類似:一組目錄的列表,在 UNIX 下用冒號分隔,在 Windows 下用分號分隔。

例 H-1. Unix include_path

include_path=".:/php/includes"

例 H-2. Windows include_path

include_path=".;c:\php\includes"

在包含路徑中使用 . 可以允許相對路徑,它代表當前目錄。

doc_root string

PHP 在服務器上的根目錄。僅在非空時使用。如果 PHP 被配置為安全模式,則此目錄之外的文件一概不被解析。如果 PHP 編譯時沒有指定 FORCE_REDIRECT,並且在任何 web 服務器(除了 IIS)中以 CGI 方式運行 PHP,則應該設定 doc_root。替代方案是使用下面的 cgi.force_redirect 配置選項。

user_dir string

在用戶目錄之下使用 PHP 文件的基本目錄名,例如 public_html

extension_dir string

PHP 用來尋找動態連接擴展庫的目錄。參見 enable_dldl()

extension string

當 PHP 啟動時所加載的動態連接擴展庫。

cgi.fix_pathinfo boolean

對 CGI 提供了真正的 PATH_INFO/PATH_TRANSLATED 支持。以前 PHP 的行為是將 PATH_TRANSLATED 設為 SCRIPT_FILENAME,而不管 PATH_INFO 是什麼。有關 PATH_INFO 的更多信息見 cgi 規格。將此值設為 1 將使 PHP CGI 修正其路徑以遵守規格。設為 0 將使 PHP 的行為和從前一樣。默認為零。用戶應該修正其腳本使用 SCRIPT_FILENAME 而不是 PATH_TRANSLATED。

cgi.force_redirect boolean

在大多數 web 服務器中以 CGI 方式運行 PHP 時很有必要用 cgi.force_redirect 提供安全。PHP 默認其為 On。可以將其關閉,但風險自擔

注意: Windows 用戶:可以安全地在 IIS 之下將其關閉,事實上必須這麼做。要在 OmniHTTPD 或 Xitami 之下使用也必須將其關閉。

cgi.redirect_status_env string

如果打開了 cgi.force_redirect,並且不是在 Apache 或 Netscape(iPlanet)web 服務器之下運行,可能需要設定一個環境變量名,PHP 將去尋找它來知道可以繼續執行下去。

注意: 設定此變量可能會導致安全問題,首先要知道自己在做什麼。

fastcgi.impersonate string

IIS(在基於 WINNT 的操作系統上)中的 FastCGI 支持模仿客戶端安全令牌的能力。這使得 IIS 能夠定義運行時所基於的請求的安全上下文。Apache 中的 mod_fastcgi 不支持此特性(03/17/2002)。如果在 IIS 中運行則設為 1。默認為 0。

cgi.rfc2616_headers int

指定 PHP 在發送 HTTP 響應代碼時使用何種報頭。如果設定為 0,PHP 發送一個 Status: 報頭,Apache 和其它 web server 都支持。如果此選項設定為 1,PHP 將發送 RFC 2616 兼容的報頭。除非你知道自己在做什麼,否則保留其值為 0。

文件上傳

表 H-9. 文件上傳配置選項

名稱默認值可修改範圍更新記錄
file_uploads"1"PHP_INI_SYSTEM在 PHP <= 4.2.3 時是 PHP_INI_ALL。從 PHP 4.0.3 起可用。
upload_tmp_dirNULLPHP_INI_SYSTEM 
upload_max_filesize"2M"PHP_INI_PERDIR在 PHP <= 4.2.3 時是 PHP_INI_ALL。

以下是配置選項的簡要解釋。

file_uploads boolean

是否允許 HTTP 文件上傳。參見 upload_max_filesizeupload_tmp_dirpost_max_size 指令。

當使用 integer 類型時,其值以字節為度量單位。還可以用簡化符號,說明見此 FAQ

upload_tmp_dir string

文件上傳時存放文件的臨時目錄。必須是 PHP 進程所有者用戶可寫的目錄。如果未指定則 PHP 使用系統默認值。

upload_max_filesize integer

所上傳的文件的最大大小。

當使用 integer 類型時,其值以字節為度量單位。還可以用簡化符號,說明見此 FAQ

普通 SQL

表 H-10. 普通 SQL 配置選項

名稱默認值可修改範圍更新記錄
sql.safe_mode"0"PHP_INI_SYSTEM 

以下是配置選項的簡要解釋。

sql.safe_mode boolean

調試器配置選項

小心

僅 PHP 3 實現了一個默認的調試器。更多信息請參考附錄 F

debugger.host string

調試器所使用的主機的 DNS 名或 IP 地址。

debugger.port string

調試器所用的端口號。

debugger.enabled boolean

是否啟用調試器。