Nginx Rewrite rules and related instructions

1.break command
Default value: none; Usage environment: server, location, if;
The function of this instruction is to complete the current rule set and no longer process the rewrite instruction.
2.if instruction
Default value: none; usage environment: server, location
This instruction is used to check whether a condition is met. If the condition is met, execute the statement within the curly brackets. If instructions do not support nesting, multiple conditions && and || processing are not supported.

* A.变量名，错误的值包括：空字符串""或者任何以0开始的字符串

* B.变量比较可以使用"="(表示等于)和"!="(表示不等于)

* C.正则表达式模式匹配可以使用"~*"和"~"符号

* D."~"符号表示区分大小写字母的匹配

* E."~*"符号表示不区分大小写字母的匹配

* F."!~"和"!~*"符号的作用刚好和"~"、"~*"相反，表示不匹配

* G."-f"和"!-f"用来判断文件是否存在

* H."-d"和"!-d"用来判断目录是否存在

* I."-e"和"!-e"用来判断文件或目录是否存在

* J."-x"和"!-x"用来判断文件是否为可执行

* 

K. Some regular expressions can be accessed within () with 1$1~$9
Supplement:
Explanation of global variable parameters of nginx:
arg_PARAMETER #This variable contains the value of the variable PARAMETER in the GET request if there is one. $arg_PARAMETER#这个变量包含GET请求中，如果有变量PARAMETER时的值。$args #This variable is equal to the parameters in the request line (GET request), such as foo=123&bar=blahblah;
binary_remote_addr#Binary customer address. $binary_remote_addr#二进制的客户地址。$body_bytes_sent#The number of body bytes sent in response. This data is accurate even if the connection is interrupted.
content_length#Content-length field in the request header. $content_length#请求头中的Content-length字段。$content_type#Content-Type field in the request header.
cookie_COOKIE#The value of the cookie COOKIE variable$cookie_COOKIE#cookie COOKIE变量的值$document_root#The current request is the value specified in the root directive.
document_uri# is the same as $document_uri#与$uri.
host#Request host header field, otherwise it is the server name. $host#请求主机头字段，否则为服务器名称。$hostname#Set to the machine's hostname as returned by gethostname
http H EADER$http_HEADER$is_args#If any ar gsginsengcount, This changeamountetc 在”?” ,Nothenetc in ”” , empty worth.$args参数，这个变量等于”?”，否则等于””，空值。$http_user_agent#客户端agent信息
http_cookie#客户端cookie信息$http_cookie#客户端cookie信息$limit_rate#这个变量可以限制连接速率。
query_string#与$query_string#与$args相同。
request_body_file#客户端请求主体信息的临时文件名。$request_body_file#客户端请求主体信息的临时文件名。$request_method#客户端请求的动作，通常为GET或POST。
remote_addr#客户端的IP地址。$remote_addr#客户端的IP地址。$remote_port#客户端的端口。
remote_user#已经经过Auth Basic Module验证的用户名。$remote_user#已经经过Auth Basic Module验证的用户名。$request_completion#如果请求结束，设置为OK. 当请求未结束或如果该请求不是请求链串的最后一个时，为空(Empty)。
request_method#GET或POST$request_method#GET或POST$request_filename#当前请求的文件路径，由root或alias指令与URI请求生成。
request_uri#包含请求参数的原始URI，不包含主机名，如：”/foo/bar.php?arg=baz”。不能修改。$request_uri#包含请求参数的原始URI，不包含主机名，如：”/foo/bar.php?arg=baz”。不能修改。$scheme#HTTP方法（如http，https）。
server_protocol#请求使用的协议，通常是HTTP/1.0或HTTP/1.1。$server_protocol#请求使用的协议，通常是HTTP/1.0或HTTP/1.1。$server_addr#服务器地址，在完成一次系统调用后可以确定这个值。
server_name#服务器名称。$server_name#服务器名称。$server_port#请求到达服务器的端口号。
uri#不带请求参数的当前URI，$uri#不带请求参数的当前URI，$uri不包含主机名，如”/foo/bar.html”。该值有可能和requesturi不一致。$request_uri 不一致。$request_uri是浏览器发过来的值。该值是rewrite后的值。例如做了internal redirects后。

3.return指令
语法：return code ;使用环境：server,location,if ;
该指令用于结束规则的执行并返回状态码给客户端。
示例：如果访问的URL以”.sh”或”.bash”结尾，则返回403状态码
location ~ .*.(sh|bash)?$
{
return 403;
}

 4.rewrite 指令

语法：rewrite regex replacement flag
默认值：none ; 使用环境：server,location,if
该指令根据表达式来重定向URI，或者修改字符串。指令根据配置文件中的顺序来执行。注意重写表达式只对相对路径有效。If you want to pair hostnames, you should use if statement, example is as follows:
if( host ?www.(.?))set$hostwithoutwww$1;rewrite(.?)$http://$hostwithoutwww$1permanent;rewrite指令的最后一项参数为flag标记，支持flag标记有：1.last相when inapache ri noodles of [L]mark Memory, Tableshowrewri te.2.break本 strip regulations thenPImatchfinish After becoming ,Endstop Pimatch , no againpi withafter Noodles of regulations then .3.redirect BackBack 302prowhenheavy Ding to , browse browseware address willshowshow jumpturn After of URL 地address .4 BackBack 301永久重 SET to , browsebrowse 地 Addresswillshowshow jumpturn After of URL Address .make with last and br eakrealnowURI Heavy Write, BrowseView ware地 AddressbarNo changes.andandtwo 人have ThinMicroDifferenceDon’t , make refers to with alias ordermust must use last marknote ;make with prox yp ass refers toorder when, need wantmakeuse break marknote.Lastmarknote 在本 barrewriteregulations hold OKfinished After , will to its 在at server……mark Sign HeavyNewFatUp pleaseplease , and break marknote thenin本 stripsregulationsrulespi withEnd into after , Endstop Pimatch.一likein Follow loc ation中(loc atio n/…) or Directpick up inservermark Sign中 EditedWrittenrewri teregulation then, recommendedrecommended use lastmarknote ; at nonrootlocat ion中 (location/ cms/ …), then use brea k.such asfruitURI 中containing There areginsengcount( /app /test.php?id =5) , silent recognize情 conditiondown ginsengcountwill was from MoveAttachAdd to substitutechange skewers on, Youcan passed through 替换串的末尾加上?标记来解决这一问题。例如：rewrite/test(.?)$host ~* www.(.*) ) { set $host_without_www $1; rewrite ^(.*)$ http://$host_without_www$1 permanent; } rewrite指令的最后一项参数为flag标记，支持flag标记有： 1.last 相当于apache里面的[L]标记，表示rewrite。 2.break本条规则匹配完成后，终止匹配，不再匹配后面的规则。 3.redirect 返回302临时重定向，浏览器地址会显示跳转后的URL地址。 4.permanent 返回301永久重定向， 浏览器地址会显示跳转后的URL地址。 使用last和break实现URI重写，浏览器地址栏不变。而且两者有细微差别，使用alias指令必须用last标记;使用proxy_pass指令时，需要使用break标记。Last标记在本条rewrite规则执行完毕后，会对其所在server{……}标签重新发起请求，而break标记则在本条规则匹配完成后，终止匹配。 一般在跟location中(location /{…})或直接在server标签中编写rewrite规则，推荐使用last标记；在非根location中(location /cms/{…})，则使用break。 如果URI中含有参数(/app/test.php?id=5)，默认情况下参数会被自动附加到替换串上，你可以通过在替换串的末尾加上?标记来解决这一问题。 例如： rewrite ^/test(.*)$ http://www.tiyee.net/home permanent;

访问http://www.tiyee.net/test?id=5 会跳转到 http://www.tiyee.net/home?id=5
例如：如果我们将类似URL /photo/123456 重定向到 /path/to/photo/12/1234/123456.png
Rewrite “/photo/([0-9]{2})([0-9]{2})([0-9]{2})” /path/to/photo/1/$1/$12/$2/$12$2$3.png ;

   注：如果正则表达式里面有花括号"{"或"}" ，应该使用双引号或单引号。

5.Set指令
语法：set variable value ; 默认值:none ; 使用环境：server,location,if;
该指令用于定义一个变量，并给变量赋值。变量的值可以为文本、变量以及文本变量的联合。
示例：set $varname “hello world”;
6.Uninitialized_variable_warn指令
语法：uninitialized_variable_warn on|off
使用环境：http,server,location,if
该指令用于开启和关闭未初始化变量的警告信息，默认值为开启。

Nginx的Rewrite规则编写实例
1.当访问的文件和目录不存在时，重定向到某个php文件
if( !-e request_filename )  
{  
rewrite ^/(.*)$request_filename ) { rewrite ^/(.*)$ index.php last;
}

2.目录对换 /123456/xxxx ====> /xxxx?id=123456
rewrite ^/(\d+)/(.+)/ /2?id=$2?id=$1 last;

3.如果客户端使用的是IE浏览器，则重定向到/ie目录下
if( http_user_agent  ~ MSIE)  
{  
rewrite ^(.*)$http_user_agent ~ MSIE) { rewrite ^(.*)$ /ie/$1 break;
}

4.禁止访问多个目录
location ~ ^/(cron|templates)/
{
deny all;
break;
}

5.禁止访问以/data开头的文件
location ~ ^/data
{
deny all;
}

6.禁止访问以.sh,.flv,.mp3为文件后缀名的文件
location ~ .*.(sh|flv|mp3)$
{
return 403;
}

7.设置某些类型文件的浏览器缓存时间
location ~ .*.(gif|jpg|jpeg|png|bmp|swf)expires30d;location .?.(js|css)${ expires 30d; } location ~ .*.(js|css)$
{
expires 1h;
}

8.给favicon.ico和robots.txt设置过期时间;
这里为favicon.ico为99天,robots.txt为7天并不记录404错误日志
location ~(favicon.ico) {

log_not_found off;

expires 99d;

break;

}
location ~(robots.txt) {

log_not_found off;

expires 7d;

break;

}
9.设定某个文件的过期时间;这里为600秒，并不记录访问日志
location ^~ /html/scripts/loadhead_1.js {

access_log off;

root /opt/lampp/htdocs/web;

expires 600;

break;

}

10.文件反盗链并设置过期时间
这里的return 412 为自定义的http状态码，默认为403，方便找出正确的盗链的请求
“rewrite ^/ http://img.tiyee.net/leech.gif;”显示一张防盗链图片
“access_log off;”不记录访问日志，减轻压力
“expires 3d”所有文件3天的浏览器缓存
location ~* ^.+.(jpg|jpeg|gif|png|swf|rar|zip|css|js)$ {

valid_referers none blocked .c1gstudio.com .c1gstudio.net localhost 208.97.167.194;

if ($invalid_referer) {

rewrite ^/ http://img.tiyee.net/leech.gif;

return 412;

break;

}

access_log off;

root /opt/lampp/htdocs/web;

expires 3d;

break;

}

11.只充许固定ip访问网站，并加上密码
root /opt/htdocs/www;

allow 208.97.167.194;

allow 222.33.1.2;

allow 231.152.49.4;

deny all;

auth_basic “C1G_ADMIN”;

auth_basic_user_file htpasswd;

12将多级目录下的文件转成一个文件，增强seo效果
/job-123-456-789.html 指向/job/123/456/789.html
rewrite ^/job-([0-9]+)-([0-9]+)-([0-9]+).html/job/$/job/$1/2/jobshow_$2/jobshow_$3.html last;

13.将根目录下某个文件夹指向2级目录
如/shanghaijob/ 指向 /area/shanghai/
如果你将last改成permanent，那么浏览器地址栏显是/location/shanghai/
rewrite ^/([0-9a-z]+)job/(.*)/area/$/area/$1/$2 last;

上面例子有个问题是访问/shanghai 时将不会匹配
rewrite ^/([0-9a-z]+)job/area/$/area/$1/ last;

rewrite ^/([0-9a-z]+)job/(.*)/area/$/area/$1/$2 last;

这样/shanghai 也可以访问了，但页面中的相对链接无法使用，