一、try_files语法解释
语法:try_files file … uri;
或 try_files file … = code;
默认值:无
作用域:server location
语法解释:
官方:Checks the existence of files in the specified order and uses the first found file for request processing; the processing is performed in the current context. The path to a file is constructed from the fileparameter according to the root and alias directives. It is possible to check directory’s existence by specifying a slash at the end of a name, e.g. “$uri/”. If none of the files were found, an internal redirect to the uri specified in the last parameter is made.
翻译:
首先:按照指定的顺序检查文件是否存在,并使用第一个找到的文件进行请求处理
其次:处理是在当前上下文中执行的。根据 root 和 alias 指令从 file 参数构造文件路径。
然后:可以通过在名称末尾指定一个斜杠来检查目录的存在,例如“ $uri/”。
最后:如果没有找到任何文件,则进行内部重定向到最后一个参数中指定的 uri。
自己理解的:按顺序检查文件是否存在,返回第一个找到的文件或文件夹(结尾加斜线表示文件夹),如果所有的文件或文件夹都找不到,会进行一个内部重定向到最后一个参数。
注:只有最后一个参数可以引起一个内部重定向,之前的参数只设置内部的 URL 的指向。最后一个参数是回退 URL 且必须存在,否则会出现内部 500 错误。命名的 location 也可以使用在最后一个参数中。
二、举例说明
示例一
location / {
root data;
index index.html index.htm;
try_files $uri $uri/ /index.html;
}
配置解释:
root:设置静态根目录为 data
index:设置目录的默认文件为 index.html 、index.htm
try_files:设置文件查找规则为 uri/ /index.html。即3个规则,先从 uri/ 目录中查找,最后查找 /index.html。
根据上面的配置,当请求 http://localhost:3004/api 时,$uri 为 /api。当前try_file 具体为:/api、/api/、/index.html,其中 / 表示根目录(根据 root 或 alias 来指定)。
查找逻辑:
首先:检查 data 目录中是否存在 api 文件,如果存在,则返回文件;如果不存在,则进行下一步。
其次:检查 data 目录中是否存在 api/ 目录,如果存在,则在检查 api/ 目录中是否存在 index.html 或者 index.htm 文件(由 index 指定);如果存在,则返回该文件。如果不存在,则进行下一步。
最后:检查 data 目录中是否存在 index.html 文件。如果存在,则返回文件;如果不存在,则返回 404。
示例二
location /pngs/ {
root /data/user/;
index index.html index.htm;
try_files $uri $uri/ /pngs/file.png;
}
根据上面的配置,当请求 http://localhost:3003/pngs/rule.png 时, $uri 为 /pngs/rule.png,
当前 try_file 查找顺序为,
首先是:/data/user/pngs/rule.png,
其次是:/data/user/pngs/rule.png/ 文件下的 index 所配置的文件,即: index.html、index.htm,
最后是: /data/user/pngs/file.png。