理解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处理。
- ^/shop(/.*): 这是一个正则表达式。
- rewrite ^/shop(/.*) /shop/main.php?route=$1 last;: 这是核心的重写规则。
注意事项与最佳实践
- 测试配置：在应用任何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开发者来说至关重要。
