nginx-rewrite

一、ngx_http_rewrite_module

rewrite模块即ngx_http_rewrite_module模块，主要功能是改写请求URI，是Nginx默认安装的模块。

rewrite模块会根据PCRE正则匹配重写URI，或者直接返回资源（200|404），或者发起内部跳转再匹配location，或者直接做30x重定向返回客户端。

ngx_http_rewrite_module模块的指令有break, if, return, rewrite, set。

二、rewrite语法

1
2
3

rewrite    <regex>    <replacement>     [flag]       
# 关键字     正则       替代内容         flag标记
# 可以在server, location, if

flag标记说明：
- last #本条规则匹配完成后，继续向下匹配新的location URI规则
  - 跳转的总次数不能超过10次
- break #本条规则匹配完成即终止，不再匹配后面的任何规则。
  - 停止处理当前的ngx_http_rewrite_module指令集
  - 如果break在location内，则在该location内继续进一步处理该请求
  - 请求内容存在，返回200；请求内容不存在，则返回404
- redirect #返回302临时重定向，浏览器地址会显示跳转后的URL地址
- permanent #返回301永久重定向，浏览器地址栏会显示跳转后的URL地址

rewrite ^/(.*) http://www.czlun.com/$1 permanent;
# regex部分是 ^/(.*) ，这是一个正则表达式，匹配完整的域名和后面的路径地址
# replacement部分是http://www.czlun.com/$1，$1是取自regex部分()里的内容。匹配成功后跳转到的URL。
# flag部分 permanent表示永久301重定向标记，即跳转到新的 http://www.czlun.com/$1 地址上

rewrite /test/.* /index.html break;

location /test/ { return 508;}  

location /break/ {  
    rewrite ^/break/(.*) /test/$1 break;
    return 402;
}

location /last/ {  
    rewrite ^/last/(.*) /test/$1 last;
    return 403;
}

# 请求1： http://test.com/break/index.php   返回：404 
# 请求2： http://test.com/last/index.php    返回：508 
# 请求3： http://test.com/test/index.php    返回：200 (返回index.html) 
# 当请求break时，如匹配内容存在的话，可以直接请求成功，返回200；而如果请求内容不存在，则返回404
# 当请求为last的时候，会对重写的新uri重新发起请求，只是重新查找location匹配，如请求2返回508

注：

rewrite只能对域名后边的除去传递的参数外的字符串起作用
如果replacement以http://, https://, or $scheme开头，处理将会终止，请求结果会以重定向的形式返回给客户端
如果replacement字符串里有新的request参数，那么之前的参数会附加到其后面，如果要避免这种情况，那就在replacement字符串后面加上？
如果正则表达式（regex）里包含} or ;字符，需要用单引号或者双引号把正则表达式引起来

三、return语法

1 2	return code [text] \| code URL \| URL; # 可以在server, location, if

停止任何的进一步处理，并且将指定状态码返回给客户端

return的参数有四种形式：

return code 此时，响应内容就是nginx所默认的，比如503 Service Temporarily Unavailable
return code text 因为要带响应内容，因此code不能是具有跳转功能的30x
return code URL 此时URI可以为URI做内部跳转，也可以是具有http://或者https://等协议的绝对URL，直接返回客户端，而code是30x
return URL 此时code默认为302，而URL必须是带http://等协议的绝对URL

四、`PCRE正则`表达式

字符	描述
\	转义字符。如“\n”匹配一个换行符
^	匹配输入字符串的起始位置
$	匹配输入字符串的结束位置
*	匹配前面的字符零次或多次。如“ol*”能匹配“o”及“ol”、“oll”
+	匹配前面的字符一次或多次。如“ol+”能匹配“ol”及“oll”、“oll”，但不能匹配“o”
?	匹配前面的字符零次或一次，例如“do(es)?”能匹配“do”或者“does”，”?”等效于”{0,1}”
.	匹配除“\n”之外的任何单个字符。若要匹配包括“\n”在内的任意字符，请使用诸如“[.\n]”之类的模式。
(pattern)	匹配括号内pattern并可以在后面获取对应的匹配。常用$0…$9属性获取小括号中的匹配内容，要匹配圆括号字符需要(Content)

server {
    listen 80;
    server_name abc.com www.abc.com;
    if ( $host != 'www.abc.com'  ) {
        rewrite ^/(.*) http://www.abc.com/$1 permanent;
    }
    location / {
        root /data/www/www;
        index index.html index.htm;
    }
    error_log  logs/error_www.abc.com.log  error;
    access_log  logs/access_www.abc.com.log  main;
}

五、逻辑判断

操作符	含义
=，!=	比较的一个变量和字符串。
~，~*	与正则表达式匹配的变量，如果这个正则表达式中包含 }，; 则整个表达式需要用“或’包围。
-f，!-f	检查一个文件是否存在。
-d，!-d	检查一个目录是否存在。
-e，!-e	检查一个文件、目录、符号链接是否存在。
-x，!-x	检查一个文件是否可执行。

六、常用变量

变量	含义
$args	这个变量等于请求行中的参数，同$query_string
$content_length	请求头中的Content-length字段。
$content_type	请求头中的Content-Type字段。
$document_root	当前请求在root指令中指定的值。
$host	请求主机头字段，否则为服务器名称。
$http_user_agent	客户端agent信息
$http_cookie	客户端cookie信息
$limit_rate	这个变量可以限制连接速率。
$request_method	客户端请求的动作，通常为GET或POST。
$remote_addr	客户端的IP地址。
$remote_port	客户端的端口。
$remote_user	已经经过Auth Basic Module验证的用户名。
$request_filename	当前请求的文件路径，由root或alias指令与URI请求生成。
$scheme	HTTP方法（如http，https）。
$server_protocol	请求使用的协议，通常是HTTP/1.0或HTTP/1.1。
$server_addr	服务器地址，在完成一次系统调用后可以确定这个值。
$server_name	服务器名称。
$server_port	请求到达服务器的端口号。
$request_uri	包含请求参数的原始URI，不包含主机名，如”/foo/bar.php?arg=baz”。
$uri	不带请求参数的当前URI，$uri不包含主机名，如”/foo/bar.html”。
$document_uri	与$uri相同。

# 限制浏览器访问
if ($http_user_agent ~ Firefox) {   
    rewrite ^(.*)$ /firefox/$1 break;   
}

if ($http_user_agent ~ MSIE) {   
    rewrite ^(.*)$ /msie/$1 break;   
}      

if ($http_user_agent ~ Chrome) {   
    rewrite ^(.*)$ /chrome/$1 break;   
}  

# 限制IP访问  
if  ($remote_addr = 192.168.197.142) {  
    return 403;  
}

# set指令是设置变量用的,可以用来达到多条件判断时作标志用
# 判断IE并重写,且不用break;我们用set变量来达到目的
if ($http_user_agent ~* msie) {  
    set $isie 1;  
}

if ($fastcgi_script_name = ie.html) {  
    set $isie 0;  
}  
		  
if ($isie 1) {  
    rewrite ^.*$ ie.html;  
}