$_SERVER

目錄

在 $_SERVER 中，你也許能夠，也許不能夠找到下面的這些元素。注意，如果以命令行方式運行 PHP，下面列出的元素幾乎沒有有效的(或是沒有任何實際意義的)。

'PHP_SELF'

當前執(zhí)行腳本的文件名，與 document root 有關(guān)。例如，在地址為 http://example.com/foo/bar.php 的腳本中使用 $_SERVER['PHP_SELF'] 將得到 /foo/bar.php。__FILE__ 常量包含當前(例如包含)文件的完整路徑和文件名。 如果 PHP 以命令行模式運行，這個變量將包含腳本名。

'argv'

傳遞給該腳本的參數(shù)的數(shù)組。當腳本以命令行方式運行時，argv 變量傳遞給程序 C 語言樣式的命令行參數(shù)。當通過 GET 方式調(diào)用時，該變量包含query string。

'argc'

包含命令行模式下傳遞給該腳本的參數(shù)的數(shù)目(如果運行在命令行模式下)。

'GATEWAY_INTERFACE'

服務器使用的 CGI 規(guī)范的版本；例如，“CGI/1.1”。

'SERVER_ADDR'

當前運行腳本所在的服務器的 IP 地址。

'SERVER_NAME'

當前運行腳本所在的服務器的主機名。如果腳本運行于虛擬主機中，該名稱是由那個虛擬主機所設(shè)置的值決定。

注意: 在 Apache 2 里，必須設(shè)置 UseCanonicalName = On 和 ServerName。 否則該值會由客戶端提供，就有可能被偽造。 上下文有安全性要求的環(huán)境里，不應該依賴此值。

'SERVER_SOFTWARE'

服務器標識字符串，在響應請求時的頭信息中給出。

'SERVER_PROTOCOL'

請求頁面時通信協(xié)議的名稱和版本。例如，“HTTP/1.0”。

'REQUEST_METHOD'

訪問頁面使用的請求方法；例如，“GET”, “HEAD”，“POST”，“PUT”。

注意:

如果請求方法為 HEAD，PHP 腳本將在發(fā)送 Header 頭信息之后終止(這意味著在產(chǎn)生任何輸出后，不再有輸出緩沖)。

'REQUEST_TIME'

請求開始時的時間戳。

'REQUEST_TIME_FLOAT'

請求開始時的時間戳，微秒級別的精準度。

'QUERY_STRING'

query string（查詢字符串），如果有的話，通過它進行頁面訪問。

'DOCUMENT_ROOT'

當前運行腳本所在的文檔根目錄。在服務器配置文件中定義。

'HTTP_ACCEPT'

當前請求頭中 Accept: 項的內(nèi)容，如果存在的話。

'HTTP_ACCEPT_CHARSET'

當前請求頭中 Accept-Charset: 項的內(nèi)容，如果存在的話。例如：“iso-8859-1,*,utf-8”。

'HTTP_ACCEPT_ENCODING'

當前請求頭中 Accept-Encoding: 項的內(nèi)容，如果存在的話。例如：“gzip”。

'HTTP_ACCEPT_LANGUAGE'

當前請求頭中 Accept-Language: 項的內(nèi)容，如果存在的話。例如：“en”。

'HTTP_CONNECTION'

當前請求頭中 Connection: 項的內(nèi)容，如果存在的話。例如：“Keep-Alive”。

'HTTP_HOST'

當前請求頭中 Host: 項的內(nèi)容，如果存在的話。

'HTTP_REFERER'

引導用戶代理到當前頁的前一頁的地址（如果存在）。由 user agent 設(shè)置決定。并不是所有的用戶代理都會設(shè)置該項，有的還提供了修改 HTTP_REFERER 的功能。簡言之，該值并不可信。

'HTTP_USER_AGENT'

當前請求頭中 User-Agent: 項的內(nèi)容，如果存在的話。該字符串表明了訪問該頁面的用戶代理的信息。一個典型的例子是：Mozilla/4.5 [en] (X11; U; Linux 2.2.9 i586)。除此之外，你可以通過 get_browser() 來使用該值，從而定制頁面輸出以便適應用戶代理的性能。

'HTTPS'

如果腳本是通過 HTTPS 協(xié)議被訪問，則被設(shè)為一個非空的值。

'REMOTE_ADDR'

瀏覽當前頁面的用戶的 IP 地址。

'REMOTE_HOST'

瀏覽當前頁面的用戶的主機名。DNS 反向解析不依賴于用戶的 REMOTE_ADDR。

注意: 你的服務器必須被配置以便產(chǎn)生這個變量。例如在 Apache 中，你需要在 httpd.conf 中設(shè)置 HostnameLookups On 來產(chǎn)生它。參見 gethostbyaddr()。

'REMOTE_PORT'

用戶機器上連接到 Web 服務器所使用的端口號。

'REMOTE_USER'

經(jīng)驗證的用戶

'REDIRECT_REMOTE_USER'

驗證的用戶，如果請求已在內(nèi)部重定向。

'SCRIPT_FILENAME'

當前執(zhí)行腳本的絕對路徑。

注意:

如果在命令行界面（Command Line Interface, CLI）使用相對路徑執(zhí)行腳本，例如 file.php 或 ../file.php，那么 $_SERVER['SCRIPT_FILENAME'] 將包含用戶指定的相對路徑。

'SERVER_ADMIN'

該值指明了 Apache 服務器配置文件中的 SERVER_ADMIN 參數(shù)。如果腳本運行在一個虛擬主機上，則該值是那個虛擬主機的值。

'SERVER_PORT'

Web 服務器使用的端口。默認值為 “80”。如果使用 SSL 安全連接，則這個值為用戶設(shè)置的 HTTP 端口。

注意: 在 Apache 2 里，為了獲取真實物理端口，必須設(shè)置 UseCanonicalName = On 以及 UseCanonicalPhysicalPort = On。 否則此值可能被偽造，不一定會返回真實端口值。 上下文有安全性要求的環(huán)境里，不應該依賴此值。

'SERVER_SIGNATURE'

包含了服務器版本和虛擬主機名的字符串。

'PATH_TRANSLATED'

當前腳本所在文件系統(tǒng)（非文檔根目錄）的基本路徑。這是在服務器進行虛擬到真實路徑的映像后的結(jié)果。

注意: Apache 2 用戶可以在 httpd.conf 中設(shè)置 AcceptPathInfo = On 來定義 PATH_INFO。

'SCRIPT_NAME'

包含當前腳本的路徑。這在頁面需要指向自己時非常有用。__FILE__ 常量包含當前腳本(例如包含文件)的完整路徑和文件名。

'REQUEST_URI'

URI 用來指定要訪問的頁面。例如 “/index.html”。

'PHP_AUTH_DIGEST'

當作為 Apache 模塊運行時，進行 HTTP Digest 認證的過程中，此變量被設(shè)置成客戶端發(fā)送的“Authorization” HTTP 頭內(nèi)容（以便作進一步的認證操作）。

'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 認證功能，這個變量便是認證的類型。

'PATH_INFO'

包含由客戶端提供的、跟在真實腳本名稱之后并且在查詢語句（query string）之前的路徑信息，如果存在的話。例如，如果當前腳本是通過 URL http://www.example.com/php/path_info.php/some/stuff?foo=bar 被訪問，那么 $_SERVER['PATH_INFO'] 將包含 /some/stuff。

'ORIG_PATH_INFO'

在被 PHP 處理之前，“PATH_INFO” 的原始版本。