Nginx Location 指令简明指南

nginx 中的 location 指令 是nginxhttpcoremodule中重要指令。location 指令比较简单，但却是配置 nginx 过程中不得不去了解的。

location 指令，是用来为匹配的 uri 进行配置，uri 即语法中的"/uri/"，可以是字符串或正则表达式。但如果要使用正则表达式，则必须指定前缀。

一、基本语法

1.location [=|~|~*|^~|@] /uri/ { … }
〖=〗 表示精确匹配，如果找到，立即停止搜索并立即处理此请求。
〖~ 〗 表示区分大小写匹配
〖~*〗 表示不区分大小写匹配
〖^~ 〗 表示只匹配字符串,不查询正则表达式。
〖@〗 指定一个命名的location，一般只用于内部重定向请求。

二、匹配过程

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

三、配置实例

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

四、全局变量

$args #这个变量等于请求行中的参数。
$content_length #请求头中的content-length字段。
$content_type #请求头中的content-type字段。
$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相同。