預定義變量

自 PHP 4.1.0 起,取得外部變量的偏好方法是用下面提及的超全局變量。在此之前,人們要麼依賴 register_globals,要麼就是長長的預定義 PHP 陣列($HTTP_*_VARS)。自 PHP 5.0.0 起,長格式的 PHP 預定義變量可以通過設定 register_long_arrays 來屏蔽。

伺服器變量:$_SERVER

注: 在 PHP 4.1.0 及以後版本使用。之前的版本,使用 $HTTP_SERVER_VARS

$_SERVER 是一個包括諸如頭訊息(header)、路徑(path)和腳本位置(script locations)的陣列。陣列的實體由 web 伺服器建立。不能保證所有的伺服器都能產生所有的訊息;伺服器可能忽略了一些訊息,或是產生了一些未在下面列出的新的訊息。這意味著,大量的這些變量在 CGI 1.1 規範中說明,所以應該仔細研究一下。

這是一個「superglobal」,或是可以描述為自動全局變量。這只不過意味這它在所有的腳本中都有效。在函數或方法中不需要使用 global $_SERVER; 訪問它,就如同使用 $HTTP_SERVER_VARS 一樣。

$HTTP_SERVER_VARS 包括著同樣的訊息,但是不是一個自動全局變量(注意:$HTTP_SERVER_VARS$_SERVER 是不同的變量,PHP 處理它們的模式不同)。

若果設定了 register_globals 指令,這些變量也在所有腳本中可用;也就是,分離了 $_SERVER$HTTP_SERVER_VARS 陣列。關聯訊息,請參閱安全的關聯章節使用 Register Globals。這些單獨的全局變量不是自動全局變量。

或許會發現下面列出的某些 $_SERVER 元素並不可用。注意,若果以指令行模式運行 PHP,下面列出的元素幾乎沒有有效的(或是沒有任何實際意義的)。

PHP_SELF

現用的正在執行腳本的檔案名,與 document root 關聯。舉例來說,在 URL 位址為 http://example.com/test.php/foo.bar 的腳本中使用 $_SERVER['PHP_SELF'] 將會得到 /test.php/foo.bar 這個結果。__FILE__ 常量包括現用的(例如包括)檔案的絕對路徑和檔案名。

若果 PHP 以指令行模式運行,該變量在 PHP 4.3.0 之前無效。

argv

傳遞給該腳本的參數。當腳本運行在指令行模式時,argv 變量傳遞給程式 C 語系型態的指令行參數。當呼叫 GET 方法時,該變量包括請求的資料。

argc

包括傳遞給程式的指令行參數的個數(若果運行在指令行模式)。

GATEWAY_INTERFACE

伺服器使用的 CGI 規範的版本。例如,「CGI/1.1」。

SERVER_NAME

現用的運行腳本所在伺服器主電腦的名稱。若果該腳本運行在一個虛擬主電腦上,該名稱是由那個虛擬主電腦所設定的值決定。

SERVER_SOFTWARE

伺服器標識的字串,在響應請求時的頭訊息中給出。

SERVER_PROTOCOL

請求頁面時通信協定的名稱和版本。例如,「HTTP/1.0」。

REQUEST_METHOD

訪問頁面時的請求方法。例如:「GET」、「HEAD」,「POST」,「PUT」。

注: 若果請求的模式是 HEAD,PHP 腳本將在送出頭訊息後中止(這意味著在產生任何輸出後,不再有輸出緩衝)。

REQUEST_TIME

請求開始時的時間戳。從 PHP 5.1.0 起有效。

QUERY_STRING

查詢(query)的字串(URL 中第一個問號 ? 之後的內容)。

DOCUMENT_ROOT

現用的運行腳本所在的文件根目錄。在伺服器配置檔中定義。

HTTP_ACCEPT

現用的請求的 Accept: 頭訊息的內容。

HTTP_ACCEPT_CHARSET

現用的請求的 Accept-Charset: 頭訊息的內容。例如:「iso-8859-1,*,utf-8」。

HTTP_ACCEPT_ENCODING

現用的請求的 Accept-Encoding: 頭訊息的內容。例如:「gzip」。

HTTP_ACCEPT_LANGUAGE

現用的請求的 Accept-Language: 頭訊息的內容。例如:「en」。

HTTP_CONNECTION

現用的請求的 Connection: 頭訊息的內容。例如:「Keep-Alive」。

HTTP_HOST

現用的請求的 Host: 頭訊息的內容。

HTTP_REFERER

連結到現用的頁面的前一頁面的 URL 位址。不是所有的會員代理(瀏覽器)都會設定這個變量,而且有的還可以手動修改 HTTP_REFERER。因此,這個變量不總是真實正確的。

HTTP_USER_AGENT

現用的請求的 User-Agent: 頭訊息的內容。該字串顯示了訪問該頁面的會員代理的訊息。一個典型的例子是:Mozilla/4.5 [en] (X11; U; Linux 2.2.9 i586)。也可以使用 get_browser() 得到此訊息。

HTTPS

若果腳本是通過 HTTPS 協定被訪問,則被設為一個非空的值。

REMOTE_ADDR

正在瀏覽現用的頁面會員的 IP 位址。

REMOTE_HOST

正在瀏覽現用的頁面會員的主電腦名。反向功能變數名解析基於該會員的 REMOTE_ADDR

注: 必須配置 Web 伺服器來建立此變量。例如 Apache 需要在 httpd.conf 中有 HostnameLookups On。參見 gethostbyaddr()

REMOTE_PORT

會員連線到伺服器時所使用的埠。

SCRIPT_FILENAME

現用的執行腳本的絕對路徑名。

注: 若果腳本在 CLI 中被執行,作為相對路徑,例如 file.php../file.php$_SERVER['SCRIPT_FILENAME'] 將包括會員特殊的相對路徑。

SERVER_ADMIN

該值指明了 Apache 伺服器配置檔中的 SERVER_ADMIN 參數。若果腳本運行在一個虛擬主電腦上,則該值是那個虛擬主電腦的值。

SERVER_PORT

伺服器所使用的埠。預設為「80」。若果使用 SSL 安全連線,則這個值為會員設定的 HTTP 埠。

SERVER_SIGNATURE

包括伺服器版本和虛擬主電腦名的字串。

PATH_TRANSLATED

現用的腳本所在檔案系統(不是文件根目錄)的基本路徑。這是在伺服器進行虛擬到真實路徑的映像後的結果。

注: PHP 4.3.2 之後,PATH_TRANSLATED 在 Apache 2 SAPI 模式下不再和 Apache 1 一樣隱含賦值,而是若 Apache 不建立此值,PHP 便自己建立並將其值放入 SCRIPT_FILENAME 伺服器常量中。這個修改遵守了 CGI 規範,PATH_TRANSLATED 僅在 PATH_INFO 被定義的條件下才存在。

Apache 2 會員可以使用 httpd.conf 中的 AcceptPathInfo On 來定義 PATH_INFO

SCRIPT_NAME

包括現用的腳本的路徑。這在頁面需要指向自己時非常有用。__FILE__ 包括現用的檔案的絕對路徑和檔案名(例如包括檔案)。

REQUEST_URI

訪問此頁面所需的 URI。例如,「/index.html」。

PHP_AUTH_DIGEST

當作為 Apache 模組運行時,進行 HTTP Digest 認證的過程中,此變量被設定成用戶端傳送的「Authorization」HTTP 頭內容(以便作進一步的認證動作)。

PHP_AUTH_USER

當 PHP 運行在 Apache 或 IIS(PHP 5 是 ISAPI)模組模式下,並且正在使用 HTTP 認證功能,這個變量便是會員輸入的會員名。

PHP_AUTH_PW

當 PHP 運行在 Apache 或 IIS(PHP 5 是 ISAPI)模組模式下,並且正在使用 HTTP 認證功能,這個變量便是會員輸入的密碼。

AUTH_TYPE

當 PHP 運行在 Apache 模組模式下,並且正在使用 HTTP 認證功能,這個變量便是認證的類型。

環境變量:$_ENV

注: 在 PHP 4.1.0 及以後版本使用。之前的版本,使用 $HTTP_ENV_VARS

在解析器運行時,這些變量從環境變量轉變為 PHP 全局變量名稱空間(namespace)。它們中的許多都是由 PHP 所運行的系統決定。完整的清單是不可能的。請檢視系統的文件以確定其特定的環境變量。

其它環境變量(內含 CGI 變量),無論 PHP 是以伺服器模組或是以 CGI 處理模式運行,都在這裡列出了。

這是一個「superglobal」,或是可以描述為自動全局變量。這只不過意味這它在所有的腳本中都有效。在函數或方法中不需要使用 global $_ENV; 來訪問它,就如同使用 $HTTP_ENV_VARS 一樣。

$HTTP_ENV_VARS 包括著同樣的訊息,但是不是一個自動全局變量(注意:$HTTP_ENV_VARS$_ENV 是不同的變量,PHP 處理它們的模式不同)。

若果設定了 register_globals 指令,這些變量也在所有腳本中可用;也就是,分離了 $_ENV$HTTP_ENV_VARS 陣列。關聯訊息,請參閱安全的關聯章節使用 Register Globals。這些單獨的全局變量不是自動全局變量。

HTTP Cookies:$_COOKIE

注: 在 PHP 4.1.0 及以後版本使用。之前的版本,使用 $HTTP_COOKIE_VARS

通過 HTTP cookies 傳遞的變量組成的陣列。是自動全局變量。

這是一個「superglobal」,或是可以描述為自動全局變量。這只不過意味這它在所有的腳本中都有效。在函數或方法中不需要使用 global $_COOKIE; 來訪問它,就如同使用 $HTTP_COOKIE_VARS 一樣。

$HTTP_COOKIE_VARS 包括著同樣的訊息,但是不是一個自動全局變量(注意:$HTTP_COOKIE_VARS$_COOKIE 是不同的變量,PHP 處理它們的模式不同)。

若果設定了 register_globals 指令,這些變量也在所有腳本中可用;也就是,分離了 $_COOKIE$HTTP_COOKIE_VARS 陣列。關聯訊息,請參閱安全的關聯章節使用 Register Globals。這些單獨的全局變量不是自動全局變量。

HTTP GET 變量:$_GET

注: 在 PHP 4.1.0 及以後版本使用。之前的版本,使用 $HTTP_GET_VARS

通過 HTTP GET 方法傳遞的變量組成的陣列。是自動全局變量。

這是一個「superglobal」,或是可以描述為自動全局變量。這只不過意味這它在所有的腳本中都有效。在函數或方法中不需要使用 global $_GET; 來訪問它,就如同使用 $HTTP_GET_VARS 一樣。

$HTTP_GET_VARS 包括著同樣的訊息,但是不是一個自動全局變量(注意:$HTTP_GET_VARS$_GET 是不同的變量,PHP 處理它們的模式不同)。

若果設定了 register_globals 指令,這些變量也在所有腳本中可用;也就是,分離了 $_GET$HTTP_GET_VARS 陣列。關聯訊息,請參閱安全的關聯章節使用 Register Globals。這些單獨的全局變量不是自動全局變量。

HTTP POST 變量:$_POST

注: 在 PHP 4.1.0 及以後版本使用。之前的版本,使用 $HTTP_POST_VARS

通過 HTTP POST 方法傳遞的變量組成的陣列。是自動全局變量。

這是一個「superglobal」,或是可以描述為自動全局變量。這只不過意味這它在所有的腳本中都有效。在函數或方法中不需要使用 global $_POST; 來訪問它,就如同使用 $HTTP_POST_VARS 一樣。

$HTTP_POST_VARS 包括著同樣的訊息,但是不是一個自動全局變量(注意:$HTTP_POST_VARS$_POST 是不同的變量,PHP 處理它們的模式不同)。

若果設定了 register_globals 指令,這些變量也在所有腳本中可用;也就是,分離了 $_POST$HTTP_POST_VARS 陣列。關聯訊息,請參閱安全的關聯章節使用 Register Globals。這些單獨的全局變量不是自動全局變量。

HTTP 檔案上傳變量:$_FILES

注: 在 PHP 4.1.0 及以後版本使用。之前的版本,使用 $HTTP_POST_FILES

通過 HTTP POST 方法傳遞的已上傳檔案項目組成的陣列。是自動全局變量。

這是一個「superglobal」,或是可以描述為自動全局變量。這只不過意味這它在所有的腳本中都有效。在函數或方法中不需要使用 global $_FILES; 來訪問它,就如同使用 $HTTP_POST_FILES 一樣。

$HTTP_POST_FILES 包括著同樣的訊息,但是不是一個自動全局變量(請注意 PHP 是把 $HTTP_POST_FILES$_FILES 這兩個變量當作不同的變量來處理的)。

若果設定了 register_globals 指令,這些變量也在所有腳本中可用;也就是,分離了 $_FILES$HTTP_POST_FILES 陣列。關聯訊息,請參閱安全的關聯章節使用 Register Globals。這些單獨的全局變量不是自動全局變量。

Request 變量:$_REQUEST

注: 在 PHP 4.1.0 及以後版本使用。之前的版本,沒有等價的陣列。

注: 在 PHP 4.3.0 之前,$_FILES 也被內含在 $_REQUEST 陣列中。

此關聯陣列包括 $_GET$_POST$_COOKIE 中的全部內容。

這是一個「superglobal」,或是可以描述為自動全局變量。這只不過意味著它在所有的腳本中都有效。在函數或方法中不需要使用 global $_REQUEST; 來訪問它。

若果設定了 register_globals 指令,這些變量也在所有腳本中可用;也就是,分離了 $_REQUEST 陣列。關聯訊息,請參閱安全的關聯章節使用 Register Globals。這些單獨的全局變量不是自動全局變量。

Session 變量:$_SESSION

注: 在 PHP 4.1.0 及以後版本使用。之前的版本,使用 $HTTP_SESSION_VARS

包括現用的腳本中 session 變量的陣列。參閱 Session 函數文件以獲得更多訊息。

這是一個「superglobal」,或是可以描述為自動全局變量。這只不過意味這它在所有的腳本中都有效。在函數或方法中不需要使用 global $_SESSION; 來訪問它,就如同使用 $HTTP_SESSION_VARS 一樣。

$HTTP_SESSION_VARS 包括著同樣的訊息,但是不是一個自動全局變量(請注意 PHP 是把 $HTTP_SESSION_VARS$_SESSION 這兩個變量當作不同的變量來處理的)。

若果設定了 register_globals 指令,這些變量也在所有腳本中可用;也就是,分離了 $_SESSION$HTTP_SESSION_VARS 陣列。關聯訊息,請參閱安全的關聯章節使用 Register Globals。這些單獨的全局變量不是自動全局變量。

Global 變量:$GLOBALS

注: $GLOBALS 在 PHP 3.0.0 及以後版本中適用。

由所有已定義全局變量組成的陣列。變量名就是該陣列的索引。

這是一個「superglobal」,或是可以描述為自動全局變量。這只不過意味這它在所有的腳本中都有效。在函數或方法中不需要使用 global $GLOBALS; 來訪問它。

前一個錯誤訊息:$php_errormsg

$php_errormsg 是包括 PHP 產生的上一錯誤訊息內容的變量。該變量在發生錯誤並且 track_errors 選項開啟(預設為關閉)後才有效。