$_SERVER

(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)

$_SERVER — 服务器和执行环境信息

描述

$_SERVER 是一个包含诸如报头、路径和脚本位置等信息的数组。此数组中的条目由 Web 服务器创建，因此不能保证每个 Web 服务器都会提供这些条目；服务器可能会省略某些条目，或者提供此处未列出的其他条目。但是，大多数这些变量都在 » CGI/1.1 规范中有所说明，并且很可能已定义。

注意：在命令行上运行 PHP 时，大多数这些条目都不可用或没有任何意义。

除了下面列出的元素之外，PHP 还会创建附加元素，其值来自请求报头。这些条目的名称将为 HTTP_，后跟报头名称（大写，并使用下划线代替连字符）。例如，Accept-Language 报头将作为 $_SERVER['HTTP_ACCEPT_LANGUAGE'] 提供。

索引

'PHP_SELF'

当前正在执行脚本的文件名，相对于文档根目录。例如，在地址 http://example.com/foo/bar.php 的脚本中，$_SERVER['PHP_SELF'] 将为 /foo/bar.php。 __FILE__ 常量包含当前（即包含的）文件的完整路径和文件名。如果 PHP 作为命令行处理器运行，则此变量包含脚本名称。

'argv'

传递给脚本的参数数组。当在命令行上运行脚本时，这提供了对命令行参数的 C 风格访问。通过 GET 方法调用时，这将包含查询字符串。

'argc'

包含传递给脚本的命令行参数的数量（如果在命令行上运行）。

'GATEWAY_INTERFACE'

服务器正在使用的 CGI 规范版本；例如 'CGI/1.1'。

'SERVER_ADDR'

当前脚本正在其下执行的服务器的 IP 地址。

'SERVER_NAME'

当前脚本正在其下执行的服务器主机名。如果脚本在虚拟主机上运行，则这将是为该虚拟主机定义的值。

注意：在 Apache 2 下，必须设置 UseCanonicalName = On 和 ServerName。否则，此值反映客户端提供的 hostname，该 hostname 可以被伪造。在安全相关的上下文中，依赖此值是不安全的。

'SERVER_SOFTWARE'

服务器识别字符串，在响应请求时在报头中给出。

'SERVER_PROTOCOL'

请求页面所用的信息协议的名称和版本；例如 'HTTP/1.0'；

'REQUEST_METHOD'

用于访问页面的请求方法；例如 'GET'、'HEAD'、'POST'、'PUT'。

注意:
如果请求方法为 HEAD，则在发送报头后（这意味着在不使用输出缓冲的情况下产生任何输出后），PHP 脚本将终止。

'REQUEST_TIME'

请求开始的时间戳。

'REQUEST_TIME_FLOAT'

请求开始的时间戳，精确到微秒。

'QUERY_STRING'

用于访问页面的查询字符串（如果有）。

'DOCUMENT_ROOT'

当前脚本正在其下执行的文档根目录，在服务器的配置文件中定义。

'HTTPS'

如果脚本通过 HTTPS 协议查询，则设置为非空值。

'REMOTE_ADDR'

用户查看当前页面的 IP 地址。

'REMOTE_HOST'

用户查看当前页面的主机名。反向 DNS 查找基于用户的 REMOTE_ADDR。

注意：必须配置 Web 服务器才能创建此变量。例如，在 Apache 中，必须在 httpd.conf 中设置 HostnameLookups On 才能使其存在。另请参见 gethostbyaddr()。

'REMOTE_PORT'

用户机器上用于与 Web 服务器通信的端口。

'REMOTE_USER'

已验证的用户。

'REDIRECT_REMOTE_USER'

如果请求被内部重定向，则为已验证的用户。

'SCRIPT_FILENAME'

当前正在执行脚本的绝对路径名。

注意:
如果脚本使用 CLI 执行，作为相对路径，例如 file.php 或 ../file.php，$_SERVER['SCRIPT_FILENAME'] 将包含用户指定的相对路径。

'SERVER_ADMIN'

在 Web 服务器配置文件中赋予 SERVER_ADMIN（对于 Apache）指令的值。如果脚本在虚拟主机上运行，则这将是为该虚拟主机定义的值。

'SERVER_PORT'

Web 服务器用于通信的服务器机器上的端口。对于默认设置，这将是 '80'；例如，使用 SSL 将将其更改为您定义的安全 HTTP 端口。

注意：在 Apache 2 下，必须设置 UseCanonicalName = On 以及 UseCanonicalPhysicalPort = On 才能获得物理（实际）端口，否则，此值可能会被伪造，并且它可能返回也可能不返回物理端口值。在安全相关的上下文中，依赖此值是不安全的。

'SERVER_SIGNATURE'

包含服务器版本和虚拟主机名的字符串，如果启用，则添加到服务器生成的页面。

'PATH_TRANSLATED'

基于文件系统（而非文档根目录）的当前脚本路径，服务器完成任何虚拟到实际映射后。

注意： Apache 2 用户可以使用 httpd.conf 内部的 AcceptPathInfo = On 来定义 PATH_INFO。

'SCRIPT_NAME'

包含当前脚本的路径。这对于需要指向自身的页面很有用。 __FILE__ 常量包含当前（即包含的）文件的完整路径和文件名。

'REQUEST_URI'

为了访问此页面而给出的 URI；例如，'/index.html'。

'PHP_AUTH_DIGEST'

执行摘要式 HTTP 身份验证时，此变量设置为客户端发送的“授权”报头（然后应使用此报头进行相应的验证）。

'PHP_AUTH_USER'

执行 HTTP 身份验证时，此变量设置为用户提供的用户名。

'PHP_AUTH_PW'

执行 HTTP 身份验证时，此变量设置为用户提供的密码。

'AUTH_TYPE'

执行 HTTP 身份验证时，此变量设置为身份验证类型。

'PATH_INFO'

包含任何客户端提供的路径信息，这些信息位于实际脚本文件名之后，但在查询字符串之前（如果可用）。例如，如果通过 URI http://www.example.com/php/path_info.php/some/stuff?foo=bar 访问当前脚本，则 $_SERVER['PATH_INFO'] 将包含 /some/stuff。

'ORIG_PATH_INFO'