Nginx 学习总结(4)—— Rewrite 模块

这是 Nginx 学习总结的第四篇,上一篇介绍到了 Nginx 学习总结(3) —— Location 模块,这一篇会对Rewrite模块 做一些总结。根据官方文档说明,Rewrite 模块是用于使用 PCRE 正则表达式更改请求 URI,有条件地选择配置,并返回重定向。

表面看,rewritelocation 的功能有点像,都能实现跳转,然而它们的区别在于:rewrite 是在同一域名内更改获取资源的路径,而 location 是对一类路径做控制访问或反向代理,并且可以 proxy_pass 到其他机器。

很多情况下 rewrite 也会写在 location 里,它们的执行顺序是:

  1. 执行 server 块的 rewrite 指令;
  2. 执行 location 匹配;
  3. 执行选定的 location 中的 rewrite 指令。
如果其中某步 URI 被重写,则重新循环执行1-3,直到找到真实存在的文件;循环超过10次,则返回 500 Internal Server Error 错误。

指令

1. break

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

Context: server, location, if
server {
    listen 80;
    
    # 此处 break 会停止执行 server 块的 return 指令(return 指令属于rewrite模块)
    # 如果把它注释掉 则所有请求进来都返回 ok 字符串
    break;
    return 200 "ok";
    
    location = / {
        root   /usr/share/nginx/html;
        index  index.php index.html index.htm;
    }
}

2. if

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

Context: server, location

if 中的几种判断条件:

  • 一个变量名,如果变量 $variable 的值为空字符串或者字符串 "0",则为 false
  • 变量与一个字符串的比较,相等为 = 不相等为 !=
  • 变量与一个正则表达式的模式匹配,操作符可以是:~ 区分大小写的正则匹配; ~* 不区分大小写的正则匹配, !~!~* 前面两者的非;
  • 检测文件是否存在,使用 -f (存在) 和 !-f (不存在);
  • 检测路径是否存在,使用 -d (存在) 和 !-d (不存在) 后面判断可以是字符串也可是变量;
  • 检测文件、路径、或者链接文件是否存在,使用 -e (存在) 和 !-e (不存在) ,后面判断可以是字符串也可是变量;
  • 检测文件是否为可执行文件,使用 -x (可执行) 和 !-x (不可执行),后面判断可以是字符串也可是变量。

可以用作 if 判断的全局变量:

  • $args 这个变量等于请求行中的参数,同 $query_string
  • $content_length 请求头中的 Content-length 字段
  • $content_type 请求头中的 Content-Type 字段
  • $document_root 当前请求在 root 指令中指定的值
  • $host 请求主机头字段,否则为服务器名称
  • $http_user_agent 客户端 agent 信息
  • $http_cooki 客户端 cookie 信息
  • $limit_rate 这个变量可以限制连接速率
  • $request_method 客户端请求的动作,通常为 GETPOST
  • $remote_addr 客户端的 IP 地址
  • $remote_port 客户端的端口
  • $remote_user 已经经过 Auth Basic Module 验证的用户名
  • $request_filename 当前请求的文件路径,由 rootalias 指令与 URI 请求生成
  • $scheme 请求协议,如 http,https
  • $server_protocol 请求客户端协议,通常是 HTTP/1.0HTTP/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 相同
set $variable "0"; 
if ($variable) {
    # 不会执行,因为 "0" 为 false
    break;            
}

# 变量与一个字符串的比较
if ($request_method = POST) {
    return 405;
}

# 变量与正则表达式的匹配
if ($http_cookie ~* "id=([^;]+)(?:;|$)") {
    set $id $1;
}
if ($http_user_agent ~ MSIE) {
    rewrite ^(.*)$ /msie/$1 break;
}

# 检查文件是否存在,字符串与变量均可
if ( !-f "/data.log" ) {
    break;            
}
if ( !-f $filename ) {
    break;            
}
if 关键字后必须加一个空格符

3. return

停止处理并将指定的 code 码返回给客户端。 从 0.8.42 版本开始, return 语句可以指定重定向 URL (状态码可以为如下几种 301,302,303,307),也可以为其他状态码指定响应的文本内容,并且重定向的 URL 和响应的文本可以包含变量。

Context: server, location, if
# return code [text];
location = /ok {
    return 200 "ok"; # 返回 ok 给客户端
}

# return code URL; 
location = /redirect {
    return 302 http://www.baidu.com; # 临时重定向
}

# return URL;
location = /redirect {
    return http://www.baidu.com; # 临时重定向
}

4. rewrite

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

Context: server, location, if
# 第一种情况,带 http://
location / {
    rewrite /test1/(.*) http://www.$1.com;
    return 200 "ok";
}
# 在浏览器中访问,被临时重定向到 www.baidu.com
# 后面的 return 指令将没有机会执行了


# 第二种情况,不带 http://
location / {
    rewrite /test1/(.*) www.$1.com;
    return 200 "ok";
}
# 在浏览器中访问,返回了 ok

rewrite 的四个 flag

  • last 停止处理当前的 ngx_http_rewrite_module 的指令集,并开始搜索与更改后的 URL 相匹配的 location;
  • break 停止处理当前的 ngx_http_rewrite_module 指令集;
  • redirect 返回 302 临时重定向;
  • permanent 返回 301 永久重定向。
location / {
    # 顺序执行如下两条 rewrite 指令 
    # rewrite 后面没有任何 flag 时就顺序执行 
    # 当 location 中没有 rewrite 模块指令可被执行时,就重写发起新一轮 location 匹配
    rewrite ^/test1 /test2;
    rewrite ^/test2 /test3;  # 此处发起新一轮location匹配,重写后的 url 为 /test3
}

location = /test2 {
    return 200 "/test2";
}  
location = /test3 {
    return 200 "/test3";
}

# 发送如下请求
# curl 127.0.0.1:8080/test1
# /test3
location / {
    rewrite ^/test1 /test2;
    rewrite ^/test2 /test3 last;  # 此处发起新一轮 location 匹配,重写后的 url 为 /test3
    rewrite ^/test3 /test4;
}

location = /test2 {
    return 200 "/test2";
}  
location = /test3 {
    return 200 "/test3";
}
location = /test4 {
    return 200 "/test4";
}

# 发送如下请求
# curl 127.0.0.1:8080/test1
# /test3 
location / {
    rewrite ^/test1 /test2;
    rewrite ^/test2 /more/index.html break;  # 终止执行后续 rewrite 模块指令,重写后的 url 为 /more/index.html
    rewrite /more/index.html /test4;
    proxy_pass https://www.baidu.com; # 因为 proxy_pass 不是 rewrite 模块的指令,所以它不会被 break 终止
}

# 发送如下请求
# curl 127.0.0.1:8080/test1 
# 代理到 百度产品大全页面: https://www.baidu.com/more/index.html;

5. rewrite_log

开启或者关闭 rewrite 模块指令的执行日志,如果开启,则记录下 notice 级别的日志到 error_log 中,默认为关闭 off

Context: http, server, location, if

6. 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

参考文章:

  1. 搞懂 nginx 的 rewrite 模块
  2. nginx 配置 location 总结及 rewrite 规则写法
  3. Module ngx_http_rewrite_module

PHP 学习总结
研读官网文档和网络优秀个人文章,对 PHP 编程相关作出学习总结。

Stay hungry, stay foolish.

846 声望
84 粉丝
0 条评论
推荐阅读
PHP 微服务集群搭建
微服务架构是一种架构模式,它提倡将单一应用程序划分成一组小的服务,服务之间相互协调、互相配合,为用户提供最终价值。每个服务运行在其独立的进程中,服务和服务之间采用轻量级的通信机制相互沟通。每个服务...

Jochen112阅读 14.2k评论 6

如何选择适合你的微服务 API 网关:对比 Kong、APISIX、Tyk、Apigee 和其他网关
API 网关并非一个新兴的概念,在十几年前就已经存在了,它的作用主要是作为流量的入口,统一的处理和业务相关的请求,让请求更加安全、快速和准确的得到处理。它有以下传统的功能:

API7_技术团队8阅读 8.6k评论 2

有了 NGINX 和 Kong,为什么还需要 Apache APISIX?
2021 年 5 月,云原生社区技术沙龙·广州站,API7.ai(支流科技)联合创始人 & CTO,Apache APISIX PMC 王院生在活动上做了《有了 NGINX 和 Kong,为什么还需要 Apache APISIX》的分享,以下是现场分享的文字版。...

API7_技术团队1阅读 4.2k

Nginx 配置常用参数,看这一篇就够了
最近在全面学习Nginx,当作笔记了,如有错误,欢迎指出或深入交流。主模块 {代码...} 事件模块 {代码...} http部分 {代码...} 部分参数详细说明server_name {代码...} location {代码...} location表达式类型 {代...

开源到2阅读 1.9k

化虹为桥 - Nginx 如何代理 UDP “连接”
众所周知,UDP 并不像 TCP 那样是基于连接的。但有些时候,我们需要往一个固定的地址发送多个 UDP 来完成一个 UDP 请求。为了保证服务端能够知道这几个 UDP 包构成同一个会话,我们需要在发送 UDP 包时绑定某个端...

spacewander4阅读 1.6k

Nginx unexpected end of file 配置证书遇到问题,如何解决?
通过 letsencrypt 申请证书后,默认服务器安装了 Nginx 1.8 发现,在默认的 /etc/nginx/sites-enabled/default 内容配置 SSL 的 site.com.key 后。重启 Nginx 出现一下错误:

程序员泥瓦匠1阅读 1.2k

mac M1 nginx配置文件位置
mac nginx配置的原位置/usr/local/etc/nginx/nginx.confmac M1 nginx配置位置/usr/local/Homebrew/etc/nginx/nginx.confnginx -t 查看位置

寿兽阅读 3k

Stay hungry, stay foolish.

846 声望
84 粉丝
宣传栏