您的位置:

详解Nginx的try_files指令

一、什么是try_files

try_files指令是Nginx中用于寻找匹配请求中文件的指令,这个指令是非常重要的。

try_files指令的语法格式如下:

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

上述位置块使用try_files指令来查找与请求中的URI匹配的文件,如果该文件不存在,则通过向URI添加'/'并尝试在其后查找一个目录来实现。最后,如果前两个过程都失败了,则Nginx将发起一个内部重定向到URI包含的PHP脚本,并将查询字符串传递给它。

二、try_files的用法

1、正常使用方法

try_files指令通常与location块一起使用来确定如何服务请求。它有两个参数:第一个参数是要查找的文件或目录,第二个参数是在无法找到第一个参数所确定的文件或目录时要重定向到的URL。

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

上述代码块使用try_files指令来找到与请求中当前URI匹配的文件。如果该文件不存在,则Nginx将尝试找到一个目录。如果目录也不存在,则重定向到index.php文件并将查询字符串传递给它。

2、try_files与rewrite的区别

有时您可能不想向URI添加查询参数以创建新的URL。在这种情况下,try_files指令是比rewrite指令更好的选择。

location / {
    try_files $uri /404.html;
}

上述代码块仅查找当前URI的文件(没有查询参数)和/404.html。如果Nginx找不到这些文件,则显示404错误页面。

3、try_files与命名位置块

位置块常常被用来等待特定的请求,但是如果所有块都有一些通用的配置,则可以使用命名位置块。这些位置块包含共享配置。

location @rewrites {
    rewrite ^/product/(.*)?$ /index.php?product=$1 last;
}

location / {
    try_files $uri $uri/ @rewrites;
}

上述代码块中,命名位置块@rewrites包含来自请求的产品条目,并将其传递给index.php脚本进行进一步处理。

三、try_files的常见问题

1、try_files与开启gzip

在Nginx中启用gzip可能会导致401应答错误。这是因为Nginx无法处理压缩文件的请求。相反,需要使用try_files指令将静态文件解压缩后提供给客户端。

location / {
    try_files /path/$uri.gz /path/$uri /fallback.html;
    gunzip on;
}

2、try_files与alias的问题

在使用 alias 命令的位置块时,try_files 命令可能会突然失效,无法找到文件而产生 404 错误,这是因为输入到$uri 中的 非正则表达式的 URI 都是相对于 Web 服务器的 根目录(/) 的。

location /img/ {
    alias /var/www/img/;
    try_files $uri $uri/ /fallback.html;
}

在这种情况下,尝试查找 /var/www/img/$uri,但是由于uri输入中的 /img/ URI 是别名的一部分,因此 Nginx 将查找 /var/www/img/img/some-image.png。解决此问题的方法是使用root而不是alias:

location /img/ {
    root /var/www/;
    try_files $uri $uri/ /fallback.html;
}

总结

try_files指令是Nginx中非常重要的一个指令,它可以用于寻找HTTP请求中匹配的文件。try_files的使用方法有很多,可以与location块一起使用来确定如何服务请求,也可以与rewrite指令区别使用,还可以与命名位置块一起使用。