php.ini 核心配置選項說明

決定是否容許使用 PHP 代碼開始標誌的縮寫形式（<? ?>）。若果要和 XML 結合使用 PHP，可以禁用此選項以便於內嵌使用 <?xml ?>。否則還可以通過 PHP 來輸出，例如：<?php echo '<?xml version="1.0"'; ?>。若果禁用了，必須使用 PHP 代碼開始標誌的完整形式（<?php ?>）。

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

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

強制 2000 年相容（在不相容的瀏覽器中會出問題）。

是否啟用在函數呼叫時強制參數被按照引用傳遞。此方法已不被贊成並在 PHP/Zend 未來的版本中很可能不再支援。鼓勵使用的方法是在函數定義中指定哪些參數應該用引用傳遞。鼓勵大家嘗試關閉此選項並確保腳本能夠標準運行，以確保該腳本也能在未來的版本中運行（每次使用此特性都會收到一條警示，參數會被按值傳遞而不是按照引用傳遞）。

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

參見引用的解釋。

決定是否暴露 PHP 被安裝在伺服器上（例如在 Web 伺服器的訊息頭中加上其簽名）。沒有任何安全上的威脅，只是讓用戶端能夠知道是否在伺服器中安裝了 PHP。

啟用 Zend 引擎 1 (PHP 4) 相容模式。這影響到了對象的複製、構造及比較。

參見從 PHP 4 移植到 PHP 5。

本指令設定了一個腳本所能夠申請到的最大記憶體位元組數。這有助於防止寫得不好的腳本消耗光伺服器上的可用記憶體。要使用此指令必須在編譯的時候啟動。因此 configure 一行中應該內含：--enable-memory-limit。若果不需要任何記憶體上的限制，必須將其設為 -1。

自 4.3.2 起，當啟動了 memory_limit，PHP 函數 memory_get_usage() 便可以使用了。

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

若果啟動，則環境變量，GET，POST，Cookie 和 Server 變量都能夠分別在全局關聯陣列中找到：$_ENV，$_GET，$_POST，$_COOKIE 和 $_SERVER。

注意自 PHP 4.0.3 起，track_vars 總是開啟的。

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

PHP 用來將 URL 解析為變量的分隔設定清單。

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

參見 register_globals。

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

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

決定是否將 EGPCS（Environment，GET，POST，Cookie，Server）變量註冊為全局變量。

PHP 4.2.0 開始，本選項預設為 off。

關聯訊息請閱讀安全一章中的使用 register_globals。

請注意 register_globals 不能在運行時設定（ini_set()），儘管如以上說明在主電腦容許時可以用 .htaccess。一個 .htaccess 項目的例子：php_flag register_globals off。

決定 PHP 是否定義 argv & argc 變量（可能包括有 GET 訊息）。

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

設定 PHP 是否註冊已過時的 $HTTP_*_VARS 之類的預定義變量。若果為 On（預設值），則類似 $HTTP_GET_VARS 的 PHP 變量會被註冊。若果不使用，為效能考慮建議關閉此選項，而使用超全局陣列例如 $_GET 替代之。

本指令自 PHP 5.0.0 起可用。

設定 POST 資料所容許的最大大小。此設定也影響到檔案上傳。要上傳大檔案，該值必須大於 upload_max_filesize。

若果配置腳本中啟動了記憶體限制，memory_limit 也會影響檔案上傳。通常說，memory_limit 應該比 post_max_size 要大。

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

若果 POST 資料尺寸大於 post_max_size $_POST 和 $_FILES superglobals 便會為空。這可以以多種模式證明，例如，傳遞 $_GET 變量到腳本以處理資料， 也就是 <form action="edit.php?processed=1">, 然後檢視 $_GET['processed'] 是否被設定。

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

指定在主檔案之前自動解析的檔案名。該檔案就像呼叫了 include() 函數一樣被包括進來，因此會使用 include_path。

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

指定在主檔案之後自動解析的檔案名。該檔案就像呼叫了 include() 函數一樣被包括進來，因此會使用 include_path。

特殊值 none 禁止了自動副檔名。

自 4.0b4 起，PHP 總是預設在 HTTP 訊息頭 Content-type: 中輸出字元編碼。要禁止傳送字集，將本選項設為空即可。

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

容許在 PHP 腳本中處理 WebDAV 的 HTTP 請求（例如 PROPFIND，PROPPATCH，MOVE，COPY 等）。此選項在 PHP 4.3.2 以後便不存在了。若果要取得這些請求的 POST 資料，也要設定 always_populate_raw_post_data。

指定一組目錄用於 require()，include() 和 fopen_with_path() 函數來尋找檔案。格式和系統的 PATH 環境變量類似：一組目錄的清單，在 UNIX 下用冒號分隔，在 Windows 下用分號分隔。

例子 G-1. Unix include_path include_path=".:/php/includes"

例子 G-2. Windows include_path include_path=".;c:\php\includes"

在包括路徑中使用 . 可以容許相對路徑，它代表現用的目錄。

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

在會員目錄之下使用 PHP 檔案的基本目錄名，例如 public_html。

PHP 用來尋找動態連線增加庫的目錄。參見 enable_dl 和 dl()。

當 PHP 啟動時所加載的動態連線增加庫。

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

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

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

IIS（在基於 WINNT 的動作系統上）中的 FastCGI 支援模仿用戶端安全令牌的能力。這使得 IIS 能夠定義運行時所基於的請求的安全上下文。Apache 中的 mod_fastcgi 不支援此特性（03/17/2002）。若果在 IIS 中運行則設為 1。預設為 0。

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

是否容許 HTTP 檔案上傳。參見 upload_max_filesize，upload_tmp_dir 和 post_max_size 指令。

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

檔案上傳時存放檔案的臨時目錄。必須是 PHP 程式所有者會員可寫的目錄。若果未指定則 PHP 使用系統預設值。

所上傳的檔案的最大大小。

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

除錯器所使用的主電腦的 DNS 名或 IP 位址。

除錯器所用的埠號。

是否啟用除錯器。