nginx 文件路径的定义

下面介绍一下文件路径的定义配置项。

（1）以root方式设置资源路径

语法：root path;

默认：root html;

配置块：http、server、location、if

例如，定义资源文件相对于HTTP请求的根目录。
location /download/ {
 root /opt/web/html/;
}

在上面的配置中，如果有一个请求的URI是/download/index/test.html，那么Web服务器将会返回服务器上/opt/web/html/download/index/test.html文件的内容。

（2）以alias方式设置资源路径

语法：alias path;

配置块：location

alias也是用来设置文件资源路径的，它与root的不同点主要在于如何解读紧跟location后面的uri参数，这将会致使alias与root以不同的方式将用户请求映射到真正的磁盘文件上。例如，如果有一个请求的URI是/conf/nginx.conf，而用户实际想访问的文件在/usr/local/nginx/conf/nginx.conf，那么想要使用alias来进行设置的话，可以采用如下方式：
location /conf {
   alias /usr/local/nginx/conf/;   
}

如果用root设置，那么语句如下所示：
location /conf {
   root /usr/local/nginx/;       
}

使用alias时，在URI向实际文件路径的映射过程中，已经把location后配置的/conf这部分字符串丢弃掉，因此，/conf/nginx.conf请求将根据alias path映射为path/nginx.conf。root则不然，它会根据完整的URI请求来映射，因此，/conf/nginx.conf请求会根据root path映射为path/conf/nginx.conf。这也是root可以放置到http、server、location或if块中，而alias只能放置到location块中的原因。

alias后面还可以添加正则表达式，例如：
location ~ ^/test/(\w+)\.(\w+)$ {
    alias /usr/local/nginx/$2/$1.$2;
}

这样，请求在访问/test/nginx.conf时，Nginx会返回/usr/local/nginx/conf/nginx.conf文件中的内容。

（3）访问首页

语法：index file ...;

默认：index index.html;

配置块：http、server、location

有时，访问站点时的URI是/，这时一般是返回网站的首页，而这与root和alias都不同。这里用ngx_http_index_module模块提供的index配置实现。index后可以跟多个文件参数，Nginx将会按照顺序来访问这些文件，例如：
location / {
    root   path;
    index /index.html /html/index.php /index.php;
}

接收到请求后，Nginx首先会尝试访问path/index.php文件，如果可以访问，就直接返回文件内容结束请求，否则再试图返回path/html/index.php文件的内容，依此类推。

（4）根据HTTP返回码重定向页面

语法：error_page code [ code... ] [ = | =answer-code ] uri | @named_location

配置块：http、server、location、if

当对于某个请求返回错误码时，如果匹配上了error_page中设置的code，则重定向到新的URI中。例如：
error_page   404          /404.html;
error_page   502 503 504  /50x.html;
error_page   403          http://example.com/forbidden.html;
error_page   404          = @fetch ;

注意，虽然重定向了URI，但返回的HTTP错误码还是与原来的相同。用户可以通过“=”来更改返回的错误码，例如：
error_page 404 =200 /empty.gif;
error_page 404 =403 /forbidden.gif;

也可以不指定确切的返回错误码，而是由重定向后实际处理的真实结果来决定，这时，只要把“=”后面的错误码去掉即可，例如：
error_page 404 = /empty.gif;

如果不想修改URI，只是想让这样的请求重定向到另一个location中进行处理，那么可以这样设置：
location / (
    error_page 404 @fallback ;
)
 
location @fallback (
    proxy_pass http://backend;
)

这样，返回404的请求会被反向代理到http://backend上游服务器中处理。

（5）是否允许递归使用error_page

语法：recursive_error_pages [on | off];

默认：recursive_error_pages off;

配置块：http、server、location

确定是否允许递归地定义error_page。

（6）try_files

语法：try_files path1 [path2] uri;

配置块：server、location

try_files后要跟若干路径，如path1 path2...，而且最后必须要有uri参数，意义如下：尝试按照顺序访问每一个path，如果可以有效地读取，就直接向用户返回这个path对应的文件结束请求，否则继续向下访问。如果所有的path都找不到有效的文件，就重定向到最后的参数uri上。因此，最后这个参数uri必须存在，而且它应该是可以有效重定向的。例如：
try_files /system/maintenance.html $uri $uri/index.html $uri.html @other ;
location @other {
  proxy_pass http://backend;
}

上面这段代码表示如果前面的路径，如/system/maintenance.html等，都找不到，就会反向代理到http://backend服务上。还可以用指定错误码的方式与error_page配合使用，例如：
location / {
  try_files $uri $uri/ /error.php?c=404 =404;
}