Nginx Location 指令简明指南
Nginx中的Location指令是NginxHttpCoreModule中重要指令。Location指令比较简单,但却是配置Nginx过程中不得不去了解的。
Location指令,是用来为匹配的URI进行配置,URI即语法中的"/uri/",可以是字符串或正则表达式。但如果要使用正则表达式,则必须指定前缀。
一、基本语法
1.location[=|~|~*|^~|@]/uri/{…}
〖=〗表示精确匹配,如果找到,立即停止搜索并立即处理此请求。
〖~〗表示区分大小写匹配
〖~*〗表示不区分大小写匹配
〖^~〗表示只匹配字符串,不查询正则表达式。
〖@〗指定一个命名的location,一般只用于内部重定向请求。
二、匹配过程
首先对字符串进行匹配查询,最确切的匹配将被使用。然后,正则表达式的匹配查询开始,匹配第一个结果后会停止搜索,如果没有找到正则表达式,将使用字符串的搜索结果,如果字符串和正则都匹配,那么正则优先级较高。
三、配置实例
location =/{ #只匹配对/目录的查询. [configA] } location /{ #匹配以/开始的查询,即所有查询都匹配。 [configB] } location^~/images/{ #匹配以/images/开始的查询,不再检查正则表达式。 [configC] } location~*\.(gif|jpg|jpeg)${ #匹配以gif,jpg,orjpeg结尾的文件,但优先级低于configC。 [configD] }
四、全局变量
$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#已经经过AuthBasicModule验证的用户名。
$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相同。