Nginx rewrite /api/(.*) /$1 break; 指令详解及示例

Nginx 'rewrite /api/(.*) /$1 break;' 指令详解

在 Nginx 配置文件中，'rewrite /api/(.*) /$1 break;' 指令用于对匹配特定模式的 URL 进行重写。

指令解析:

• rewrite: 表示进行 URL 重写操作。
• /api/(.*): 这是一个正则表达式，表示匹配以 '/api/' 开头的路径，并使用 '(.*)' 捕获之后的所有字符作为参数。
• /$1: 表示将捕获到的第一个参数 (.*) 替换到此处，实现 URL 重写。
• break: 表示重写完成后停止后续 rewrite 模块的处理，并将重写后的 URL 发送到后续流程。

示例：

假设我们有如下请求路径： '/api/user/123'

经过 'rewrite /api/(.*) /$1 break;' 指令处理后，会发生以下变化：

1. 匹配正则表达式： '/api/user/123' 匹配 '/api/(.*)'，并将 'user/123' 捕获为参数。
2. 替换参数： 将捕获到的参数 'user/123' 替换到 '$1'，得到新的路径 '/user/123'。
3. 停止处理： 'break' 指令使得 Nginx 停止后续 rewrite 模块的处理，并将 '/user/123' 发送到后续流程。

总结：

'rewrite /api/(.*) /$1 break;' 指令可以将所有以 '/api/' 开头的请求路径重写为去掉 '/api/' 的路径，并停止后续 rewrite 模块的处理。这在前后端分离、API 接口代理等场景中非常实用。