預定義變數之伺服器變數:$_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 認證功能,這個變數便是認證的類型。