nginx rewrite

做运维最基本的要掌握LNMP环境，其中nginx rewrite必须要会，因为开发那边可能会让你写一些伪静态，301跳转之类的，现在总结下nginx重写的一些规则和用法：

nginx通过ngx_http_rewrite_module模块支持url重写、支持if条件判断，但不支持else。该模块需要PCRE支持，应在编译nginx时指定PCRE源码目录,nginx安装方法。

nginx rewrite指令执行顺序：

1.执行server块的rewrite指令(这里的块指的是server关键字后{}包围的区域，其它xx块类似)
2.执行location匹配
3.执行选定的location中的rewrite指令
如果其中某步URI被重写，则重新循环执行1-3，直到找到真实存在的文件
如果循环超过10次，则返回500 Internal Server Error错误

break指令

语法：break;
默认值：无
作用域：server,location,if

停止执行当前虚拟主机的后续rewrite指令集
break指令实例：

 if ($slow) {
     limit_rate 10k;
     break;
 }

if指令

语法：if(condition){…}
默认值：无
作用域：server,location
对给定的条件condition进行判断。如果为真，大括号内的rewrite指令将被执行。
if条件(conditon)可以是如下任何内容:

• 一个变量名；false如果这个变量是空字符串或者以0开始的字符串；
• 使用= ,!= 比较的一个变量和字符串
• 是用~， ~*与正则表达式匹配的变量，如果这个正则表达式中包含}，;则整个表达式需要用” 或’ 包围
• 使用-f ，!-f 检查一个文件是否存在
• 使用-d, !-d 检查一个目录是否存在
• 使用-e ，!-e 检查一个文件、目录、符号链接是否存在
• 使用-x ， !-x 检查一个文件是否可执行

if指令实例

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

 if ($http_cookie ~* "id=([^;]+)(?:;|$)") {
     set $id $1;
 }

 if ($request_method = POST) {
     return 405;
 }

 if ($slow) {
     limit_rate 10k;
 }

 if ($invalid_referer) {
     return 403;
 }

return指令

语法：return code;

return code URL;

return URL;
默认值：无
作用域：server,location,if

停止处理并返回指定状态码(code)给客户端。
非标准状态码444表示关闭连接且不给客户端发响应头。
从0.8.42版本起，return 支持响应URL重定向(对于301，302，303，307），或者文本响应(对于其他状态码).
对于文本或者URL重定向可以包含变量

rewrite指令

语法：rewrite regex replacement [flag];
默认值：无
作用域：server,location,if
如果一个URI匹配指定的正则表达式regex，URI就按照replacement重写。
rewrite按配置文件中出现的顺序执行。flags标志可以停止继续处理。
如果replacement以”http://”或”https://”开始，将不再继续处理，这个重定向将返回给客户端。
flag可以是如下参数
last 停止处理后续rewrite指令集，然后对当前重写的新URI在rewrite指令集上重新查找。
break 停止处理后续rewrite指令集，并不在重新查找,但是当前location内剩余非rewrite语句和location外的的非rewrite语句可以执行。
redirect 如果replacement不是以http:// 或https://开始，返回302临时重定向
permant 返回301永久重定向
最终完整的重定向URL包括请求scheme(http://,https://等),请求的server_name_in_redirect和 port_in_redirec三部分 ，说白了也就是http协议 域名 端口三部分组成。

rewrite实例

 server {
     ...
     rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 last;
     rewrite ^(/download/.*)/audio/(.*)\..*$ $1/mp3/$2.ra last;
     return 403;
     ...
 }

如果这些rewrite放到 “/download/” location如下所示, 那么应使用break而不是last , 使用last将循环10次匹配，然后返回 500错误:

 location /download/ {
     rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 break;
     rewrite ^(/download/.*)/audio/(.*)\..*$ $1/mp3/$2.ra break;
     return 403;
 }

对于重写后的URL（replacement）包含原请求的请求参数，原URL的?后的内容。如果不想带原请求的参数 ，可以在replacement后加一个问号。如下，我们加了一个自定义的参数user=$1,然后在结尾处放了一个问号?,把原请的参数去掉。

rewrite ^/users/(.*)$ /show?user=$1? last;

如果正则表达regex式中包含 “}” 或 “;”, 那么整个表达式需要用双引号或单引号包围.

常用的rewrite:

rewrite ^/baidu/ http://hao.test.com last;

rewrite ^/tjclick/ /index.php?op=tjclick last;

rewrite ^/rand\.html /rand.php last;

rewrite ^/xx/12121/ http://flash.test.com/test/123.html break;

rewrite_log指令

语法：rewrite_log on|off;
默认值：rewrite_log off;
作用域：http,server,location,if
开启或关闭以notice级别打印rewrite处理日志到error log文件。

nginx打开rewrite log例子

rewrite_log on;
error_log logs/xxx.error.log notice;

1.打开rewrite on
2.把error log的级别调整到 notice

set指令

语法：set variable value;
默认值：none
作用域：server,location,if
定义一个变量并赋值，值可以是文本，变量或者文本变量混合体。

uninitialized_variable_warn指令

语法：uninitialized_variable_warn on | off;
默认值：uninitialized_variable_warn on
作用域：http,server,location,if

控制是否输出为初始化的变量到日志

以上讲述了基本指令的使用，rewrite还有一些特殊用法，有些需求是域名不变的情况下跳转，例如：

域名www.test.com/zhao 需要跳转到 zhaoht.test.com/index.php?x=zhao,但是要保证跳转后域名显示www.test.com/zhao不变，但是实际访问的是跳转到zhaoht.test.com/index.php?x=zhao的页面，可以这么实现：

location ^~ /zhao/ {

rewrite ^/zhao/ /index.php?x=zhao  break;

proxy_pass  http://zhaoht.test.com;

}

只能用代理来实现浏览器里面的域名不变，而不是显示zhaoht.test.com这个域名。

2015.06.05更新

要实现部分1-523.html静态页面跳转到原目录下，具体命令如下：

#rewrite ^/mblibao/(.*)\.html$ /mblibao/ permanent;
rewrite ^/mblibao/([0-5])([0-2])([0-3])\.html$ /mblibao/ permanent;
rewrite ^/mblibao/([0-5])([0-1])([0-9])\.html$ /mblibao/ permanent;
rewrite ^/mblibao/([0-4])([0-9])([0-9])\.html$ /mblibao/ permanent;
rewrite ^/mblibao/([0-9])([0-9])\.html$ /mblibao/ permanent;
rewrite ^/mblibao/([0-9])\.html$ /mblibao/ permanent;

第一条可以将mblibao下所有文件跳转到mblibao目录，开始写rewrite有问题，如：

#rewrite ^/mblibao/(.*)  /mblibao/ permanent;

直接这么写会出现报错，显示重定向死循环，后修改成上面的写没问题.

这里补充点正则的相关知识：

“a-z”：匹配所有小写字母字符

“A–Z”：匹配所有大写字母字符

“\d”：匹配1个十进制数字

“\D”：匹配1个非十进制数字

“?”：重复出现0次或者1次

“*”：重复出现0次或者多次

“+”：重复出现1次或者多次

“X{n}”：重复出现n次

“^”：从一行的开始匹配

“$”：从一行的结束开始匹配

rewrite 语法规则：

变量名：
    变量名可以使用”=”或”!=”运算符
     ~  符号表示区分大小写字母匹配
     ~* 符号表示不区分大小写字母匹配
     !~ 和 !~ 与~  !~ 相反
     -f 和 !-f   用来判断文件是否存在
     -d 和 !-d   用来判断目录是否存在
     -e 和 !-e   用来判断文件或目录是否存在
     -x 和 !-x   用来判断文件是否可以执行
      也支持$1到$9位置参数

if指令
规则语法：

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

if (!-f$request_filename){
    rewrite ^/img/(.*)$/site/$host/images/$1 last;
   }

return指令
示例：，如果访问的URL以.sh .bash 结尾，返回状态码403

location ~ .*\.(sh|bash)?$
{
return 403;
       }

rewrite指令

rewrite指令的最后一项参数为flag标记，支持的flag标记主要有以下几种：
last ：相当于Apache里德(L)标记，表示完成rewrite；
break；本条规则匹配完成后，终止匹配，不再匹配后面的规则
redirect：返回302临时重定向，浏览器地址会显示跳转后的URL地址
permanent：返回301永久重定向，浏览器地址栏会显示跳转后的URL地址
last和break用来实现URL重写，浏览器地址栏URL地址不变

实例：将访问/b跳转到/bbs目录上去：

location /b {
        autoindex on;
        alias /usr/local/nginx/html/redhat;
        rewrite ^/b/?$ /bbs permanent;
       }
location /bbs {
            autoindex on;
            alias /usr/local/nginx/html/bbs;
    }

rewrite规则编写实例

1，将原来要访问/b的目录重写为/bbs，核心语句：

rewrite ^/b/?$ /bbs permannet; 

2,根据不同的浏览器将得到不同的结果。

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;
     }