存档

文章标签 ‘http’

HTTP状态一览表(二)

2009年7月1日

之前本博曾记录http状态一览表,在那一文中只是简单的记录了一个状态信息,这里记录一个较为详细的HTTP状态表。

1xx – 信息提示

这些状态代码表示临时的响应。客户端在收到常规响应之前,应准备接收一个或多个 1xx 响应。
· 100 – Continue 初始的请求已经接受,客户应当继续发送请求的其余部分。(HTTP 1.1新)
· 101 – Switching Protocols 服务器将遵从客户的请求转换到另外一种协议(HTTP 1.1新)

2xx – 成功

这类状态代码表明服务器成功地接受了客户端请求。
· 200 – OK 一切正常,对GET和POST请求的应答文档跟在后面。
· 201 – Created 服务器已经创建了文档,Location头给出了它的URL。
· 202 – Accepted 已经接受请求,但处理尚未完成。
· 203 – Non-Authoritative Information 文档已经正常地返回,但一些应答头可能不正确,因为使用的是文档的拷贝,非权威性信息(HTTP 1.1新)。
· 204 – No Content 没有新文档,浏览器应该继续显示原来的文档。如果用户定期地刷新页面,而Servlet可以确定用户文档足够新,这个状态代码是很有用的。
· 205 – Reset Content 没有新的内容,但浏览器应该重置它所显示的内容。用来强制浏览器清除表单输入内容(HTTP 1.1新)。
· 206 – Partial Content 客户发送了一个带有Range头的GET请求,服务器完成了它(HTTP 1.1新)。

3xx – 重定向

客户端浏览器必须采取更多操作来实现请求。例如,浏览器可能不得不请求服务器上的不同的页面,或通过代理服务器重复该请求。
· 300 – Multiple Choices 客户请求的文档可以在多个位置找到,这些位置已经在返回的文档内列出。如果服务器要提出优先选择,则应该在Location应答头指明。
· 301 – Moved Permanently 客户请求的文档在其他地方,新的URL在Location头中给出,浏览器应该自动地访问新的URL。
· 302 – Found 类似于301,但新的URL应该被视为临时性的替代,而不是永久性的。注意,在HTTP1.0中对应的状态信息是“Moved Temporatily”。出现该状态代码时,浏览器能够自动访问新的URL,因此它是一个很有用的状态代码。注意这个状态代码有时候可以和301替换使 用。例如,如果浏览器错误地请求 http://host/~user (缺少了后面的斜杠),有的服务器返回301,有的则返回302。严格地说,我们只能假定只有当原来的请求是GET时浏览器才会自动重定向。请参见307。
· 303 – See Other 类似于301/302,不同之处在于,如果原来的请求是POST,Location头指定的重定向目标文档应该通过GET提取(HTTP 1.1新)。
· 304 – Not Modified 客户端有缓冲的文档并发出了一个条件性的请求(一般是提供If-Modified-Since头表示客户只想比指定日期更新的文档)。服务器告诉客户,原来缓冲的文档还可以继续使用。
· 305 – Use Proxy 客户请求的文档应该通过Location头所指明的代理服务器提取(HTTP 1.1新)。
· 307 – Temporary Redirect 和302(Found)相同。许多浏览器会错误地响应302应答进行重定向,即使原来的请求是POST,即使它实际上只能在POST请求的应答是303时 才能重定向。由于这个原因,HTTP 1.1新增了307,以便更加清除地区分几个状态代码:当出现303应答时,浏览器可以跟随重定向的GET和POST请求;如果是307应答,则浏览器只 能跟随对GET请求的重定向。(HTTP 1.1新)

4xx – 客户端错误

发生错误,客户端似乎有问题。例如,客户端请求不存在的页面,客户端未提供有效的身份验证信息。

· 400 – Bad Request 请求出现语法错误。

· 401 – Unauthorized 访问被拒绝,客户试图未经授权访问受密码保护的页面。应答中会包含一个WWW-Authenticate头,浏览器据此显示用户名字/密码对话框,然后在 填写合适的Authorization头后再次发出请求。IIS 定义了许多不同的 401 错误,它们指明更为具体的错误原因。这些具体的错误代码在浏览器中显示,但不在 IIS 日志中显示:
· 401.1 – 登录失败。
· 401.2 – 服务器配置导致登录失败。
· 401.3 – 由于 ACL 对资源的限制而未获得授权。
· 401.4 – 筛选器授权失败。
· 401.5 – ISAPI/CGI 应用程序授权失败。
· 401.7 – 访问被 Web 服务器上的 URL 授权策略拒绝。这个错误代码为 IIS 6.0 所专用。

· 403 – Forbidden 资源不可用。服务器理解客户的请求,但拒绝处理它。通常由于服务器上文件或目录的权限设置导致。禁止访问:IIS 定义了许多不同的 403 错误,它们指明更为具体的错误原因:
· 403.1 – 执行访问被禁止。
· 403.2 – 读访问被禁止。
· 403.3 – 写访问被禁止。
· 403.4 – 要求 SSL。
· 403.5 – 要求 SSL 128。
· 403.6 – IP 地址被拒绝。
· 403.7 – 要求客户端证书。
· 403.8 – 站点访问被拒绝。
· 403.9 – 用户数过多。
· 403.10 – 配置无效。
· 403.11 – 密码更改。
· 403.12 – 拒绝访问映射表。
· 403.13 – 客户端证书被吊销。
· 403.14 – 拒绝目录列表。
· 403.15 – 超出客户端访问许可。
· 403.16 – 客户端证书不受信任或无效。
· 403.17 – 客户端证书已过期或尚未生效。
· 403.18 – 在当前的应用程序池中不能执行所请求的 URL。这个错误代码为 IIS 6.0 所专用。
· 403.19 – 不能为这个应用程序池中的客户端执行 CGI。这个错误代码为 IIS 6.0 所专用。
· 403.20 – Passport 登录失败。这个错误代码为 IIS 6.0 所专用。

· 404 – Not Found 无法找到指定位置的资源。这也是一个常用的应答。
· 404.0 -(无) – 没有找到文件或目录。
· 404.1 – 无法在所请求的端口上访问 Web 站点。
· 404.2 – Web 服务扩展锁定策略阻止本请求。
· 404.3 – MIME 映射策略阻止本请求。

· 405 – Method Not Allowed 请求方法(GET、POST、HEAD、DELETE、PUT、TRACE等)对指定的资源不适用,用来访问本页面的 HTTP 谓词不被允许(方法不被允许)(HTTP 1.1新)
· 406 – Not Acceptable 指定的资源已经找到,但它的MIME类型和客户在Accpet头中所指定的不兼容,客户端浏览器不接受所请求页面的 MIME 类型(HTTP 1.1新)。
· 407 – Proxy Authentication Required 要求进行代理身份验证,类似于401,表示客户必须先经过代理服务器的授权。(HTTP 1.1新)
· 408 – Request Timeout 在服务器许可的等待时间内,客户一直没有发出任何请求。客户可以在以后重复同一请求。(HTTP 1.1新)
· 409 – Conflict 通常和PUT请求有关。由于请求和资源的当前状态相冲突,因此请求不能成功。(HTTP 1.1新)
· 410 – Gone 所请求的文档已经不再可用,而且服务器不知道应该重定向到哪一个地址。它和404的不同在于,返回407表示文档永久地离开了指定的位置,而404表示由于未知的原因文档不可用。(HTTP 1.1新)
· 411 – Length Required 服务器不能处理请求,除非客户发送一个Content-Length头。(HTTP 1.1新)
· 412 – Precondition Failed 请求头中指定的一些前提条件失败(HTTP 1.1新)。
· 413 – Request Entity Too Large 目标文档的大小超过服务器当前愿意处理的大小。如果服务器认为自己能够稍后再处理该请求,则应该提供一个Retry-After头(HTTP 1.1新)。
· 414 – Request URI Too Long URI太长(HTTP 1.1新)。
· 415 – 不支持的媒体类型。
· 416 – Requested Range Not Satisfiable 服务器不能满足客户在请求中指定的Range头。(HTTP 1.1新)
· 417 – 执行失败。
· 423 – 锁定的错误。

5xx – 服务器错误

服务器由于遇到错误而不能完成该请求。

· 500 – Internal Server Error 服务器遇到了意料不到的情况,不能完成客户的请求。

· 500.12 – 应用程序正忙于在 Web 服务器上重新启动。
· 500.13 – Web 服务器太忙。
· 500.15 – 不允许直接请求 Global.asa。
· 500.16 – UNC 授权凭据不正确。这个错误代码为 IIS 6.0 所专用。
· 500.18 – URL 授权存储不能打开。这个错误代码为 IIS 6.0 所专用。
· 500.100 – 内部 ASP 错误。

· 501 – Not Implemented 服务器不支持实现请求所需要的功能,页眉值指定了未实现的配置。例如,客户发出了一个服务器不支持的PUT请求。

· 502 – Bad Gateway 服务器作为网关或者代理时,为了完成请求访问下一个服务器,但该服务器返回了非法的应答。 亦说Web 服务器用作网关或代理服务器时收到了无效响应。

· 502.1 – CGI 应用程序超时。
· 502.2 – CGI 应用程序出错。

· 503 – Service Unavailable 服务不可用,服务器由于维护或者负载过重未能应答。例如,Servlet可能在数据库连接池已满的情况下返回503。服务器返回503时可以提供一个 Retry-After头。这个错误代码为 IIS 6.0 所专用。

· 504 – Gateway Timeout 网关超时,由作为代理或网关的服务器使用,表示不能及时地从远程服务器获得应答。(HTTP 1.1新) 。

· 505 – HTTP Version Not Supported 服务器不支持请求中所指明的HTTP版本。(HTTP 1.1新)。

PHP教程, apache

HTTP头信息

2009年6月30日

在做web程序时,常常需要处理HTTP的状态,本博之前曾记录有HTTP状态一览表,其实除了需要了解HTTP状态以外,还需要了解相关的HTTP头信息。

头标由主键/值对组成。它们描述客户端或者服务器的属性、被传输的资源以及应该实现连接。

四种不同类型的头标:
1.通用头标:即可用于请求,也可用于响应,是作为一个整体而不是特定资源与事务相关联。
2.请求头标:允许客户端传递关于自身的信息和希望的响应形式。
3.响应头标:服务器和于传递自身信息的响应。
4.实体头标:定义被传送资源的信息。即可用于请求,也可用于响应。

头标格式:<name>:<value><CRLF>

下表描述在HTTP/1.1中用到的头标
Accept			定义客户端可以处理的媒体类型,按优先级排序;
			在一个以逗号为分隔的列表中,可以定义多种类型和使用通配符。例如:Accept: image/jpeg,image/png,*/
Accept-Charset		定义客户端可以处理的字符集,按优先级排序;
			在一个以逗号为分隔的列表中,可以定义多种类型和使用通配符。例如:Accept-Charset: iso-8859-1,*,utf-8
Accept-Encoding		定义客户端可以理解的编码机制。例如:Accept-Encoding:gzip,compress
Accept-Language		定义客户端乐于接受的自然语言列表。例如:Accept-Language: en,de
Accept-Ranges		一个响应头标,它允许服务器指明:将在给定的偏移和长度处,为资源组成部分的接受请求。
			该头标的值被理解为请求范围的度量单位。例如Accept-Ranges: bytes或Accept-Ranges: none
Age			允许服务器规定自服务器生成该响应以来所经过的时间长度,以秒为单位。
			该头标主要用于缓存响应。例如:Age: 30
Allow			一个响应头标,它定义一个由位于请求URI中的次源所支持的HTTP方法列表。例如:Allow: GET,PUT
aUTHORIZATION		一个响应头标,用于定义访问一种资源所必需的授权(域和被编码的用户ID与口令)。
			例如:Authorization: Basic YXV0aG9yOnBoaWw=
Cache-Control		一个用于定义缓存指令的通用头标。例如:Cache-Control: max-age=30
Connection		一个用于表明是否保存socket连接为开放的通用头标。例如:Connection: close或Connection: keep-alive
Content-Base		一种定义基本URI的实体头标,为了在实体范围内解析相对URLs。
			如果没有定义Content-Base头标解析相对URLs,使用Content-Location URI(存在且绝对)或使用URI请求。
			例如:Content-Base: Http://www.myweb.com
Content-Encoding	一种介质类型修饰符,标明一个实体是如何编码的。例如:Content-Encoding: zip
Content-Language	用于指定在输入流中数据的自然语言类型。例如:Content-Language: en
Content-Length		指定包含于请求或响应中数据的字节长度。例如:Content-Length:382
Content-Location	指定包含于请求或响应中的资源定位(URI)。
			如果是一绝对URL它也作为被解析实体的相对URL的出发点。
			例如:Content-Location: http://www.myweb.com/news
Content-MD5		实体的一种MD5摘要,用作校验和。
			发送方和接受方都计算MD5摘要,接受方将其计算的值与此头标中传递的值进行比较。
			例如:Content-MD5: <base64 of 128 MD5 digest>
Content-Range		随部分实体一同发送;标明被插入字节的低位与高位字节偏移,也标明此实体的总长度。
			例如:Content-Range: 1001-2000/5000
Contern-Type		标明发送或者接收的实体的MIME类型。例如:Content-Type: text/html
Date			发送HTTP消息的日期。例如:Date: Mon,10PR 18:42:51 GMT
ETag			一种实体头标,它向被发送的资源分派一个唯一的标识符。
			对于可以使用多种URL请求的资源,ETag可以用于确定实际被发送的资源是否为同一资源。
			例如:ETag: "208f-419e-30f8dc99"
Expires			指定实体的有效期。例如:Expires: Mon,05 Dec 2008 12:00:00 GMT
Form			一种请求头标,给定控制用户代理的人工用户的电子邮件地址。例如:From: webmaster@myweb.com
Host			被请求资源的主机名。对于使用HTTP/1.1的请求而言,此域是强制性的。例如:Host: www.myweb.com
If-Modified-Since	如果包含了GET请求,导致该请求条件性地依赖于资源上次修改日期。
			如果出现了此头标,并且自指定日期以来,此资源已被修改,应该反回一个304响应代码。
			例如:If-Modified-Since: Mon,10PR 18:42:51 GMT
If-Match		如果包含于一个请求,指定一个或者多个实体标记。只发送其ETag与列表中标记区配的资源。
			例如:If-Match: "208f-419e-308dc99"
If-None-Match		如果包含一个请求,指定一个或者多个实体标记。资源的ETag不与列表中的任何一个条件匹配,操作才执行。
			例如:If-None-Match: "208f-419e-308dc99"
If-Range		指定资源的一个实体标记,客户端已经拥有此资源的一个拷贝。必须与Range头标一同使用。
			如果此实体自上次被客户端检索以来,还不曾修改过,那么服务器只发送指定的范围,否则它将发送整个资源。
			例如:Range: byte=0-499<CRLF>If-Range:"208f-419e-30f8dc99"
If-Unmodified-Since	只有自指定的日期以来,被请求的实体还不曾被修改过,才会返回此实体。
			例如:If-Unmodified-Since:Mon,10PR 18:42:51 GMT
Last-Modified		指定被请求资源上次被修改的日期和时间。例如:Last-Modified: Mon,10PR 18:42:51 GMT
Location		对于一个已经移动的资源,用于重定向请求者至另一个位置。
			与状态编码302(暂时移动)或者301(永久性移动)配合使用。
			例如:Location: http://www2.myweb.com/index.jsp
Max-Forwards		一个用于TRACE方法的请求头标,以指定代理或网关的最大数目,该请求通过网关才得以路由。
			在通过请求传递之前,代理或网关应该减少此数目。例如:Max-Forwards: 3
Pragma			一个通用头标,它发送实现相关的信息。例如:Pragma: no-cache
Proxy-Authenticate	类似于WWW-Authenticate,便是有意请求只来自请求链(代理)的下一个服务器的认证。
			例如:Proxy-Authenticate: Basic realm-admin
Proxy-Proxy-Authorization	类似于授权,但并非有意传递任何比在即时服务器链中更进一步的内容。
			例如:Proxy-Proxy-Authorization: Basic YXV0aG9yOnBoaWw=
Public			列表显示服务器所支持的方法集。例如:Public: OPTIONS,MGET,MHEAD,GET,HEAD
Range			指定一种度量单位和一个部分被请求资源的偏移范围。例如:Range: bytes=206-5513
Refener			一种请求头标域,标明产生请求的初始资源。对于HTML表单,它包含此表单的Web页面的地址。
			例如:Refener: http://www.myweb.com/news/search.html
Retry-After		一种响应头标域,由服务器与状态编码503(无法提供服务)配合发送,以标明再次请求之前应该等待多长时间。
			此时间即可以是一种日期,也可以是一种秒单位。例如:Retry-After: 18
Server			一种标明Web服务器软件及其版本号的头标。例如:Server: Apache/2.0.46(Win32)
Transfer-Encoding	一种通用头标,标明对应被接受方反向的消息体实施变换的类型。例如:Transfer-Encoding: chunked
Upgrade			允许服务器指定一种新的协议或者新的协议版本,与响应编码101(切换协议)配合使用。
			例如:Upgrade: HTTP/2.0
User-Agent		定义用于产生请求的软件类型(典型的如Web浏览器)。
			例如:User-Agent: Mozilla/4.0(compatible; MSIE 5.5; Windows NT; DigExt)
Vary			一个响应头标,用于表示使用服务器驱动的协商从可用的响应表示中选择响应实体。例如:Vary: *
Via			一个包含所有中间主机和协议的通用头标,用于满足请求。例如:Via: 1.0 fred.com, 1.1 wilma.com
Warning			用于提供关于响应状态补充信息的响应头标。例如:Warning: 99 www.myweb.com Piano needs tuning
www-Authenticate	一个提示用户代理提供用户名和口令的响应头标,与状态编码401(未授权)配合使用。响应一个授权头标。
			例如:www-Authenticate: Basic realm=zxm.mgmt

PHP教程, apache

在Debian中安装http扩展

2009年6月29日

由于在项目中需要用到http协议的相关函数,而这些函数PHP默认是没有安装的。http模块已移到PECL扩展库中,因此安装时就需要采用PECL方式进行安装:
pecl install pecl_http

但是,通常情况下是不能正确安装的。因为该扩展库也依赖于其它库,因此在需要安装http扩展模块时按以下操作进行,基本可保证能够正常安装并使用。

apt-get install php5-dev (to enable pecl command)
apt-get install libcurl3 (to get curl support)
apt-get install libmagic
apt-get install libcurl4-gnutls-dev (to enable http_post_fields function)

(注意:上面的括号及括号中的内容在安装时不能输入,那是对每一条命令的功能的一个描述)以上四个都能够正常安装后,再使用以下命令进行安装pecl_http模块。

pecl install pecl_http

此时应该不会报错了,一路enter下去即可,安装完成以后将提示需要在PHP配置文件php.ini中添加如下语句:
extension=http.so

具体这个http.so文件在哪里呢?这个文件在安装pecl_http时自动将其安装到了PHP的默认扩展目录    /usr/lib/php5/20060613+lfs中。若在安装时没有自动安装至该目录,可将安装后生成的http.so文件拷贝到该目录中。

在PHP配置文件php.ini中添加了extension=http.so后,重新启动Apache服务器。此时采用phpinfo()函数将可以看到http模块。

注意:对于想要在命令行使用该扩展,需要在cli下的php.ini中添加该语句。这是因为cli与web方式所需要的PHP配置php.ini各不相同。

以上安装将是在Debian lenny上通过,其它环境的安装应该很类似,读者可参考本文自行安装。

Linux, PHP教程 , , ,

http状态码一览表(一)

2007年9月27日

一些http状态码的含义:

1**:请求收到,继续处理
2**:操作成功收到,分析、接受
3**:完成此请求必须进一步处理
4**:请求包含一个错误语法或不能完成
5**:服务器执行一个完全有效请求失败

100——客户必须继续发出请求
101——客户要求服务器根据请求转换HTTP协议版本

200——交易成功
201——提示知道新文件的URL
202——接受和处理、但处理未完成
203——返回信息不确定或不完整
204——请求收到,但返回信息为空
205——服务器完成了请求,用户代理必须复位当前已经浏览过的文件
206——服务器已经完成了部分用户的GET请求

300——请求的资源可在多处得到
301——删除请求数据
302——在其他地址发现了请求数据
303——建议客户访问其他URL或访问方式
304——客户端已经执行了GET,但文件未变化
305——请求的资源必须从服务器指定的地址得到
306——前一版本HTTP中使用的代码,现行版本中不再使用
307——申明请求的资源临时性删除

400——错误请求,如语法错误
401——请求授权失败
402——保留有效ChargeTo头响应
403——请求不允许
404——没有发现文件、查询或URl
405——用户在Request-Line字段定义的方法不允许
406——根据用户发送的Accept拖,请求资源不可访问
407——类似401,用户必须首先在代理服务器上得到授权
408——客户端没有在用户指定的饿时间内完成请求
409——对当前资源状态,请求不能完成
410——服务器上不再有此资源且无进一步的参考地址
411——服务器拒绝用户定义的Content-Length属性请求
412——一个或多个请求头字段在当前请求中错误
413——请求的资源大于服务器允许的大小
414——请求的资源URL长于服务器允许的长度
415——请求资源不支持请求项目格式
416——请求中包含Range请求头字段,在当前请求资源范围内没有range指示值,请求
也不包含If-Range请求头字段
417——服务器不满足请求Expect头字段指定的期望值,如果是代理服务器,可能是下
一级服务器不能满足请求

500——服务器产生内部错误
501——服务器不支持请求的函数
502——服务器暂时不可用,有时是为了防止发生系统过载
503——服务器过载或暂停维修
504——关口过载,服务器使用另一个关口或服务来响应用户,等待时间设定值较长
505——服务器不支持或拒绝支请求头中指定的HTTP版本

==========================================================

英文版:

100:Continue
101:Switching Protocols
102:Processing

200:OK
201:Created
202:Accepted
203:Non-Authoriative Information
204:No Content
205:Reset Content
206:Partial Content
207:Multi-Status

300:Multiple Choices
301:Moved Permanently
302:Found
303:See Other
304:Not Modified
305:Use Proxy
306:(Unused)
307:Temporary Redirect

400:Bad Request
401:Unauthorized
402:Payment Granted
403:Forbidden
404:File Not Found
405:Method Not Allowed
406:Not Acceptable
407:Proxy Authentication Required
408:Request Time-out
409:Conflict
410:Gone
411:Length Required
412:Precondition Failed
413:Request Entity Too Large
414:Request-URI Too Large
415:Unsupported Media Type
416:Requested range not satisfiable
417:Expectation Failed
422:Unprocessable Entity
423:Locked
424:Failed Dependency

500:Inteal Server Error
501:Not Implemented
502:Bad Gateway
503:Service Unavailable
504:Gateway Timeout
505:HTTP Version Not Supported
507:Insufficient Storage

HTML