Nginx URI重写：剥离路径前缀并传递参数的教程

理解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指令。

核心思路是：

降重鸟

要想效果好，就用降重鸟。AI改写智能降低AIGC率和重复率。

113

查看详情

1. 首先，Nginx尝试查找实际存在的文件或目录。
2. 如果找不到，则将请求转发到一个命名location。
3. 在该命名location中，使用rewrite指令通过正则表达式匹配并捕获URI中/shop之后的部分。
4. 将捕获到的部分作为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;
    }
}

代码解释：

1. location ~ \.php$: 这是一个典型的PHP-FPM配置块，用于处理所有以.php结尾的请求，将它们转发给PHP-FPM处理。
2. location /shop/ { ... }: 这个块负责处理所有以/shop/开头的请求。
   • try_files $uri $uri/ @rewrite_shop;: Nginx会首先尝试查找与请求URI匹配的文件（$uri），如果找不到，则尝试查找与请求URI匹配的目录（$uri/）。如果文件和目录都找不到，Nginx会将请求内部重定向到命名location @rewrite_shop。这个步骤确保了如果/shop/目录下有静态资源（如图片、CSS、JS文件），它们会优先被Nginx直接服务，而不是被重写到main.php。
3. 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中文网其它相关文章！