在web应用开发中，尤其当使用php-fpm等后端服务时，nginx作为前端代理和web服务器，其uri重写功能至关重要。一个常见的需求是将用户友好的url（如 example.com/shop/product/123）内部重写为带有特定参数的后端脚本调用（如 example.com/shop/main.php?route=/product/123），同时需要精确地剥离url中的特定前缀。
理解 try_files 与 rewrite 在URI重写中的应用
Nginx提供了 try_files 和 rewrite 两个核心指令来实现URI重写。
- try_files 指令：主要用于检查文件或目录是否存在，并根据结果进行内部重定向。它的主要目的是处理静态文件服务或简单的URI回退。例如，try_files $uri $uri/ /index.php?$query_string; 会尝试查找请求的URI对应的文件，如果找不到则尝试查找同名目录下的 index.html，如果仍找不到则内部重定向到 /index.php 并附带原始查询字符串。try_files 不擅长基于正则表达式进行复杂的URI捕获和参数化重写。尝试在 try_files 的最后一个参数中使用 $1 等捕获组变量通常是无效的，因为 $1 需要 rewrite 指令的正则表达式匹配才能生效。
- rewrite 指令：则专为基于正则表达式的复杂URI匹配、捕获和重写而设计。它能够灵活地修改URI路径，提取特定部分作为参数，并指定重写后的行为（如 last、break、redirect、permanent）。
对于本教程所描述的场景，即需要从URI中剥离特定前缀并将其余部分作为参数传递，rewrite 指令是更高效和正确的选择。
核心解决方案：使用 rewrite 指令剥离URI前缀
要实现将 example.com/shop/product/123 重写为 example.com/shop/main.php?route=/product/123，同时剥离 /shop 前缀，我们可以结合 location 块和 rewrite 指令。
以下是Nginx配置的关键部分：
server {
listen 80;
server_name example.com;
root /var/www/html; # 假设你的项目根目录
index index.php index.html index.htm;
# PHP-FPM配置，确保PHP文件能被正确处理
location ~ \.php$ {
include fastcgi_params;
fastcgi_pass unix:/var/run/php/php7.4-fpm.sock; # 根据你的PHP-FPM版本和配置调整
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
# 处理 /shop 目录下的动态路由请求
location /shop/ {
# 尝试查找实际的文件或目录，如果存在则直接访问
# 否则，将请求内部重定向到 @rewrite_shop_route 命名location进行进一步处理
try_files $uri $uri/ @rewrite_shop_route;
}
# 命名location，专门处理 /shop 目录下的URI重写逻辑
location @rewrite_shop_route {
# 使用 rewrite 指令捕获并重写URI
# ^/shop(/.*) 匹配以 /shop 开头，并捕获 / 之后的所有内容到 $1
# 例如，对于 /shop/product/123， $1 将是 /product/123
rewrite ^/shop(/.*) /shop/main.php?route=$1 last;
}
# 阻止对 .htaccess 文件的访问
location ~ /\.ht {
deny all;
}
}配置详解
-
location /shop/ { ... }:
- 这个 location 块匹配所有以 /shop/ 开头的请求。这是处理 /shop 子目录下所有请求的入口点。
- try_files $uri $uri/ @rewrite_shop_route;：Nginx会首先尝试在 root 指定的目录下查找与 $uri 匹配的文件（例如 /var/www/html/shop/product/123）。如果找不到文件，它会尝试查找与 $uri/ 匹配的目录（例如 /var/www/html/shop/product/123/）。如果两者都找不到，请求将被内部重定向到 @rewrite_shop_route 这个命名 location。
- 这里使用 try_files 是为了优先处理可能存在的静态文件或目录，提高效率。只有当请求的URI不对应任何实际文件或目录时，才进入重写逻辑。
-
location @rewrite_shop_route { ... }:
- 这是一个命名 location，它不会直接被外部请求访问，而是作为 try_files 指令的内部重定向目标。
- rewrite ^/shop(/.*) /shop/main.php?route=$1 last;：这是实现核心重写逻辑的指令。
- ^/shop(/.*)：这是一个正则表达式。
- ^ 匹配URI的开始。
- /shop 精确匹配字面字符串 /shop。
- (/.*) 是一个捕获组。它匹配 / 之后的所有字符（包括 / 本身），并将其捕获到 $1 变量中。
- 例如，如果请求URI是 /shop/product/123，那么 $1 的值将是 /product/123。
- /shop/main.php?route=$1：这是重写后的目标URI。它将原始URI中 /shop 后面的部分（即 $1）作为 route 参数传递给 main.php 脚本。
- last：这是一个标志。它告诉Nginx停止处理当前的 rewrite 规则集，并使用新生成的URI重新开始查找匹配的 location。这意味着Nginx会再次从头开始匹配 location 块，最终可能会匹配到 location ~ \.php$ 块来处理 main.php 文件。
- ^/shop(/.*)：这是一个正则表达式。
注意事项与最佳实践
-
last 与 break 标志的区别：
- last：停止处理当前 location 块中的 rewrite 规则，并使用新生成的URI重新开始 location 匹配过程。这在需要将请求传递给另一个 location 块（例如PHP处理器）时非常有用。
- break：停止处理当前 location 块中的 rewrite 规则，但不会重新开始 location 匹配。它将继续处理当前 location 块中的其他指令。
- 在本例中，我们希望 main.php 被PHP-FPM处理，因此 last 是正确的选择。
- 正则表达式的精确性：确保你的正则表达式能够准确捕获你想要的部分。^/shop(/.*) 确保了 /shop 前缀被剥离，并且 route 参数以 / 开头。
- 避免不必要的 try_files 调用：原始问题中提到的第二个 try_files 在命名 location 中是不必要的，因为它会导致额外的文件系统查找开销，且无法正确使用 $1。rewrite 指令直接处理了URI转换。
-
测试Nginx配置：在重新加载Nginx服务之前，务必使用 nginx -t 命令检查配置文件的语法错误。
sudo nginx -t
如果显示 syntax is ok 和 test is successful，则可以安全地重载服务。
sudo systemctl reload nginx
- 日志分析：在调试过程中，检查Nginx的 access_log 和 error_log 是非常有用的。它们可以帮助你理解请求是如何被处理的，以及是否存在任何错误。
总结
通过本教程，我们学习了如何利用Nginx的 rewrite 指令，结合 location 和 try_files，实现子目录下URI路径的精确重写与参数传递。这种方法不仅解决了将用户友好URL转换为后端脚本所需参数格式的问题，而且通过避免 try_files 的不当使用，确保了Nginx配置的效率和正确性。掌握 rewrite 指令的强大功能，对于构建灵活、高性能的Web应用至关重要。正确理解和运用 last 等标志，能够确保请求在Nginx内部的正确流转，最终被后端应用正确处理。
