Nginx 中如何利用正则表达式捕获路径参数-Nginx-PHP中文网

nginx location 支持正则捕获，需用 ~ 或 ~* 启用，捕获组 $1、$2 或命名捕获 $name 仅在当前 location 内有效，可用于 rewrite、proxy_pass 等指令，但不可跨块或 if 外引用。

nginx 中如何利用正则表达式捕获路径参数

Nginx 支持在 location 指令中使用正则表达式，并通过捕获组（capture groups）提取路径中的动态参数，再在后续指令（如 rewrite、proxy_pass 或变量引用）中复用。关键在于正确书写带括号的正则、理解捕获变量命名规则，并注意作用域限制。

location 中用 ~* 或 ~ 定义正则匹配

必须使用带波浪线的修饰符启用正则匹配：~（区分大小写）或 ~*（不区分大小写）。普通前缀匹配（location /api/）不支持捕获。

location ~ ^/user/(\d+)/profile$ { ... } —— 匹配 /user/123/profile，$1 值为 123
location ~* ^/product/([a-z0-9\-]+)/(\d+)$ { ... } —— 不区分大小写，捕获两段，分别存为 $1 和 $2
注意：正则匹配优先级高于前缀匹配，但低于精确匹配（=），且同级中按配置顺序生效

捕获变量 $1、$2 … 只在当前 location 内有效

正则括号内的内容会按从左到右顺序赋值给、等变量，但这些变量仅在该 location 块内可用，不能跨块传递。

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

可在 rewrite 中重写 URL：rewrite ^/post/(\d+) /blog?id=$1 last;
可在 proxy_pass 中拼接后端地址：proxy_pass http://backend/api/v1/user/$1;
不可在 if 外部直接引用（if 内部也受限，建议避免嵌套 if）

命名捕获（Nginx 1.11.2+）更清晰易读

支持 (?<name>...)</name> 语法，用 $name 引用，提升可维护性：

location ~ ^/api/(?<version>v\d+)/(?<resource>\w+)/(?<id>\d+)$ {</id></resource></version>
后续可用 $version、$resource、$id，比如：proxy_pass http://api/$version/$resource/$id;
命名捕获与数字捕获可混用，但推荐统一用命名方式减少出错

实际配置示例：RESTful 路由转发

将 /api/v2/users/456 映射到后端 http://internal/users/456?version=v2：

location ~ ^/api/(?<ver>v\d+)/(?<res>\w+)/(?<uid>\d+)$ {
    proxy_set_header Host $host;
    proxy_pass http://backend/$res/$uid?version=$ver;
}</uid></res></ver>

注意：proxy_pass 若含 URI 部分（如 /users/$uid），会替换整个原始路径；若只写上游地址（如 http://backend），则自动透传原始 URI。