Nginx：URL重写（示意图+举例+配置讲解）

示意图：

URL Rewrite

URL Rewrite 是一种用于修改网站 URL 结构或改变 URL 路径的技术。它允许网站管理员修改 URL 的外观，使其更加友好、可读，并且有助于改善网站的搜索引擎优化（SEO）。通过 URL Rewrite，网站管理员可以通过在 Web 服务器上配置规则来重写传入的 URL。

举例：

原始URL：https://www.example.com/product.php?id=123

重写后：https://www.example.com/products/123

Nginx的URl Rewrite

Nginx自然也有URI Rewrite功能，可以在配置中实现。

举例：发送请求http://www.example.com/api/1.html，重写并转发到/v1/index.jsp?pageNum=1

location /api {
    rewrite ^/api/([0-9]+).html$ /v1/index?pageNum=$1 break;
    proxy_pass http://backend_server;
}

讲解：

• ^/api/([0-9]+).html$是一个正则表达式。匹配/api/开头、结尾为.html的请求，并使用([0-9]+)为捕获组，表示可以匹配任意数字任意次数，并提取为变量＄1的值。
• /v1/index?pageNum=$1是重写后的路径，＄1是一个变量，它表示在正则表达式中第一个捕获的内容。
• break是rewrite指令的标志之一，代表本条规则匹配完成即终止，不再匹配后面的任何规则。

配置属性

rewrite格式：

rewrite <正则表达式> <替换内容> [flag];

• 正则表达式：使用正则表达式语句，匹配需要重写的 URL。
• 替代内容：将正则匹配的内容替换成replacement，可以使用捕获组中的内容以及其他自定义的字符串。
• flag（可选）：标志，用于控制重写行为。
  • last：在执行完当前 rewrite 规则后，继续匹配其他的 location 指令。（即当前location块只进行重写操作，需要继续匹配location才能完整地处理请求。）
  • break：在执行完当前 rewrite 规则后，不再继续匹配其他的 location 指令。（即当前location块即可完整地处理请求。）
  • redirect：返回临时重定向，返回 302 Found 状态码。
  • permanent：返回永久重定向，返回 301 Moved Permanently 状态码。
  • if（不推荐使用）：允许使用条件语句进行重写规则。