Http 简明教程

HTTP 客户端以请求方法、URI 和协议版本的形式将请求发送到服务器，然后是包含请求修饰符、客户端信息和可能通过 TCP/IP 连接传递的主体内容的 MIME 类似消息。

HTTP 服务器以状态行响应，其中包括消息的协议版本和成功或错误代码，然后是包含服务器信息、实体元信息和可能的实体正文内容的类似 MIME 的消息。

以下两个 URI 是等效的：

以下是有效的字符集：

以下是有效的编码方案：

示例标签包括：

其中任何两个字母的主标签都是 ISO-639 语言缩写，任何两个字母的初始子标签都是 ISO-3166 国家代码。

cache-control 通用首部字段用于指定所有缓存系统必须遵循的指令。以下是语法：

HTTP 客户端或服务器可以使用 Cache-control 通用首部指定缓存参数或从缓存中请求某些类型的文档。缓存指令在一个逗号分隔的列表中指定。例如：

以下是一些重要的缓存请求指令，客户端可以在 HTTP 请求中使用：

服务器可在其 HTTP 响应中使用以下重要缓存响应指令：

Connection general-header 域允许发送者指定对该特定连接所需选项，且代理不得通过进一步连接来通信该选项。以下是使用 connection 头的简单语法：

HTTP/1.1 为发送者定义了“closed”连接选项，以表明将在完成响应后关闭该连接。例如：

默认情况下，HTTP 1.1使用持久连接，其中连接不会在事务后自动关闭。另一方面，HTTP 1.0默认情况下没有持久连接。如果1.0客户端希望使用持久连接，它将使用`@ {s1}`参数，如下所示：

所有HTTP日期/时间戳都必须以格林尼治标准时间（GMT）表示，无一例外。HTTP应用程序可以使用以下三种日期/时间戳表示形式中的任何一种：

此处第一种格式是最优选的格式。

Pragma general-header 域用于包括可能适用于请求/响应链中任何接收者的实现特定指令。例如：

HTTP/1.0 中定义的唯一指令为 no-cache 指令，且为了向后兼容而维持在 HTTP 1.1 中。将来不会再定义新的 Pragma 指令。

Trailer general 域值表明给定头域集存在于使用分块传输编码编码的消息预告中。以下是 Trailer 头域的语法：

Trailer 头域中列出的消息头域不得包含以下头域：

Transfer-Encoding general-header 域表示已经针对消息体应用哪种类型的转换，以为便于在发送者和接收者之间安全传输该消息。这与 content-encoding 不同，因为传输编码是消息的属性，而不是实体体的属性。以下是 Transfer-Encoding 头域的语法：

所有传输编码值不区分大小写。

Upgrade 通用标题允许客户端指定其支持的其他通信协议，如果服务器发现切换协议合适，则客户端希望使用这些协议。例如：

Upgrade 头域旨在为从 HTTP/1.1 转换到其他不兼容协议提供一个简单的机制

网关和代理必须使用 Via 通用头字段来指示中间协议和接收者。例如，请求消息可以从 HTTP/1.0 用户代理发送到内部代理（代号为“fred”），该代理使用 HTTP/1.1 将请求转发到 nowhere.com 上的公共代理，该代理通过将请求转发到 www.ics.uci.edu 上的原始服务器来完成请求。然后，www.ics.uci.edu 收到的请求将具有以下 Via 头字段：

Upgrade 头域旨在为从 HTTP/1.1 转换到其他不兼容协议提供一个简单的机制

Warning 通用标题用于携带有关消息状态或转换的其他信息，这些信息可能不会反映在消息中。响应可能携带多个 Warning 标题。

Accept request-header 域可用于指定对响应而言可接受的特定媒体类型。以下是通用语法：

可以列出用逗号分隔的多个媒体类型，并且可选的 qvalue 表示在 0 到 1 的范围内接受类型的可接受质量级别。以下是一个示例：

这将被解释为 text/html 和 text/x-c 为首选媒体类型，但如果它们不存在，则发送 text/x-dvi 实体，如果该实体不存在，则发送 text/plain 实体。

Accept-Charset 请求头字段可用于指示响应可以接受哪些字符集。以下是基本语法：

多个字符集可以通过逗号分隔列出，可选的 qvalue 表示非首选字符集的可接受质量级别（范围 0 到 1）。以下是一个示例：

特殊值 " ", if present in the *Accept-Charset 字段与所有字符集匹配，并且如果不存在 Accept-Charset 头，则默认为可接受任何字符集。

Accept-Encoding 请求头字段类似于 Accept，但限制了响应中可接受的内容编码。以下是基本语法：

以下是一些示例：

Accept-Language 请求头字段类似于 Accept，但限制了作为响应请求的首选自然语言集。以下是基本语法：

多个语言可以通过逗号分隔列出，可选的 qvalue 表示非首选语言的可接受质量级别（范围 0 到 1）。以下是一个示例：

Authorization 请求头字段的值由凭据组成，其中包含用户代理对请求的资源域进行身份验证的信息。以下是基本语法：

HTTP/1.0 规范定义了 BASIC 授权方案，其中授权参数为 username:password ，用 base64 编码。以下是一个示例：

该值解码为 guest:guest123 ，其中 guest 是用户 ID， guest123 是密码。

Cookie 请求头字段的值包含存储用于该 URL 的信息的名/值对。以下是基本语法：

多个 Cookie 可以用分号分隔来指定，如下所示：

Expect 请求头字段用于指示客户端需要特定服务器行为。以下是基本语法：

如果服务器收到包含 Expect 字段的请求，该字段包含其不支持的期望扩展，则它必须以 417（期望失败）状态进行响应。

From 请求头字段包含控制请求用户代理的人员的互联网电子邮件地址。以下是一个简单的示例：

此头字段可用于记录目的以及作为识别无效或不需要的请求的源的工具。

Host 请求头字段用于指定所请求资源的互联网主机和端口号。以下是基本语法：

不带任何尾随端口信息的 host 表示默认端口 80。例如，[role="bare"] [role="bare"]http://www.w3.org/pub/WWW/ 上对来源服务器的请求将为：

If-Match 请求头字段与方法一起使用，以使其有条件。此头请求服务器仅在给定标签中的值与 ETag 表示的给定实体标签匹配时才执行所请求的方法。以下是基本语法：

星号 (*) 匹配任何实体，且仅当实体存在时事务才会继续。以下是一些可能的示例：

如果没有任何实体标记匹配，或者给出了 "*" 且没有任何当前实体存在，则服务器不得执行请求的方法，并且必须返回 412（前提条件失败）响应。

If-Modified-Since 请求头字段与方法一起使用以使其成为条件请求。如果请求的 URL 自该字段中指定的时间以来未被修改，则不会从服务器返回实体；相反将返回一个没有消息正文的 304（未修改）响应。以下是通用语法：

该字段的一个示例是：

如果没有任何实体标记匹配，或者给出了 "*" 且没有任何当前实体存在，则服务器不得执行请求的方法，并且必须返回 412（前提条件失败）响应。

If-None-Match 请求头字段与方法一起使用以使其成为条件请求。此标头只有当此标记中给定的值之一与 ETag 表示的给定实体标记匹配时才请求服务器执行请求的方法。以下是通用语法：

星号 (*) 匹配任何实体，并且仅当实体不存在时事务才会继续。以下是一些可能的示例：

If-Range 请求头字段可以与条件 GET 一起使用，以仅请求丢失的实体部分（如果它没有被更改），而如果实体已被更改，则请求实体的全部内容。以下是通用语法：

可以实体标记或日期来标识已收到的部分实体。例如：

在此，如果自给定日期以来文档未被修改，则服务器将返回由 Range 标头给出的字节范围，否则返回所有新文档。

If-Unmodified-Since 请求头字段与方法一起使用以使其成为条件请求。以下是通用语法：

如果请求的资源自该字段中指定的时间以来未被修改，则服务器应像 If-Unmodified-Since 标头不存在那样执行请求的操作。例如：

如果请求通常会导致除 2xx 或 412 状态之外的其他任何状态，则应忽略 If-Unmodified-Since 标头。

Max-Forwards 请求头字段为 TRACE 和 OPTIONS 方法提供了一种机制，以限制可以将请求转发到下一个入站服务器的代理或网关的数量。以下是通用语法：

Max-Forwards 值是一个十进制整数，表示此请求消息可以被转发的剩余次数。这对于用 TRACE 方法进行调试非常有用，可以避免无限循环。例如：

对于 HTTP 规范中定义的所有其他方法，可以忽略 Max-Forwards 标头字段。

Proxy-Authorization 请求头字段允许客户端向要求身份验证的代理识别自身（或其用户）。以下是通用语法：

Proxy-Authorization 字段值包含凭据，其中包含用户代理针对被请求资源的代理和/或域的认证信息。

Range 请求头字段指定从文档中请求的内容的部分范围。以下是通用语法：

字节范围规范中的 first-byte-pos 值给出范围中第一个字节的字节偏移量。last-byte-pos 值给出范围中最后一个字节的字节偏移量；也就是说，指定的字节位置是包含的。您可以将字节单位指定为字节 字节偏移量从零开始。以下是一些简单的示例：

多个范围可以使用逗号分隔来列出。如果逗号分隔的字节范围内的第一个数字丢失，则该范围从文档结尾开始计。如果第二个数字丢失，则该范围从字节 n 开始到文档的结尾。

Referer 请求头字段允许客户端指定已从其中请求 URL 的资源的地址 (URI)。以下是一般语法：

以下是一个简单的示例：

如果字段值是相对 URI，则应相对于 Request-URI 进行解释。

TE 请求头字段表明其可能在哪种扩展传输编码中接受响应，以及是否可能接受块传输编码中的拖尾字段。以下是一般语法：

关键字“trailers”的存在表明该客户端愿意在块传输编码中接受拖尾字段，并且可以指定为以下两种方式之一：

如果 TE 字段值为空或没有 TE 字段，则唯一的传输编码是块传输编码。没有传输编码的消息始终是可接受的。

User-Agent 请求头字段包含有关发起请求的用户代理的信息。以下是一般语法：

示例：

Accept-Ranges 响应头字段允许服务器指示其接受对某个资源的范围请求。以下是一般语法：

例如，可以接受字节范围请求的服务器可能会发送

不接受任何类型的对某个资源的范围请求的服务器可能发送：

这将建议客户端不要尝试范围请求。

Age 响应头字段传达发送者估算的响应（或其重新验证）在原始服务器生成后的时间量。以下是一般语法：

Age 值是非负十进制整数，代表以秒为单位的时间。以下是一个简单的示例：

包含缓存的 HTTP/1.1 服务器必须在从其自身缓存生成的每个响应中包含一个 Age 头字段。

ETag 响应头字段提供所请求变体的实体标记的当前值。以下是通用语法：

以下是简单的示例：

Location 响应头字段用于将接收者重定向到 Request-URI 以外的位置进行完成。以下是一般语法：

以下是一个简单的示例：

Content-Location 头字段与 Location 不同，因为 Content-Location 标识请求中包含的实体的原始位置。

代理认证响应头字段必须作为 407（代理认证需要）响应的一部分包含在内。以下是通用语法：

重试后响应头字段可与 503（服务不可用）响应搭配使用，以指示服务预计对请求客户端不可用的时间。以下是通用语法：

以下是两个简单的示例：

在后一个示例中，延迟为 2 分钟。

服务器响应头字段包含有关原始服务器用来处理请求的软件的信息。以下是通用语法：

以下是一个简单的示例：

如果响应通过代理转发，代理应用程序不得修改服务器响应头。

设置 Cookie 响应头字段包含一个用于保留此 URL 的名称/值对。以下是通用语法：

设置 Cookie 响应头包含令牌 Set-Cookie:，后跟一个一个或多个 Cookie 的逗号分隔列表。以下是您可以指定为选项的可能值：

以下是服务器生成的一个简单 Cookie 头的示例：

Vary 响应头字段指定实体有多个来源，因此可能会根据指定的请求头列表而异。以下是通用语法：

您可以在逗号分隔符后指定多个头，而星号“*”的值表示不限于请求头的未指定参数。以下是一个简单的示例：

此处字段名不区分大小写。

WWW-Authenticate 响应头字段必须包含在 401（未授权）响应消息中。该字段值由至少一个挑战组成，该挑战指示适用于 Request-URI 的认证方案和参数。以下是通用语法：

WWW-Authenticate 字段值因为它可能包含多个挑战，或者提供了多个 WWW-Authenticate 头字段，所以挑战本身的内容可以包含一个认证参数逗号分隔列表。以下是一个简单的示例：

Allow 实体首字段列出了由请求 URI 标识的资源支持的方法集。以下是其通用语法：

你可以指定以逗号分隔的多方法。以下是一个简单的示例：

此字段不能防止客户端尝试其他方法。

Content-Encoding 实体首字段用作媒体类型的修饰符。以下是其通用语法：

内容编码是请求 URI 标识的实体的一个特征。以下是一个简单的示例：

如果请求消息中实体的内容编码对原始服务器不可接受，则服务器应以 415（不支持的媒体类型）状态代码进行响应。

Content-Language 实体首字段描述了所附实体的预期受众的自然语言。以下是其通用语法：

针对多个受众的内容可能会列出多种语言。以下是一个简单的示例：

Content-Language 的主要目的是允许用户根据自己的首选语言识别和区分实体。

Content-Length 实体首字段指明发送给收件人的实体主体的大小，以十进制的八位字节数表示，或者对于 HEAD 方法而言，指明如果请求是 GET 发送的实体主体的大小。以下是其通用语法：

以下是一个简单的示例：

任何大于或等于零的内容长度都是一个有效值。

Content-Location 实体头字段可用于在实体可从请求资源的 URI 处不同的某个位置访问时，提供该消息中封送实体的资源位置。后面给出一般语法：

以下是一个简单的示例：

Content-Location 的值也定义了该实体的基 URI。

Content-MD5 实体头字段可用于在收到时提供实体的 MD5 摘要，以检查消息的完整性。后面给出一般语法：

以下是一个简单的示例：

MD5 摘要基于实体体的内容（包括已应用的所有内容编码）计算得出，但不包括对消息体应用的传输编码。

Content-Range 实体头字段随部分实体体一同发送，指定在完整实体体中应将部分体应用于何处。后面给出一般语法：

假设该实体总共包含 1234 个字节，下面给出 byte-content-range-spec 值的示例：

当一条 HTTP 消息包括一个单一范围的内容时，此内容会随 Content-Range 头一同传输，且 Content-Length 头显示实际传输的字节数。例如，

Content-Type 实体头字段指示发送给接收方的实体体的媒体类型，或者在 HEAD 方法的情况下，表示在该请求是 GET 的情况下将发送的媒体类型。后面给出一般语法：

下面是一个示例：

Expires 实体头字段提供反应被认为过时的日期/时间。后面给出一般语法：

下面是一个示例：

Last-Modified 实体头字段指示源服务器认为该变量上次被修改的日期和时间。后面给出一般语法：

下面是一个示例：