$_SERVER

目錄

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

'PHP_SELF'

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

'argv'

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

'argc'

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

'GATEWAY_INTERFACE'

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

'SERVER_ADDR'

當(dāng)前運(yùn)行腳本所在的服務(wù)器的 IP 地址。

'SERVER_NAME'

當(dāng)前運(yùn)行腳本所在的服務(wù)器的主機(jī)名。如果腳本運(yùn)行于虛擬主機(jī)中，該名稱是由那個(gè)虛擬主機(jī)所設(shè)置的值決定。

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

'SERVER_SOFTWARE'

服務(wù)器標(biāo)識(shí)字符串，在響應(yīng)請(qǐng)求時(shí)的頭信息中給出。

'SERVER_PROTOCOL'

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

'REQUEST_METHOD'

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

注意:

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

'REQUEST_TIME'

請(qǐng)求開始時(shí)的時(shí)間戳。

'REQUEST_TIME_FLOAT'

請(qǐng)求開始時(shí)的時(shí)間戳，微秒級(jí)別的精準(zhǔn)度。

'QUERY_STRING'

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

'DOCUMENT_ROOT'

當(dāng)前運(yùn)行腳本所在的文檔根目錄。在服務(wù)器配置文件中定義。

'HTTP_ACCEPT'

當(dāng)前請(qǐng)求頭中 Accept: 項(xiàng)的內(nèi)容，如果存在的話。

'HTTP_ACCEPT_CHARSET'

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

'HTTP_ACCEPT_ENCODING'

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

'HTTP_ACCEPT_LANGUAGE'

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

'HTTP_CONNECTION'

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

'HTTP_HOST'

當(dāng)前請(qǐng)求頭中 Host: 項(xiàng)的內(nèi)容，如果存在的話。

'HTTP_REFERER'

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

'HTTP_USER_AGENT'

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

'HTTPS'

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

'REMOTE_ADDR'

瀏覽當(dāng)前頁面的用戶的 IP 地址。

'REMOTE_HOST'

瀏覽當(dāng)前頁面的用戶的主機(jī)名。DNS 反向解析不依賴于用戶的 REMOTE_ADDR。

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

'REMOTE_PORT'

用戶機(jī)器上連接到 Web 服務(wù)器所使用的端口號(hào)。

'REMOTE_USER'

經(jīng)驗(yàn)證的用戶

'REDIRECT_REMOTE_USER'

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

'SCRIPT_FILENAME'

當(dāng)前執(zhí)行腳本的絕對(duì)路徑。

注意:

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

'SERVER_ADMIN'

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

'SERVER_PORT'

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

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

'SERVER_SIGNATURE'

包含了服務(wù)器版本和虛擬主機(jī)名的字符串。

'PATH_TRANSLATED'

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

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

'SCRIPT_NAME'

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

'REQUEST_URI'

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

'PHP_AUTH_DIGEST'

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

'PHP_AUTH_USER'

當(dāng) PHP 運(yùn)行在 Apache 或 IIS（PHP 5 是 ISAPI）模塊方式下，并且正在使用 HTTP 認(rèn)證功能，這個(gè)變量便是用戶輸入的用戶名。

'PHP_AUTH_PW'

當(dāng) PHP 運(yùn)行在 Apache 或 IIS（PHP 5 是 ISAPI）模塊方式下，并且正在使用 HTTP 認(rèn)證功能，這個(gè)變量便是用戶輸入的密碼。

'AUTH_TYPE'

當(dāng) PHP 運(yùn)行在 Apache 模塊方式下，并且正在使用 HTTP 認(rèn)證功能，這個(gè)變量便是認(rèn)證的類型。

'PATH_INFO'

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

'ORIG_PATH_INFO'

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