HTTP报文有关的笔记,以备不时之需。
HTTP报文格式
报文首部
空行(CR+LF)
报文主体
通常,不一定要有报文主体。
请求报文的报文首部
请求行
请求首部字段
通用首部字段
实体首部字段
其他
请求行:包含请求方法、请求URI和HTTP版本(还应该以回车换行符CRLF结尾),如:GET /index.html HTTP/1.1
请求方法:
GET:最常见,向服务器请求某个资源
POST:起初用于向服务器输入数据。实际上,通常用于HTML表单数据的提交
HEAD:与GET的行为类似,但服务器返回的响应中只包含首部,不会返回主体部分
PUT:向服务器写入文档
DELETE:删除指定资源
TRACE:服务器回送收到的请求信息给客户端,主要用于诊断
CONNECT
OPTIONS:查询服务器支持的方法(通用或针对指定资源)
响应报文的报文首部
状态行
响应首部字段
通用首部字段
实体首部字段
其他
状态行:包含表明响应结果的状态码、原因短语和HTTP版本,如:HTTP/1.1 200 OK
状态码(常见):
-
1×× Informational 信息性状态码
100 Continue
101 Switching Protocols
-
2×× Success 成功状态码
200 OK
成功204 No Content
成功,但不返回任何实体的主体部分206 Partial Content
成功执行了一个范围(Range)请求
-
3×× Redirection 重定向状态码
301 Moved Permanently
永久性重定向,响应报文的Location首部应该有该资源的新URL302 Found
临时性重定向,响应报文的Location首部给出的URL用来临时定位资源303 See Other
请求的资源存在着另一个URI,客户端应使用GET方法定向获取请求的资源304 Not Modified
客户端发送附带条件的请求(请求首部中包含如If-Modified-Since等指定首部)时,服务端有可能返回304,此时,响应报文中不包含任何报文主体。307 Temporary Redirect
临时重定向。与302 Found
含义一样。302禁止POST变换为GET,但实际使用时并不一定,307则更多浏览器可能会遵循这一标准,但也依赖于浏览器具体实现。
-
4×× Client Error 客户端错误状态码
400 Bad Request
请求报文中存在语法错误401 Unauthorized
需要认证,会有适当的首部一同返回404 Not Found
服务器上无法找到请求的资源
-
5×× Server Error 服务器错误状态码
500 Internel Server Error
服务端在执行请求时发生了错误503 Service Unavailable
服务器暂时无法提供服务,可以包含Retry-After首部
首部字段
HTTP首部字段按照实际用途被分为通用首部字段(General Header Fields)、请求首部字段(Request Header Fields)、响应首部字段(Response Header Fields)和实体首部字段(Entity Header Fields)。
按照首部字段在有代理时的不同行为,首部字段又可以分为端到端首部(End-to-end Header)和逐跳首部(Hop-by-hop Header)。逐跳首部只对单次转发有效,经过缓存或代理后不再转发,HTTP/1.1和之后的版本中,要使用逐跳首部时需提供Connection首部字段。端到端首部则会一直发送给最终接收目标。
通用首部字段
通用信息性首部字段:
-
Connection
,两个作用:-
控制不再转发给代理的首部字段(即逐跳首部)。应用程序会删除报文中所有在Connection首部中出现过的首部,如下示例:
# 客户端请求首部 GET / HTTP/1.1 Upgrade: HTTP/1.1 Connection: Upgrade # 经过代理服务器后发送给Web服务器的首部 GET / HTTP/1.1
-
管理持久连接
Connection: close
HTTP/1.1默认都是持久连接,使用close后会明确断开连接Connection: keep-alive
HTTP/1.1之前的版本默认都是非持久连接,使用keep-alive可以维持持久连接
-
Date
创建HTTP报文的时间和日期Trailer
说明在报文主体后记录了哪些首部字段Transfer-Encoding
传输报文主体时采用的编码方式Upgrade
用于检测HTTP协议及其他协议是否可使用更高的版本进行通信Via
追踪客户端与服务器之前的请求和响应报文的传输路径
通用缓存首部字段:
-
Cache-Control
管理缓存信息,是HTTP/1.1引入的一个复杂首部。-
请求指令
no-cache 客户端不接收缓存过的响应
no-store 不缓存响应或请求的任何内容
max-age = [秒] 告诉缓存服务器,如果缓存时间没超过指定时间,就返回缓存
max-stale( = [秒]) 即使缓存过期,只要小于该值,也照常接收
min-fresh = [秒]
no-transform 缓存不能改变实体主体的媒体类型
only-if-cached 只有缓存服务器有缓存指定资源时才返回,否则,返回504 Gateway Timeout
cache-extension
-
响应指令
public 其他用户也可以使用该缓存
private 只有特定用户能使用该缓存
no-cache 缓存服务器可以缓存,但是每次提供给客户端前都必须与服务器确认有效期
no-store 不缓存响应或请求的任何内容
no-transform 缓存不能改变实体主体的媒体类型
must-revalidate 返回缓存时,必须再次验证。会使max-stale无效
proxy-revalidate 告知缓存服务器,客户端带有该指令时必须验证缓存有效性
max-age = [秒] 在指定时间内不需要像源服务器确认。HTTP/1.1优先处理max-age,HTTP/1.0优先处理Expires
s-maxage = [秒] 与max-age功能相同,但s-maxage只适用于供多位用户使用的公共缓存服务器
cache-extension
-
Pragma
HTTP/1.1以前的遗留字段Pargma: no-cache
与Cache-Control: no-cache
功能一致,只用在客户端发送请求时
请求首部字段
请求信息性首部字段:
From
请求来自何方,格式是客户端用户的有效电子邮件地址Host
服务器的主机名和端口号Referer
这次请求的URL是从哪里获得的User-Agent
客户端的浏览器或代理信息
Accept首部字段:
Accept
客户端通过该首部字段告诉服务器自己可以接收哪些媒体类型,如text/html
、image/*
、*/*
。此外,还有可以权重系数(q值)来表示媒体类型的优先级。Accept-Charset
客户端可以接收哪些字符集,也可以有q值-
Accept-Encoding
客户端支持的内容编码及内容编码的优先级顺序。gzip
由文件压缩程序gzip生成的编码格式compress
由UNIX文件压缩程序compress生成的编码格式deflate
组合使用zlib格式及由deflate压缩算法生成的编码格式identify
不执行压缩或不会变化的默认编码格式
Accept-Language
客户端能够处理的自然语言集(中文、英文等)TE
客户端能够处理的传输编码,还可以指定伴随trailer字段的分块传输编码方式
条件请求首部字段:
Expect
客户端通过该首部字段告知服务器它们需求某种行为,现在该首部与响应码100 Continue
紧密相关。如果服务器无法理解该首部的值,就应该返回417 Expectation Failed
If-Match
服务器会比对该字段的值和资源的ETag值,仅当两者一致时,才会执行请求,否则,返回412 Precondition Failed
。该字段值为*
时,会忽略ETag值If-Modified-Since
该字段值应该是一个日期,如果服务器上资源的更新时间较该字段值新则处理该请求,否则,返回304 Not Modified
If-None-Match
与If-Match
相反,该字段的值与请求资源的ETag不一致时,处理该请求If-Range
该字段的值(ETag或时间)与资源的ETag或时间一致时,作为范围请求处理(参加首部字段Range
)。否则,返回全体资源If-Unmodified-Since
与If-Modified-Since
相反,服务器上资源的更新时间早于该字段值时处理请求,否则,返回412 Precondition Failed
Range
范围请求,只获取部分资源。如Range: bytes=5001-10000
,表示获取从第5001字节至10000字节的资源。成功处理范围请求时返回206 Partial Content
响应,无法处理范围请求时返回200 OK
响应及全部资源
安全请求首部字段:
Authorization
向服务器回应自己的身份验证信息。客户端收到来自服务器的401 Authentication Required
响应后,要在其请求中包含这个首部Cookie
HTTP/1.1中没有定义,用于客户端识别和跟踪的扩展首部
代理请求首部字段:
Max-Forwards
只能和TRACE方法一起使用,指定经过代理或其他中间节点的最大数目。每个收到带此首部的TRACE请求的应用程序,在请求转发之前都要将这个值减1;如果应用程序收到请求时,该首部值为0,则立即回应一条200 OK
响应Proxy-Authorization
与Authorization
类似,用于客户端与代理服务器之间的身份验证
响应首部字段
响应信息性首部字段:
Age
响应已经产生了多长时间。HTTP/1.1规定缓存服务器在创建响应时必须包含Age首部Location
客户端应重定向到指定URI,基本配合3**
响应出现Retry-After
告诉客户端多久之后再次发送请求。主要配合503 Service Unavailable
使用,或与3**
响应一起使用Server
HTTP服务器的应用程序信息Warning
协商首部字段:
Accept-Ranges
服务器是否能处理范围请求,bytes表示能,none表示不能-
Vary
通知客户端,服务器端的协商中会使用哪些来自客户端请求的首部
缓存控制:对某次请求,响应报文的Vary中会指定一些首部名称,客户端后续请求相同资源时,这些首部与缓存的那次请求完全一致时才会返回缓存的资源
安全响应首部字段:
Proxy-Authorizate
与WWW-Authenticate
类似,用于代理与客户端之间的认证,407 Proxy Authentication Required
响应必须包含该首部Set-Cookie
非HTTP/1.1标准首部WWW-Authenticate
告诉客户端访问所请求资源的认证方案,401 Unauthorized
响应中肯定有该首部
实体首部字段
实体首部字段是在请求报文和响应报文中的实体部分所使用的首部,用于补充内容的更新时间等与实体相关的信息
实体信息性首部字段:
Allow
通知客户端可以对特定资源使用那些HTTP方法。405 Method Not Allowed
响应中必须包含该首部
内容首部字段:
Content-Encoding
告诉客户端实体的主体部分选用的内容编码方式。具体方式参见Accept-Encoding
Content-Language
告诉客户端实体主体使用的自然语言(中文、英文等)Content-Length
表明实体主体部分的大小(单位:字节)。对实体主体进行内容编码传输时,不能再使用该首部字段Content-Location
报文主体部分相对应的URIContent-MD5
一串由MD5算法生成的值。对于检查在传输过程中数据是否被无意的修改非常有用,但不能用于安全目的,因为报文如果被有意的修改,该字段的值也可以计算后作相应修改Content-Range
针对范围请求,提供了请求实体在原始实体内的位置(范围),还给出了整个实体的长度Content-Type
响应报文中对象的媒体类型
实体缓存首部字段:
ETag
实体标记,就是一种标识资源的方式Expires
资源失效日期,当Cache-Control有指定max-age指令时,会优先处理max-ageLast-Modified
资源最终修改时间
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。