Nginx Rewrite 规则相关指令

作者: admin 分类: nginx 发布时间: 2012-12-22 16:46 ė 6 Nginx Rewrite 规则相关指令已关闭评论

Nginx Rewrite 规则相关指令有 if 、rewrite、set 、return、break等。

break 指令
使用环境:server,location,if
该指令的作用是完成当前的规则集,不在处理rewrite指令。
示例如下:
if ($slow) {
limit_rate 10k;
break;
}

if 指令
使用环境:server,location
一下信息可以被指定为条件:
1、变量名,错误的值包括:空字符串””,或者任何以0开始的字符串;
2、变量比较可以使用”=“(表示等于)和 “!=” (标示不等于)运算符;
3、正则表达式模式匹配可以使用“~*”和”~”符号;
4、”~“符号标示区分大小写字母的匹配;
5、”~*“符号标示不区分大小写字母的匹配(例如firfox与FirFox是匹配的);
6、”!~”和“!~*”符号的作用刚好和”~”、”!~*”相反,标示不匹配;
7、“-f”和”!-f”用来判断文件是否存在;
8、“-d”和“!-d”用来判断目录是否存在;
9、”-e”和”!-e”用来判断文件或目录是否存在;
10、”-x”和“!-x”用来判断文件是否可以执行。
部分正在表达式可以在圆括号”()”内,其值可以通过后面的变量$1至$9访问。

return 指令

使用环境:server,location,if
该指令用于结束规则并返回张图码给客户端。状态码可以使用这些值:204,400,402–406,408,410,411,413,416及500—504。此外,非标准状态码444将以下不发送任何Header头的方式结束连接。
示例:如果访问的URL以”.shi”和”.bash”结尾,则返回状态码403;
location ~ .*\.(sh|bash)?$
{
return 403;
}
下面,我们来仔细介绍return指令支持的状态码。
204 No Content
服务器成功处理了请求,但唔系返回任何实体内容,并且希望返回更新了的元信息。响应可能通过实体头部的形式,返回新的更新后的元信息。如果存在这些头部信息,则应当与所请求的变量相呼应。
如果客户端是浏览器,那么用户浏览器应保留发送了请求的页面,而不产生任何文档视图上的变化,即使按照新的或更新的元信息,也应当被应用用户浏览器活动视图中的文档。

400 Bad Request
由于包含语法错误,当前请求无法被服务器理解。除非进行修改,否则客户端不应该重复提交这个请求。

402 Payment Required
状态码是为了将来可能的需求而预留的。

403 Forbidden
服务器已经理解请求,但是拒绝执行它。与401响应不同的是,身份验证并不能提供任何帮助,而且这个请求也不应该被重复提交。如果这不是一个HEAD请求,而且服务器希望能够讲清楚为何请求不能被执行,就应该在实体内描述拒绝的原因。当然服务器可以返回一个404响应,假如它不希望客户端获得任何消息。

404 Not Found
请求失败,请求所希望得到的资源未在服务器上实现。没有信息能够告诉用户这个状况到底是暂时的还是永久的。假如服务器知道情况,应当使用410状态码来告诉旧资源因为某些内部的配置机制问题,已经永久地不可用,而且没有任何可以跳转的地址。404这个状态码被广泛应用于当服务器不想揭示为何请求被拒绝,或者没有其他适合的响应可用的情况下。

405 Method Not Allowd
请求行中指定的请求方法不能被用于请求响应的资源。该响应必须返回一个Allow头信息,用以标示出当前资源能够接受的请求方法列表。

鉴于PUT, DELETE 方法会对服务器上的资源进行写操作,因而绝大部分的网页服务器都不支持或在默认配置下不支持上述请求方法,对于此类请求均会返回405错误。

406 Not Acceptable
请求的资源的内容特性无法满足请求头中的条件,因而无法生成相应实体。
除非这是一个HEAD请求,否则该响应就应当返回一个保护可以让用户或浏览器从中选择最合适的实体特性及地址列表的实体。实体的特性及地址列表的实体。实体的格式由 Content_Type头中定义的类型决定。
浏览器可以根据格式及自身能力行为作出最佳选择。但是,规范中并没有定义任何作出此类自动 选择的标准。

408 Request Timeout
请求超时。客户端没有在服务器预备等待的时间内完成一个请求的发送。客户端可以随时再次提交这一请求而无须任何更改。

410 Gone
被请求的资源在服务器上已经不在可用,而且没有任何已知的转发地址。这样的状况应当被认为是永久性的。如果可能,拥有链接编辑功能的客户端应当在获得用户许可后删除所有指向这个地址的引用。如果服务器不知道或无法确定这个状况是否是永久的,就应该使用404状态码。除非额外说明,否则这个响应是可缓存的。
410响应的目的主要是帮助网站管理员维护网站,通知用户该资源已经不在可用,并且服务器拥有者希望所有指向这个资源的远端链接也被删除。这类事件在限时、增值服务中很普遍。同样,410响应也被用于通知客户端在当前服务器站点上,原本属于某个个人的资源已经不再可用。当然,是否要把所有永久不可用的资源标记为’410 Gone’,以及是否要保持此标记多长时间,完全取决于服务器拥有者。

411 Length Required
服务器拒绝没有定义Content-Length头的情况下接受请求。在添加了表明请求消息体长度的有效Content-Length头之后,客户端可以再次提交请求。

413 Request     Entity    Too  Large
服务器拒绝处理当前请求,因为请求提交的实体数据大小超过了服务器愿意或能够处理的范围。此种情况下,服务器可以关闭连接以免客户端继续发送此请求。
如果这个情况是临时的,服务器应当返回一个Retry-After的响应头,以告知客户端可以在多少时间以后重新尝试。

416  Request Range Not Satisfiable
如果请求中包含了Range请求头,并且Range中指定的任何数据范围都与当前资源的可用范围不重合,同时请求中又没有定义If-Range请求头,那么服务器就应当返回416状态码。
假如Range使用的字节范围,那么这种情况就是指请求指定的所有数据范围的首字节位置都超过了当前资源的长度。服务器也应当在返回416状态码的同时,包含一个Content-Range实体头,用以指明当前资源的长度。这个响应也被禁止使用multipart/byteranges 作为其Content-Type。

500  Internal     Server    Error
服务器遇到了一个未曾的情况,导致了它无法完成对请求的处理。一般来说,这个问题都会在服务器的程序码出错时出现。

501  Not   implemented
服务器不支持当前请求所需要的某个功能。当服务器无法识别请求的方法,并且无法支持其对任何资源的请求时。

502  Bad Gateway
作为网关或代理工作的服务器尝试执行请求时,从上游服务器接收到无效的响应。

503  Service   Unavailable
由于临时的服务器维护或过载,服务器档期无法处理qingq.zhege状况是临时的,并且将在一段时间以后恢复。如果能够预计延迟时间,那么响应中可以包含一个Retry-After头用以标明这个延迟时间。如果没有给出这个Retry-After信息,那么客户端应当以处理500响应的方式处理它。
注意:503状态码的存在并不意味着服务器在过载的时候必须使用它。某些服务器只不过是希望拒绝客户端的连接。

504 Gateway Timeout
作为网关或代理份工作的服务器尝试执行请求时,未能及时从上游服务器(URI 标识出的服务器,例如Http、FTP、LDAP)或辅助服务器(例如DNS)收到响应。
注意:某些代理服务器在DNS查询超时会返回400 或 500 错误。

rewrite 指令

使用环境:server,location,if
如果替换串以http://开头,将会采用301或302跳转进行URL重定向。
rewrite,指令的最后一项参数为flag标记,支持的flag标记有:
last————–相当于Apache里的[L]标记,标示完成rewrite;
break—————–本条规则匹配完成后,终止匹配,不在匹配后面的规则;
redirect—————-返回302临时重定向,浏览器地址栏会显示跳转后的URL地址;
permanent————-返回301永久重定向,浏览器地址栏会显示跳转后的URL地址。

set 命令
使用环境:server,location,if
改命令用于定义一个变量,并给变量赋值。变量的值可以使为文本,变量及文本变量的联合。
示例如下:
set $varname ‘hello’;

uninitialized_variable_warn 指令

使用环境:http,server,location,if
该指令用于开启或关闭记录关于未初始化变量的警告信息,默认是为开启。

nginx Rewrite 可以用到的全局变量
在if、location,rewrite指令中,可以用到一下全局变量:
$args
$content_length
$content_type
$document_root
$document_uri
$host
$http_user_agent
$http_cookie
$limit_rate
$request_body_file
$request_method
$remote_addr
$remote_port
$remote_user
$request_filename
$request_uri
$query_sring
$scheme
$server_protocol
$server_addr
$server_port
$uri

本文出自weicms.net,转载时请注明出处及相应链接。

本文永久链接: http://www.weicms.net/2012/12/22/nginx_rewrite.html

0
Ɣ回顶部