nginx上try_files 判断文件是否存在

作者：袖梨 2022-06-30

try_files 是nginx0.6.36 后新增一个功能，用于搜索指定目录下的N个文件，如果找不到fileN，则调用fallback中指定的位置来处理请求。个人认为，作为nginx核心的内容，可以部分替代烦琐的rewrite功能，笔者把它用在wp super cache的rewrite重写中，也取得了不错的效果。


try_files
语法: try_files file1 [file2 ... filen] fallback

默认值: 无

作用域: location

这个指令的作用就是可接收多个路径作为参数，当前一个路径的资源无法找到，则自动查找下一个路径，如当请求的静态资源不存在，就将请求fallback指定位置到后台服务器上进行动态处理

现在有这样一个需求，网站根目录下有静态文件，static目录下也有静态文件，static目录下的静态文件是程序批量生成的，我想让nginx在地址不变的前提下优先使用static目录里面的文件，如果不存在再使用根目录下的静态文件，比如访问首页http://example.com/index.html则nginx返回/static/index.html，如果不存在返回/index.html。

经过一番研究可以用if指令实现，关键配置如下，这条配置需要放到靠前的位置

 代码如下 复制代码

if (-e $document_root/static$request_uri) {
 rewrite ^/(.*)$ /static/$1 break;
 break;
}

这里有两点需要注意：

1.nginx变量默认应该开头有反斜线而结尾没有。
2.nginx字符串和变量可以直接连接，如果可能有歧义可以花括号括起变量名称，整个字符串必须加双引号
"${document_root}/static${request_uri}"是用这种方式有一个缺点，index指令指定的文件不会起作用，比如访问http://example.com/就会404，必须显示的指定文件名才行http://example.com/index.html。可以用rewrite修复，但是感觉不爽，在nginx陷阱页面突然发现一个针对性的指令try_files

 代码如下 复制代码

set $static "/static";
try_files $static$uri $static$uri/index.html /index.php;

后来发现$uri变量本身会自动添加index.html后缀，经过实验这样写也是可以的

 代码如下 复制代码

if (-e "${document_root}/static${uri}") {
 rewrite ^/(.*)$ /static/$uri break;
}

if (-e $request_filename) {
 break;
}

因为最后不存在的文件都写到index.php去了所以上面rewrite之后需要再判断一次文件存在。

例

笔者的博客刚刚建立起来，wp super cache是不可或缺的一个插件，但默认的supercache是针对apache的.htaccess的，在nginx下的

 代码如下 复制代码


server {
    set $cache /wp-content/cache/supercache/$host;
        #wp-super-cache的路径
    listen 80;
    server_name _;
    location / {
        root /home/html/s0001/domains/$host;
        index index.php index.html;
                #直接调用gzip压缩后的html静态文件
        add_header Content-Type "text/html; charset=UTF-8";
        add_header Content-Encoding "gzip";
        try_files $cache/$uri/index.html.gz @proxy;
 
    }
        #所有静态文件都由nginx处理，并用gzip压缩输出
    location ~* .(jpg|jpeg|png|gif|css|js|swf|mp3|avi|flv|xml|zip|rar)$ {
        expires 30d;
        gzip on;
        gzip_types  text/plain application/x-javascript text/css application/xml;
        root /home/html/s0001/domains/$host;
    }
        #找不到的文件都交给后端的apache处理了
    location @proxy {
        index  index.php index.htm index.html;
        root   /home/html/$user/domains/$host;
            proxy_pass   http://127.0.0.1:8080;
            proxy_redirect off;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

相关文章

精彩推荐