本教程详细阐述了如何在Nginx中通过rewrite指令，将URL路径（如/shop/product/123）中的特定前缀（/shop）剥离，并将剩余部分作为查询参数（route=/product/123）传递给后端PHP应用（main.php）。文章强调了rewrite指令与try_files的区别，并提供了清晰的配置示例和注意事项，帮助读者实现灵活的URL重写和干净的URL结构。
理解Nginx中的URL重写需求
在现代web应用开发中，为了实现更友好的url结构（clean urls）或支持前端路由，我们经常需要对传入的uri进行处理。一个常见的场景是，应用部署在一个子目录（例如/shop）下，但希望将用户请求的uri（如example.com/shop/product/123）转换为内部处理路径，例如example.com/shop/main.php?route=/product/123，其中/product/123作为route参数传递给php脚本。
直接使用原始的$uri变量会导致整个URI（包括/shop）被传递，这不符合预期。为了实现路径的剥离和参数化，我们需要精确地匹配并捕获URI的特定部分。
try_files与rewrite指令的区别
在Nginx中，try_files和rewrite指令都与URI处理有关，但它们的功能和应用场景有所不同。理解它们的区别是正确配置重写的关键。
try_files指令：主要用于按顺序检查文件或目录是否存在，如果找到则内部重定向到该文件或目录；如果所有检查都失败，则内部重定向到最后一个参数（通常是一个文件或命名location）。它不执行正则表达式匹配和捕获，也不能直接修改URI的查询字符串。例如，try_files $uri $uri/ /index.php?$query_string;。rewrite指令：这是一个更强大的工具，它使用正则表达式匹配URI，并根据匹配结果重写URI。rewrite指令能够捕获正则表达式中的分组，并将这些分组用于构建新的URI，包括修改路径和查询字符串。它通常用于实现复杂的URL转换、SEO友好的URL以及内部路由。
尝试将$1变量与try_files结合使用是无效的，因为$1是rewrite指令中正则表达式捕获组的产物，try_files自身不进行正则表达式匹配和捕获。
使用rewrite指令实现路径剥离与参数传递
要实现将/shop从URI中剥离并传递剩余部分作为route参数，我们应结合location块、try_files（用于静态文件处理）和rewrite指令。
核心思路是：
首先，Nginx尝试查找实际存在的文件或目录。如果找不到，则将请求转发到一个命名location。在该命名location中，使用rewrite指令通过正则表达式匹配并捕获URI中/shop之后的部分。将捕获到的部分作为route参数传递给main.php。
以下是实现这一目标的Nginx配置示例：
server { listen 80; server_name example.com; root /var/www/html; # 你的网站根目录 index index.php index.html index.htm; # PHP-FPM配置，确保Nginx能处理.php文件 location ~ .php$ { try_files $uri =404; fastcgi_pass unix:/var/run/php/php-fpm.sock; # 根据你的PHP-FPM配置调整 fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } # 处理 /shop/ 路径下的请求 location /shop/ { # 1. 尝试查找是否存在匹配的静态文件或目录 # 例如，如果请求是 /shop/image.jpg，且文件存在，则直接返回 # 如果请求是 /shop/static/，且目录存在，则尝试返回其index文件 try_files $uri $uri/ @rewrite_shop; } # 命名location，用于执行URI重写 location @rewrite_shop { # 使用rewrite指令进行路径剥离和参数传递 # ^/shop(/.*) : 匹配以/shop开头，并捕获/shop之后的所有内容到$1 # /shop/main.php?route=$1 : 重写目标，将$1作为route参数 # last : 停止当前location的规则处理，并重新搜索匹配新的URI rewrite ^/shop(/.*) /shop/main.php?route=$1 last; }}
代码解释：
location ~ .php$: 这是一个典型的PHP-FPM配置块，用于处理所有以.php结尾的请求，将它们转发给PHP-FPM处理。location /shop/ { … }: 这个块负责处理所有以/shop/开头的请求。try_files $uri $uri/ @rewrite_shop;: Nginx会首先尝试查找与请求URI匹配的文件（$uri），如果找不到，则尝试查找与请求URI匹配的目录（$uri/）。如果文件和目录都找不到，Nginx会将请求内部重定向到命名location @rewrite_shop。这个步骤确保了如果/shop/目录下有静态资源（如图片、CSS、JS文件），它们会优先被Nginx直接服务，而不是被重写到main.php。location @rewrite_shop { … }: 这是一个命名location，只有当try_files指令无法找到文件或目录时才会被触发。rewrite ^/shop(/.*) /shop/main.php?route=$1 last;: 这是核心的重写规则。^/shop(/.*): 这是一个正则表达式。^: 匹配URI的开头。/shop: 精确匹配字符串/shop。(/.*): 捕获组。它匹配/shop之后的所有字符（包括斜杠），并将其存储在变量$1中。例如，如果URI是/shop/product/123，那么$1的值将是/product/123。/shop/main.php?route=$1: 这是重写的目标URI。Nginx会将原始请求URI重写为这个新的内部URI，并将捕获到的$1作为route参数附加。last: 这是一个rewrite标志。它告诉Nginx停止处理当前的rewrite规则，并用新的URI（/shop/main.php?route=/product/123）重新开始URI匹配过程。这意味着Nginx会再次检查新的URI是否匹配其他location块（例如，location ~ .php$），最终将其转发给PHP-FPM处理。
注意事项与最佳实践
测试配置：在应用任何Nginx配置更改之前，务必使用sudo nginx -t命令检查配置文件的语法错误。重载Nginx：配置验证无误后，使用sudo nginx -s reload命令平滑重载Nginx服务，使新配置生效，而不会中断现有连接。优先级：Nginx的location匹配顺序很重要。精确匹配（=）优先于前缀匹配（^~），前缀匹配优先于正则表达式匹配（~或~*）。确保你的location块以正确的顺序定义，以避免意外的行为。last与break：last标志会停止当前rewrite规则集，并用新的URI重新启动整个URI匹配过程。break标志则停止当前rewrite规则集，但不会重新启动URI匹配过程，而是继续处理当前location块中的其他指令。在本例中，我们需要last以便新的.php URI能被location ~ .php$捕获并处理。性能考量：虽然rewrite指令功能强大，但过度或复杂的正则表达式可能会对性能产生轻微影响。在可能的情况下，优先使用try_files处理静态文件，将rewrite用于真正需要复杂逻辑的场景。
总结
通过Nginx的rewrite指令，我们可以灵活地控制URI的转换，实现复杂的URL重写逻辑。本教程演示了如何结合location、try_files和rewrite指令，有效地剥离URL路径中的特定前缀，并将其余部分作为查询参数传递给后端应用，从而构建出更清晰、更易于维护的URL结构。掌握这些技巧对于Nginx管理员和Web开发者来说至关重要。
以上就是Nginx URI重写：剥离路径前缀并传递参数的教程的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1321684.html
微信扫一扫 
支付宝扫一扫 
![Ubuntu20.04安装详细图文教程（双系统）[通俗易懂]](https://www.chuangxiangniao.com/wp-content/uploads/2025/10/175254145017182.jpg)
![Ubuntu20.04安装详细图文教程（双系统）[通俗易懂]](https://www.chuangxiangniao.com/wp-content/uploads/2025/10/175254145061981.jpg)
![Ubuntu20.04安装详细图文教程（双系统）[通俗易懂]](https://www.chuangxiangniao.com/wp-content/uploads/2025/10/175254145113131.jpg)
![Ubuntu20.04安装详细图文教程（双系统）[通俗易懂]](https://www.chuangxiangniao.com/wp-content/uploads/2025/10/175254145195572.jpg)
