搞懂nginx的rewrite模块-白红宇

搞懂nginx的rewrite模块

阅读量：6389 次

发布时间：2019-06-23

本文共 5498 字，大约阅读时间需要 18 分钟。

之前在配置nginx时，总是遇到rewrite指令的last和break标识的问题，看到的资料大都是last 基本上都用这个 Flag，break 中止 Rewirte，不在继续匹配。看完之后还是有点懵，后来看了下rewrite模块的文档，终于搞懂了，这个模块内容也不是太多，索性整个把这个模块都好好整理下吧

ngx_http_rewrite_module 模块用来使用正则表达式（PCRE）改变请求的URI，返回重定向，并有条件地选择配置。

指令执行顺序

首先顺序执行server块中的rewrite模块指令，得到rewrite后的请求URI

然后循环执行如下指令

> 如果没有遇到中断循环标志，此循环最多执行10次，但是我们可以使用break指令来中断rewrite后的新一轮的循环

(1). 依据rewrite后的请求URI，匹配定义的 location 块

(2). 顺序执行匹配到的 location 中的rewrite模块指令

指令

break

Context: server, location, if

停止执行 ngx_http_rewrite_module 的指令集，但是其他模块指令是不受影响的

例子说明

server {    listen 8080;    # 此处 break 会停止执行 server 块的 return 指令(return 指令属于rewrite模块)    # 如果把它注释掉 则所有请求进来都返回 ok    break;    return 200 "ok";    location = /testbreak {        break;        return 200 $request_uri;        proxy_pass http://127.0.0.1:8080/other;    }    location / {        return 200 $request_uri;    }}# 发送请求如下# curl 127.0.0.1:8080/testbreak# /other# 可以看到 返回 `/other` 而不是 `/testbreak`，说明 `proxy_pass` 指令还是被执行了# 也就是说 其他模块的指令是不会被 break 中断执行的# (proxy_pass是ngx_http_proxy_module的指令)

if

Context: server, location

依据指定的条件决定是否执行 if 块语句中的内容

if 中的几种判断条件

一个变量名，如果变量 $variable 的值为空字符串或者字符串"0"，则为false

变量与一个字符串的比较相等为(=) 不相等为(!=) 注意此处不要把相等当做赋值语句啊

变量与一个正则表达式的模式匹配操作符可以是(~ 区分大小写的正则匹配， ~*不区分大小写的正则匹配， !~ !~*，前面两者的非)

检测文件是否存在使用 -f(存在) 和 !-f(不存在)

检测路径是否存在使用 -d(存在) 和 !-d(不存在) 后面判断可以是字符串也可是变量

检测文件、路径、或者链接文件是否存在使用 -e(存在) 和 !-e(不存在) 后面判断可以是字符串也可是变量

检测文件是否为可执行文件使用 -x(可执行) 和 !-x(不可执行) 后面判断可以是字符串也可是变量

注意上面第1，2，3条被判断的必须是变量， 4, 5, 6, 7则可以是变量也可是字符串

set $variable "0"; if ($variable) {    # 不会执行，因为 "0" 为 false    break;            }# 使用变量与正则表达式匹配 没有问题if ( $http_host ~ "^star\.igrow\.cn$" ) {    break;            }# 字符串与正则表达式匹配 报错if ( "star" ~ "^star\.igrow\.cn$" ) {    break;            }# 检查文件类的 字符串与变量均可if ( !-f "/data.log" ) {    break;            }if ( !-f $filename ) {    break;            }

return

Context: server, location, if

return code [text];return code URL;return URL;

停止处理并将指定的code码返回给客户端。非标准code码 444 关闭连接而不发送响应报头。

从0.8.42版本开始， return 语句可以指定重定向 url (状态码可以为如下几种 301,302,303,307),

也可以为其他状态码指定响应的文本内容，并且重定向的url和响应的文本可以包含变量。

有一种特殊情况，就是重定向的url可以指定为此服务器本地的urI，这样的话，nginx会依据请求的协议$scheme， server_name_in_redirect 和 port_in_redirect自动生成完整的 url （此处要说明的是server_name_in_redirect 和port_in_redirect 指令是表示是否将server块中的 server_name 和 listen 的端口作为redirect用）

# return code [text]; 返回 ok 给客户端location = /ok {    return 200 "ok";}# return code URL; 临时重定向到 百度location = /redirect {    return 302 http://www.baidu.com;}# return URL; 和上面一样 默认也是临时重定向location = /redirect {    return http://www.baidu.com;}

rewrite

Context: server, location, if

rewrite regex replacement [flag];

rewrite 指令是使用指定的正则表达式regex来匹配请求的urI，如果匹配成功，则使用replacement更改URI。rewrite指令按照它们在配置文件中出现的顺序执行。可以使用flag标志来终止指令的进一步处理。如果替换字符串replacement以http：//，https：//或$ scheme开头，则停止处理后续内容，并直接重定向返回给客户端。

第一种情况重写的字符串带http://

location / {    # 当匹配 正则表达式 /test1/(.*)时 请求将被临时重定向到 http://www.$1.com    # 相当于 flag 写为 redirect    rewrite /test1/(.*) http://www.$1.com;    return 200 "ok";}# 在浏览器中输入 127.0.0.1:8080/test1/baidu # 则临时重定向到 www.baidu.com# 后面的 return 指令将没有机会执行了

第二种情况重写的字符串不带http://

location / {    rewrite /test1/(.*) www.$1.com;    return 200 "ok";}# 发送请求如下# curl 127.0.0.1:8080/test1/baidu# ok# 此处没有带http:// 所以只是简单的重写。请求的 uri 由 /test1/baidu 重写为 www.baidu.com# 因为会顺序执行 rewrite 指令 所以 下一步执行 return 指令 响应了 ok

rewrite 的四个 flag

last
停止处理当前的ngx_http_rewrite_module的指令集，并开始搜索与更改后的URI相匹配的location;

break
停止处理当前的ngx_http_rewrite_module指令集，就像上面说的break指令一样;

redirect
返回302临时重定向。

permanent
返回301永久重定向。

# 没有rewrite 后面没有任何 flag 时就顺序执行 # 当 location 中没有 rewrite 模块指令可被执行时 就重写发起新一轮location匹配location / {    # 顺序执行如下两条rewrite指令     rewrite ^/test1 /test2;    rewrite ^/test2 /test3;  # 此处发起新一轮location匹配 uri为/test3}location = /test2 {    return 200 "/test2";}  location = /test3 {    return 200 "/test3";}# 发送如下请求# curl 127.0.0.1:8080/test1# /test3

last 与 break 的区别

last 和 break一样它们都会终止此 location 中其他它rewrite模块指令的执行，
但是 last 立即发起新一轮的 location 匹配而 break 则不会

location / {    rewrite ^/test1 /test2;    rewrite ^/test2 /test3 last;  # 此处发起新一轮location匹配 uri为/test3    rewrite ^/test3 /test4;    proxy_pass http://www.baidu.com;}location = /test2 {    return 200 "/test2";}  location = /test3 {    return 200 "/test3";}location = /test4 {    return 200 "/test4";}# 发送如下请求# curl 127.0.0.1:8080/test1# /test3 当如果将上面的 location / 改成如下代码location / {    rewrite ^/test1 /test2;    # 此处 不会 发起新一轮location匹配；当是会终止执行后续rewrite模块指令 重写后的uri为 /more/index.html    rewrite ^/test2 /more/index.html break;      rewrite /more/index\.html /test4; # 这条指令会被忽略    # 因为 proxy_pass 不是rewrite模块的指令 所以它不会被 break终止    proxy_pass https://www.baidu.com;}# 发送如下请求# 浏览器输入 127.0.0.1:8080/test1 # 代理到 百度产品大全页面 https://www.baidu.com/more/index.html;

友情提醒下

此处提一下在上面的代码中即使将 proxy_pass 放在带有 break 的 rewrite上面它也是会执行的，这就要扯到nginx的执行流程了。大家有兴趣可以了解下。

rewrite 后的请求参数

如果替换字符串replacement包含新的请求参数，则在它们之后附加先前的请求参数。如果你不想要之前的参数，则在替换字符串 replacement 的末尾放置一个问号，避免附加它们。

# 由于最后加了个 ?，原来的请求参数将不会被追加到rewrite之后的url后面 rewrite ^/users/(.*)$ /show?user=$1? last;

rewrite_log

Context: http, server, location, if

开启或者关闭 rewrite模块指令执行的日志，如果开启，则重写将记录下notice 等级的日志到nginx 的 error_log 中，默认为关闭 off

Syntax:    rewrite_log on | off;

set

Context: server, location, if

设置指定变量的值。变量的值可以包含文本，变量或者是它们的组合形式。

location / {    set $var1 "host is ";    set $var2 $host;    set $var3 " uri is $request_uri";    return 200 "response ok $var1$var2$var3";}# 发送如下请求# curl 127.0.0.1:8080/test# response ok host is 127.0.0.1 uri is /test