请求对象（服务器变量）列表

Fernando Finelli

2.33/5 (19投票s)

2002年4月25日

5分钟阅读

177730

服务器环境变量列表

引言

这是服务器环境变量列表

用法

<% Request.ServerVariables("HTTP_SomeNewHeader") %>

列表

变量	描述
`ALL_HTTP`	客户端发送的所有 HTTP 标头。
`ALL_RAW`	以原始形式检索所有标头。`ALL_RAW` 和 `ALL_HTTP` 的区别在于，`ALL_HTTP` 在标头名称前加上 HTTP_ 前缀，并且标头名称始终大写。在 `ALL_RAW` 中，标头名称和值会按照客户端发送的方式出现。
`APPL_MD_PATH`	检索 ISAPI DLL 应用程序的元数据库路径。
`APPL_PHYSICAL_PATH`	检索与元数据库路径对应的物理路径。IIS 会将 `APPL_MD_PATH` 转换为物理（目录）路径来返回此值。
`AUTH_PASSWORD`	在客户端的身份验证对话框中输入的值。仅当使用基本身份验证时，此变量才可用。
`AUTH_TYPE`	服务器在用户尝试访问受保护脚本时用于验证用户身份的身份验证方法。
`AUTH_USER`	从客户端发送的授权标头派生的用户名，在用户名映射到 Windows 帐户之前。此变量与 `REMOTE_USER` 没有区别。如果您的 Web 服务器上安装了身份验证过滤器，可以将传入用户映射到帐户，则使用 `LOGON_USER` 查看映射的用户名。
`CERT_COOKIE`	客户端证书的唯一 ID，以字符串形式返回。可用作整个客户端证书的签名。
`CERT_FLAGS`	如果存在客户端证书，则 bit0 设置为 1。如果客户端证书的证书颁发机构无效（服务器上识别的 CA 列表中不存在），则 bit1 设置为 1。
`CERT_ISSUER`	客户端证书的颁发者字段（O=MS, OU=IAS, CN=user name, C=USA）。
`CERT_KEYSIZE`	安全套接字层 (SSL) 连接密钥的大小（以比特为单位）。例如，128。
`CERT_SECRETKEYSIZE`	服务器证书私钥的大小（以比特为单位）。例如，1024。
`CERT_SERIALNUMBER`	客户端证书的序列号字段。
`CERT_SERVER_ISSUER`	服务器证书的颁发者字段。
`CERT_SERVER_SUBJECT`	服务器证书的主题字段。
`CERT_SUBJECT`	客户端证书的主题字段。
`CONTENT_LENGTH`	客户端提供的 content 长度。
`CONTENT_TYPE`	content 的数据类型。与附加有信息的查询一起使用，例如 HTTP 查询 GET、POST 和 PUT。
`GATEWAY_INTERFACE`	服务器使用的 CGI 规范的版本。格式为 CGI/revision。
`HTTP_<HeaderName>`	存储在 `HeaderName` 标头中的值。除表中列出的标头外，任何其他标头都必须以 HTTP_ 作为前缀，以便 `ServerVariables` 集合能够检索其值。注意服务器会将 `HeaderName` 中的任何下划线 (_) 字符解释为实际标头中的连字符。例如，如果您指定 `HTTP_MY_HEADER`，服务器将搜索发送为 MY-HEADER 的标头。
`HTTP_ACCEPT`	返回 Accept 标头的值。
`HTTP_ACCEPT_LANGUAGE`	返回一个字符串，描述用于显示内容的语言。
`HTTP_COOKIE`	返回请求中包含的 cookie 字符串。
`HTTP_HOST`	返回 Web 服务器的名称。这可能与 `SERVER_NAME` 相同，也可能不同，具体取决于您在 Web 服务器上使用的名称解析类型（IP 地址、主机标头）。
`HTTP_REFERER`	返回一个字符串，其中包含引用当前页面的页面的 URL（通过 HTML <A> 标签）。请注意，URL 是用户在浏览器地址栏中键入的 URL，可能不包括默认文档的名称。如果页面被重定向，`HTTP_REFERER` 为空。 `HTTP_REFERER` 不是 HTTP 规范中的强制成员。
`HTTP_USER_AGENT`	返回一个字符串，描述发送请求的浏览器。
`HTTPS`	如果请求是通过安全通道 (SSL) 传入，则返回 ON；如果请求是非安全通道，则返回 OFF。
`HTTPS_KEYSIZE`	安全套接字层 (SSL) 连接密钥的大小（以比特为单位）。例如，128。
`HTTPS_SECRETKEYSIZE`	服务器证书私钥的大小（以比特为单位）。例如，1024。
`HTTPS_SERVER_ISSUER`	服务器证书的颁发者字段。
`HTTPS_SERVER_SUBJECT`	服务器证书的主题字段。
`INSTANCE_ID`	IIS 实例的 ID（以文本格式）。如果实例 ID 为 1，则显示为字符串。您可以使用此变量检索请求所属的 Web 服务器实例（在元数据库中）的 ID。
`INSTANCE_META_PATH`	响应请求的 IIS 实例的元数据库路径。
`LOCAL_ADDR`	返回请求传入的服务器地址。这在多宿主计算机上很重要，因为计算机上可能绑定了多个 IP 地址，并且您想知道请求使用了哪个地址。
`LOGON_USER`	用户连接到您的 Web 服务器时正在模拟的 Windows帐户。使用 `REMOTE_USER` 或 `AUTH_US<CODE>E`R 来查看请求标头中包含的原始用户名。只有在安装了身份验证过滤器时，`LOGON_USER` 的值才与其他变量不同。
`PATH_INFO`	客户端提供的额外路径信息。您可以通过使用虚拟路径和 `PATH_INFO` 服务器变量来访问脚本。如果此信息来自 URL，则在传递给 CGI 脚本之前会被服务器解码。
`PATH_TRANSLATED`	`PATH_INFO` 的转换版本，它会获取路径并执行任何必要的虚拟到物理映射。
`QUERY_STRING`	存储在 HTTP 请求中问号 (?) 后面的查询信息。
`REMOTE_ADDR`	发出请求的远程主机的 IP 地址。
`REMOTE_HOST`	发出请求的主机的名称。如果服务器没有此信息，它将设置 `REMOTE_ADDR` 并将此字段留空。
`REMOTE_USER`	从客户端发送的授权标头派生的用户名，在用户名映射到 Windows 帐户之前。如果您的 Web 服务器上安装了身份验证过滤器，可以将传入用户映射到帐户，则使用 `LOGON_USER` 来查看映射的用户名。
`REQUEST_METHOD`	用于发出请求的方法。对于 HTTP，这是 GET、HEAD、POST 等。
`SCRIPT_NAME`	正在执行的脚本的虚拟路径。这用于自引用 URL。
`SERVER_NAME`	服务器的主机名、DNS 别名或 IP 地址，如其在自引用 URL 中所示。
`SERVER_PORT`	发送请求的端口号。
`SERVER_PORT_SECURE`	一个字符串，包含 0 或 1。如果请求是在安全端口上处理的，则为 1。否则为 0。
`SERVER_PROTOCOL`	请求信息协议的名称和版本。格式为 protocol/revision。
`SERVER_SOFTWARE`	响应请求并运行网关的服务器软件的名称和版本。格式为 name/version。
`URL`	给出 URL 的基本部分。