PHP8 $_SERVER

2023-08-19 16:13 更新

$_SERVER — 服務器和執(zhí)行環(huán)境信息

說明

$_SERVER 是一個包含了諸如頭信息（header）、路徑（path）、以及腳本位置（script locations）等信息的 array。這個數(shù)組中的條目由 Web 服務器創(chuàng)建，所以不能保證每個 Web 服務器都提供全部條目；服務器可能會忽略一些，或者提供此處沒有列舉出來的其它內容。然而，大部分變量在 ? CGI 1.1 規(guī)范中都有說明，并且很可能會定義。

注意: 當在命令行運行 PHP 時，這些條目都將無效或者沒有任何意義。

除了下面列出的元素之外，PHP 還將使用請求報頭中的值創(chuàng)建其它元素，這些條目將命名為 HTTP_ 后跟報頭名稱，大寫且使用下劃線而不是連字符。例如 Accept-Language 報頭將作為 $_SERVER['HTTP_ACCEPT_LANGUAGE'] 提供。

目錄

'PHP_SELF'
當前執(zhí)行腳本的文件名，與 document root 有關。例如，在地址為 http://example.com/foo/bar.php 的腳本中使用 $_SERVER['PHP_SELF'] 將得到 /foo/bar.php。__FILE__ 常量包含當前(例如包含)文件的完整路徑和文件名。 如果 PHP 以命令行模式運行，這個變量將包含腳本名。
'argv'
傳遞給該腳本的參數(shù)的數(shù)組。當腳本以命令行方式運行時，argv 變量傳遞給程序 C 語言樣式的命令行參數(shù)。當通過 GET 方式調用時，該變量包含query string。
'argc'
包含命令行模式下傳遞給該腳本的參數(shù)的數(shù)目(如果運行在命令行模式下)。
'GATEWAY_INTERFACE'
服務器使用的 CGI 規(guī)范的版本；例如，'CGI/1.1'。
'SERVER_ADDR'
當前運行腳本所在的服務器的 IP 地址。
'SERVER_NAME'
當前運行腳本所在的服務器的主機名。如果腳本運行于虛擬主機中，該名稱是由那個虛擬主機所設置的值決定。

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

'SERVER_SOFTWARE'
服務器標識字符串，在響應請求時的頭信息中給出。
'SERVER_PROTOCOL'
請求頁面時通信協(xié)議的名稱和版本。例如，'HTTP/1.0'。
'REQUEST_METHOD'
訪問頁面使用的請求方法；例如，'GET'、'HEAD'、'POST'、'PUT'。

注意:

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

'REQUEST_TIME'
請求開始時的時間戳。
'REQUEST_TIME_FLOAT'
請求開始時的時間戳，微秒級別的精準度。
'QUERY_STRING'
query string（查詢字符串），如果有的話，通過它進行頁面訪問。
'DOCUMENT_ROOT'
當前運行腳本所在的文檔根目錄。在服務器配置文件中定義。
'HTTPS'
如果腳本是通過 HTTPS 協(xié)議被訪問，則被設為一個非空的值。
'REMOTE_ADDR'
瀏覽當前頁面的用戶的 IP 地址。
'REMOTE_HOST'
瀏覽當前頁面的用戶的主機名。DNS 反向解析不依賴于用戶的 REMOTE_ADDR。

注意: 必須配置 Web 服務器以創(chuàng)建這個變量。例如在 Apache 中，HostnameLookups On 必須在 httpd.conf 中設置才能存在。參見 gethostbyaddr()。

'REMOTE_PORT'
用戶機器上連接到 Web 服務器所使用的端口號。
'REMOTE_USER'
經驗證的用戶
'REDIRECT_REMOTE_USER'
驗證的用戶，如果請求已在內部重定向。
'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 安全連接，則這個值為用戶設置的 HTTP 端口。

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

'SERVER_SIGNATURE'
包含了服務器版本和虛擬主機名的字符串。
'PATH_TRANSLATED'
當前腳本所在文件系統(tǒng)（非文檔根目錄）的基本路徑。這是在服務器進行虛擬到真實路徑的映像后的結果。

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

'SCRIPT_NAME'
包含當前腳本的路徑。這在頁面需要指向自己時非常有用。__FILE__ 常量包含當前腳本(例如包含文件)的完整路徑和文件名。
'REQUEST_URI'
URI 用來指定要訪問的頁面。例如 “/index.html”。
'PHP_AUTH_DIGEST'
當作為 Apache 模塊運行時，進行 HTTP Digest 認證的過程中，此變量被設置成客戶端發(fā)送的“Authorization” HTTP 頭內容（以便作進一步的認證操作）。
'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'
如果存在的話，包含由客戶端提供的、跟在真實腳本名稱之后并且在查詢字符串之前的路徑信息。例如，如果當前腳本是通過 URI http://www.example.com/php/path_info.php/some/stuff?foo=bar 訪問，那么 $_SERVER['PATH_INFO'] 將包含 /some/stuff。
'ORIG_PATH_INFO'
在被 PHP 處理之前，“PATH_INFO” 的原始版本。

示例

示例 #1 $_SERVER 范例

<?php
echo $_SERVER['SERVER_NAME'];
?>

以上示例的輸出類似于：

www.example.com

注釋

注意:“Superglobal”也稱為自動化的全局變量。這就表示其在腳本的所有作用域中都是可用的。不需要在函數(shù)或方法中用 global $variable; 來訪問它。

參見

  • 過濾器擴展


以上內容是否對您有幫助：
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號