
日期:2007-06-28 作者:喜騰小二 來源:PHPChina
預定義變數
伺服器變數:$_server
注: 在 php 4.1.0 及以後版本使用。之前的版本,使用 $http_server_vars。
$_server 是一個包含諸如頭部(headers)、路徑(paths)和指令檔位置(script locations)的陣列。陣列的實體由
web 伺服器建立。不能保證所有的伺服器都能產生所有的資訊;伺服器可能略過了一些資訊,或者產生了一些未在下麵列出的新的資訊。這意味着,大量的這些變數在 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 認證功能,這個變數便是認證的類型。