2.4.2　文件路径的定义

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

（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；

}