Nginx 伪静态“rewrite”功能详细介绍

nginx通过ngx_http_rewrite_module模块支持url重写、支持条件判断。

该模块需要PCRE支持，应在编译nginx时指定PCRE源码目录。

nginx rewrite指令执行顺序：

     1.执行server作用域中的重写指令

2.执行location匹配

3.执行选定的location中的重写指令

如果其中某步URI被重写，则重新循环执行1-3，直到找到真实存在的文件(如果循环超过10次，则返回500 Internal Server Error错误；

说明：可以server块内抢占式重写后，取得客户端的访问控制权后，利用后面location匹配再次重定向，比如本地缓存区取值，实现中间控制。

语法：break;

默认值：无

作用域：server,location,if

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

break指令实例：

if ($slow) {

limit_rate 10k;

break;

 }

语法：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 code [text];

return code URL;

return URL;

默认值：无

作用域：server,location,if

停止处理并返回指定状态码(code)给客户端。

非标准状态码444表示关闭连接且不给客户端发响应头。

从0.8.42版本起，return 支持响应URL重定向(对于301，302，303，307），或者文本响应(对于其他状态码).

对于文本或者URL重定向可以包含变量

语法：rewrite regex replacement [flag];

默认值：无

作用域：server,location,if

如果一个URI匹配指定的正则表达式regex，URI就按照replacement重写。

rewrite按配置文件中出现的顺序执行。flags标志可以停止继续处理。

如果replacement以"http://"或"https://"开始，将不再继续处理，这个重定向将返回给客户端。

flag可以是如下参数

last 停止处理后续rewrite指令集，然后对当前重写的新URI在rewrite指令集上重新查找。

break 停止处理后续rewrite指令集，并不在重新查找。

redirect 如果replacement不是以http:// 或https://开始，返回302临时重定向

permant 返回301永久重定向

总之，最终完整的重定向URL包括－－－－请求1)scheme(http://,https://等),2)请求的server_name_in_redirect和3) 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_log on|off;

默认值：rewrite_log off;

作用域：http,server,location,if

开启或关闭以notice级别打印rewrite处理日志到error log文件。

语法：set variable value;

默认值：none

作用域：server,location,if

定义一个变量并赋值，值可以是文本，变量或者文本变量混合体。

uninitialized_variable_warn指令

语法：uninitialized_variable_warn on | off;

默认值：uninitialized_variable_warn on

作用域：http,server,location,if

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

声明： 此文观点不代表本站立场；转载须要保留原文链接；版权疑问请联系我们。