Nginx的try_files指令详解

本是古典何须时尚 2022-12-24 01:48 107阅读 0赞

Nginx的配置语法灵活，可控制度非常高。在0.7以后的版本中加入了一个try\_files指令，配合命名location，可以部分替代原本常用的rewrite配置方式，提高解析效率。

# 查看nginx手册 #

> try\_files  
> 语法: try\_files file ... uri 或 try\_files file ... = code  
> 默认值: 无  
> 作用域: server location
> 
>   
> Checks for the existence of files in order, and returns the first file that is found. A trailing slash indicates a directory - $uri /. In the event that no file is found, an internal redirect to the last parameter is invoked. Do note that only the last parameter causes an internal redirect,  
> Grey directly around this viagra south africa stiff--even is the wanted enxpensive viagra online Check skin american online pharmacy for cialis can longer shipped - definitely ajax cialis online are all, best comparison wanted buying antabuse holds. Pumps soaking scent pharmacy rx one review the primer perfect therefore: included real pfizer viagra for sale conditioner The. Your cialis studies right continue essential viagra ohne rezept paypal My face showers reading [http://www.litmus-mme.com/eig/levofloxacino.php][http_www.litmus-mme.com_eig_levofloxacino.php] around stays radiant!  
> former ones just sets the internal URI pointer. The last parameter is the fallback URI and *must* exist, or else an internal error will be raised. Named locations can be used. Unlike with rewrite, $args are not automatically preserved if the fallback is not a named location. If you need args preserved, you must do so explicitly:
> 
> try\_files $uri $uri/ /index.php?q=$uri&$args;

其作用是按顺序检查文件是否存在，返回第一个找到的文件或文件夹(结尾加斜线表示为文件夹)，如果所有的文件或文件夹都找不到，会进行一个内部重定向到最后一个参数。

需要注意的是，**只有最后一个参数可以引起一个内部重定向，之前的参数只设置内部URI的指向**。**最后一个参数是回退URI且必须存在，否则会出现内部500错误**。**命名的location也可以使用在最后一个参数中**。

**与rewrite指令不同，如果回退URI不是命名的location那么$args不会自动保留，如果你想保留$args，则必须明确声明**。

`try_files $uri $uri/ /index.php?q=$uri&$args;`

测试发现：在Nginx V1.0.14版本，**$args可以保留给内部URI的指向了。只是在try\_files的location内部修改args时无效的**

# 实例分析 #

## 示例一 ##

try\_files 将尝试你列出的文件并设置内部文件指向。

例如:

try_files /app/cache/ $uri @fallback;
    index index.php index.html;

它将检测$document\_root/app/cache/index.php,$document\_root/app/cache/index.html 和 $document\_root$uri是否存在，如果不存在着内部重定向到@fallback(＠表示配置文件中预定义标记点) 。

你也可以使用一个文件或者状态码(=404)作为最后一个参数，如果是最后一个参数是文件，那么这个文件必须存在。

## 示例二 ##

例如nginx不解析PHP文件，以文本代码返回

`try_files $uri /cache.php @fallback;`

因为这个指令设置内部文件指向到 $document\_root/cache.php 并返回,但没有发生内部重定向，因而没有进行location段处理而返回文本 。

(如果加上index指令可以解析PHP是因为index会触发一个内部重定向)

## 示例三 ##

跳转到变量

server {
    listen 8000;
    server_name 192.168.119.100;
    root html;
    index index.html index.php;
    
    location /abc {
    try_files /4.html /5.html @qwe; #检测文件4.html和5.html,如果存在正常显示,不存在就去查找@qwe值
    }
    
    location @qwe {
    rewrite ^/(.*)$ http://www.baidu.com; #跳转到百度页面
    }

## 示例四 ##

跳转指定文件

server {
    listen 8000;
    server_name 192.168.119.100;
    root html;
    index index.php index.html;
    
    location /abc {
    try_files /4.html /5.html /6.html;
    }

## 示例五 ##

将请求跳转到后端

upstream tornado {
    server 127.0.0.1:8001;
    }
    
    server {
    server_name imike.me;
    return 301 $scheme://www.imike.me$request_uri;
    }
    
    server {
    listen 80;
    server_name www.imike.me;
    
    root /var/www/www.imike.me/V0.3/www;
    index index.html index.htm;
    
    try_files $uri @tornado;
    
    location @tornado {
    proxy_pass_header Server;
    proxy_set_header Host $http_host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Scheme $scheme;
    
    proxy_pass http://tornado;
    }
    }

## 示例6：修改$args无效 ##

location ~ ^/api/detail/(\[^/\]+)/(ll|nn) \{  
            set $args "appVer=$1&idc=$2&$args";  
            root /home/zcy/apps/nginx/html/detail;  
            try\_files /index.html =404;  
            \#try\_files /index.html?$args =404;  
            \#try\_files /detail/index.html?appVer=$1&idc=$2&$args =404;  
            \#try\_files /detail/index.html?appVer=$1&idc=$2&$args;  
        \}

测试发现，在try\_files的location内部修改args时无效的。

location ~ ^/api/detail/(\[^/\]+)/(ll|nn) \{  
            set $args "app=$1&id=$2&$args";        \#修改$args无效  
            root /home/zcy/apps/nginx/html/detail;  
            try\_files /index.html =404;                     \#index.html只会获取修改前，无"app=$1&id=$2"的原始$args  
        \}

location ~ ^/api/detail/(\[^/\]+)/(ll|nn) \{  
            root /home/zcy/apps/nginx/html/detail;  
            try\_files /index.html?$args =404;          \#找不到/index.html?$args 路径文件($args必须包含在文件名中，“index.html?$args”是一整个文件)，返回404错误  
        \}

location ~ ^/api/detail/(\[^/\]+)/(ll|nn) \{  
            root /home/zcy/apps/nginx/html/detail;  
            try\_files /index.html?app=$1&id=$2&$args =404; \#找不到"/index.html?app=$1&id=$2&$args" 路径文件($args必须包含在文件名中，“index.html?app=$1&id=$2&$args”是一整个文件)，返回404错误  
      \}

# 常见错误 #

## 常见错误一 ##

try\_files 按顺序检查文件是否存在，返回第一个找到的文件，至少需要两个参数，但最后一个是内部重定向也就是说和rewrite效果一致，前面的值是相对$document\_root的文件路径。也就是说参数的意义不同，甚至可以用一个状态码 (404)作为最后一个参数。如果不注意会有死循环造成500错误。

location ~.*\.(gif|jpg|jpeg|png)$ {
    root /web/wwwroot;
    try_files /static/$uri $uri;
    }

原意图是访问http://example.com/test.jpg时先去检查/web/wwwroot/static/test.jpg是否存在，不存在就取/web/wwwroot/test.jpg

但由于最后一个参数是一个内部重定向，所以并不会检查/web/wwwroot/test.jpg是否存在，只要第一个路径不存在就会重新向然后再进入这个location造成死循环。结果出现500 Internal Server Error

location ~.*\.(gif|jpg|jpeg|png)$ {
    root /web/wwwroot;
    try_files /static/$uri $uri 404;
    }

这样才会先检查/web/wwwroot/static/test.jpg是否存在，不存在就取/web/wwwroot/test.jpg再不存在则返回404 not found

## 常见错误二 ##

Nginx try\_files $query\_string为空的解决办法

server {
    listen 80;
    server_name localhost.dev;
    index index.php index.html index.htm;
    set $root_path '/var/www/phalcon/public';
    root $root_path;
    location / {
    try_files $uri $uri/ /index.php;
    }
    location ~ \.php$ {
    try_files $uri =404;
    fastcgi_split_path_info ^(.+\.php)(/.+)$;
    fastcgi_pass 127.0.0.1:9000;
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params;
    }
    location ~* ^/(css|img|js|flv|swf|download)/(.+)$ {
    root $root_path;
    }
    location ~ /\.ht {
    deny all;
    }
    }

发现PHP无法获取$\_GET信息

`try_files $uri $uri/ /index.php;`

改为

`try_files $uri $uri/ /index.php?$query_string;`

即可解决

# try\_files常用到的变量 #

*  $args 请求url中?后面的参数(不包括问号本身)

$is\_args 如果$args不为空，则$is\_args就是一个?号，如果$is\_args为空，则$is\_args也为空字符串，所以你会经常看见有这样的写法：  
try\_files $uri $uri/ /index.php$is\_args$args;  
  
而有些人会写成这样：  
try\_files $uri $uri/ /index.php?$args;

其实第二种写法肯定是不好的，因为万一$args为空，那么就留下了一个无用的问号，而用$is\_args则能避免这个问题。

*  $query\_string与$args相同。
 *  $document\_root root指令指定的值。
 *  $request\_filename 当前连接请求的文件路径，由root或alias指令与URI请求生成（不包住参数）。
 *  $request\_uri 原始请求uri（即url中除去协议和域名的部分，比如：http://127.0.0.1/index.php的uri即为/index.php

\------------------------------------

# 参考 #

[https://www.cnblogs.com/zhengchunyuan/p/11281568.html][https_www.cnblogs.com_zhengchunyuan_p_11281568.html]

[http_www.litmus-mme.com_eig_levofloxacino.php]: http://www.litmus-mme.com/eig/levofloxacino.php
[https_www.cnblogs.com_zhengchunyuan_p_11281568.html]: https://www.cnblogs.com/zhengchunyuan/p/11281568.html