php的預定義變數_PHP

預定義變數
伺服器變數：$_SERVER
注: 在 PHP 4.1.0 及以後版本使用。之前的版本，使用 $HTTP_SERVER_VARS。

$_SERVER 是一個包含諸如頭部(headers)、路徑(paths)和指令碼位置(script locations)的數組。數組的實體由 網頁伺服器建立。不能保證所有的伺服器都能產生所有的資訊；伺服器可能忽略了一些資訊，或者產生了一些未在下面列出的新的資訊。這意味著，大量的這些變數在 CGI 1.1 specification 中說明，所以您應該仔細研究它。

這是一個“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 這個結果。

如果 PHP 以命令列方式運行，該變數無效。

“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”。

“QUERY_STRING”
查詢(query)的字串。

“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() 得到這個資訊。

“REMOTE_ADDR”
正在瀏覽當前頁面使用者的 IP 位址。

“REMOTE_PORT”
使用者串連到伺服器時所使用的連接埠。

“SCRIPT_FILENAME”
當前執行指令碼的絕對路徑名。

“SERVER_ADMIN”
該值指明了 Apache 伺服器設定檔中的 SERVER_ADMIN 參數。如果指令碼運行在一個虛擬機器主機上，則該值是那個虛擬機器主機的值。

“SERVER_PORT”
伺服器所使用的連接埠。預設為“80”。如果你使用 SSL 安全連線，則這個值為您所設定的 HTTP 連接埠。

“SERVER_SIGNATURE”
包含伺服器版本和虛擬機器主機名的字串。

“PATH_TRANSLATED”
當前指令碼所在檔案系統（不是主目錄）的基本路徑。這是在伺服器進行虛擬到真實路徑的映像後的結果。

“SCRIPT_NAME”
包含當前指令碼的路徑。這在頁面需要指向自己時非常有用。

“REQUEST_URI”
訪問此頁面所需的 URI。例如，“/index.html”。

“PHP_AUTH_USER”
當 PHP 運行在 Apache 模組方式下，並且正在使用 HTTP 認證功能，這個變數便是使用者輸入的使用者名稱。

“PHP_AUTH_PW”
當 PHP 運行在 Apache 模組方式下，並且正在使用 HTTP 認證功能，這個變數便是使用者輸入的密碼。

“PHP_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 包含著同樣的資訊，但是不是一個自動全域變數。

如果設定了 register_globals 指令，這些變數也在所有指令碼中可用；也就是，分離了 $_FILES 和 $HTTP_POST_FILES 數組。相關資訊，請參閱安全的相關章節 使用 Register Globals。這些單獨的全域變數不是自動全域變數。

Request 變數：$_REQUEST
注: 在 PHP 4.1.0 及以後版本使用。之前的版本，沒有等價的數組。

由 $_GET，$_POST和$_COOKIE 內容的全部組成的數組。

注: 在 PHP 4.3.0之前, $_FILES 也被包括在 $_REQUEST 數組中。

這是一個“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 包含著同樣的資訊，但是不是一個自動全域變數。

如果設定了 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 選項開啟（預設為關閉）後才有效。

