nginx location指令简明指南

基本语法

location指令的基本语法如下：

location [=|~|~*|^~] /uri/ { ... }

= 表示精确匹配，如果找到，立即停止搜索并立即处理此请求。

~ 表示区分大小写正则匹配。

~ 表示不区分大小写正则匹配。

^~ 表示前缀匹配，只匹配字符串，不查询正则表达式。

@ 指定一个命名的location，一般只用于内部重定向请求。

匹配过程

Nginx会首先对字符串进行匹配查询，最确切的匹配将被使用，正则表达式的匹配查询开始，匹配第一个结果后会停止搜索，如果没有找到正则表达式，将使用字符串的搜索结果，如果字符串和正则都匹配，那么正则优先级较高。

配置实例

以下是一些常见的配置实例：

location = / {
    # 只匹配对 / 目录的查询.
    [ config A ]
}
location / {
    # 匹配以 / 开始的查询，即所有查询都匹配。
    [ config B ]
}
location ^~ /images/ {
    # 匹配以 /images/ 开始的查询，不再检查正则表达式。
    [ config C ]
}
location ~* .(gif|jpg|jpeg)$ {
    # 匹配以gif, jpg, or jpeg结尾的文件，但优先级低于config C。
    [ config D ]
}

全局变量

在Nginx中，可以使用许多内置变量来帮助配置和调试，

$args：这个变量等于请求行中的参数。

$content_length：请求头中的Contentlength字段。

$content_type：请求头中的ContentType字段。

$document_root：当前请求在root指令中指定的值。

$host：请求主机头字段，否则为服务器名称。

$http_user_agent：客户端agent信息。

$http_cookie：客户端cookie信息。

$limit_rate：这个变量可以限制连接速率。

$request_body_file：客户端请求主体信息的临时文件名。

$request_method：客户端请求的动作，通常为GET或POST。

$remote_addr：客户端的IP地址。

$remote_port：客户端的端口。

$remote_user：已经经过Auth Basic Module验证的用户名。

$request_filename：当前请求的文件路径，由root或alias指令与URI请求生成。

$query_string：与$args相同。

$scheme：HTTP方法（如http，https）。

$server_protocol：请求使用的协议，通常是HTTP/1.0或HTTP/1.1。

$server_addr：服务器地址，在完成一次系统调用后可以确定这个值。

$server_name：服务器名称。

$server_port：请求到达服务器的端口号。

$request_uri：包含请求参数的原始URI，不包含主机名，如：“/foo/bar.php?arg=baz”。

$uri：不带请求参数的当前URI，$uri不包含主机名，如“/foo/bar.html”。

$document_uri：与$uri相同。

FAQs

1. 为什么需要使用正则表达式匹配？

正则表达式匹配允许你更灵活地定义复杂的匹配规则，你可以使用正则表达式来匹配特定类型的文件（如图片或PDF），或者根据URL模式执行不同的操作，这对于实现复杂的路由逻辑非常有用。

2. 什么是内部重定向？

内部重定向是指Nginx将请求从一个location块重定向到另一个location块的过程，这通常用于错误页面的处理或URL重写，当访问某个不存在的页面时，你可以配置Nginx将请求重定向到一个自定义的错误页面。