Nginx的try_files指令使用实例

Nginx的配置语法灵活，可控制度很是高。在0.7之后的版本中加入了一个try_files指令，配合命名location，能够部分替代本来经常使用的rewrite配置方式，提升解析效率。

try_files指令说明

• try_files指令
• 语法：try_files file … uri 或 try_files file … = code
• 默认值：无
• 做用域：server location

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

须要注意的是，只有最后一个参数能够引发一个内部重定向，以前的参数只设置内部URI的指向。最后一个参数是回退URI且必须存在，不然会出现内部500错误。命名的location也能够使用在最后一个参数中。与rewrite指令不一样，若是回退URI不是命名的location那么$args不会自动保留，若是你想保留$args，则必须明确声明。

try_files $uri $uri/ /index.php?q=$uri&$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; } }

常见错误

常见错误一

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;

便可解决