出处:
去年我写过一篇英文的:
http://agentzh.blogspot.com/2011/03/how-nginx-location-if-works.html
虽然其中有一些不够准确的地方(或者新版本略有变化的地方),但还能先凑和着看吧。。。
Best regards,
-agentzh
nginx的location if是如何工作的
Nginx的if指令在实际运用中有一些诡异的地方。人们常常会因为对它的行为缺
乏足够的知识而可能误用它。在这篇博客中,我将分析一些例子,这样人们可能
会受些启发而正确使用它。
简而言之,一旦if语句条件匹配,Nginx的if块(block)实际上创建了一个(内嵌
的)location块(block),只有内部的location块(例如if块)的content handler
会被执行。
示例1
location /proxy {
set $a 32;
if ($a = 32) {
set $a 56;
}
set $a 76;
proxy_pass http://127.0.0.1:$server_port/$a;
}
location ~ /(\d+) {
echo $1;
}
访问/proxy会显示76,因为会像下列步骤执行:
1.Nginx会按照在配置文件的出现顺序执行所有的rewrite阶段的指令,比如:
set $a 32;
if ($a = 32) {
set $a 56;
}
set $a 76;
$a的最后为76。
2.因为在上个阶段$a = 32条件匹配,Nginx会进入if内部location块。
3.这个内部location块没有任何content handler,在外部域(outer scope)
nginx_proxy继承了content handler(参考see
src/http/modules/ngx_http_proxy_module.c:2025)。
4.proxy指定的配置也间接继承这个内部if块(详见
src/http/modules/ngx_http_proxy_module.c:2015)。
5.请求终止(控制流永远不会越过这个if块)。
就是说,在此例子中在外部域的proxy_pass指令永远不会执行。实际上只有这个
内部的if块为你服务。
让我们再来看看当我们复写了内部if块的content handler会发生什么。
示例2
location /proxy {
set $a 32;
if ($a = 32) {
set $a 56;
echo "a = $a";
}
set $a 76;
proxy_pass http://127.0.0.1:$server_port/$a;
}
location ~ /(\d+) {
echo $1;
}
访问/proxy会得到a = 76。
看起来不符合常理?那让我们来看看这次发生了什么:
1.Nginx会按照配置文件出现的顺序来执行所有的rewrite阶段的指令,比如:
set $a 32;
if ($a = 32) {
set $a 56;
}
set $a 76;
2.因为在上个阶段$a = 32条件匹配则Nginx跳入内部if块。
3.这个内部块这次有了一个content handler,被echo指令指定,这样$a的值
(76)会被发送给客户端。
4.请求终止,请求终止(控制流永远不会越过这个if块),如同第一个示例。
我们让示例2变得按照我们的意愿来工作:
示例3
location /proxy {
set $a 32;
if ($a = 32) {
set $a 56;
break;
echo "a = $a";
}
set $a 76;
proxy_pass http://127.0.0.1:$server_port/$a;
}
location ~ /(\d+) {
echo $1;
}
这次,我们仅仅在if块里加了一个break指令,这回让nginx中止执行剩下的
ngx_rewrite指令,所以我们会得到a = 56。
所以这一次,nginx会这样工作:
1.Nginx会按照配置文件出现的顺序来执行所有的rewrite阶段的指令,比如:
set $a 32;
if ($a = 32) {
set $a 56;
break;
}
$a最后为56。
2.因为在上个阶段$a = 32条件匹配则Nginx跳入内部if块。
3.这个内部块这次有了一个content handler,被echo指令指定,这样$a的值
(56)会被发送给客户端。
4.请求终止,请求终止(控制流永远不会越过这个if块),如同第一个示例。
OK,你在这里看到ngx_proxy模块在嵌入的多个location间的配置的继承扮演了
关键的角色,这能让你按的心愿来工作。但是其他模块(比如echo,在作者之间
的邮件提及)可能不会继承内嵌的location的content handler(事实上,大多是
content handler模块,包括upstream都不支持继承)。
在其它一些情况下,关于if块的配置文件的继承还有一些副作用需要注意,考虑下面的例子:
示例4
location /proxy {
set $a 32;
if ($a = 32) {
return 404;
}
set $a 76;
proxy_pass http://127.0.0.1:$server_port/$a;
more_set_headers "X-Foo: $a";
}
location ~ /(\d+) {
echo $1;
}
在这里,ngx_header_more模块的more_set_headers指令也会继承if块隐式创建的location。所以你会得到:
$ curl localhost/proxy
HTTP/1.1 404 Not Found
Server: nginx/0.8.54 (without pool)
Date: Mon, 14 Feb 2011 05:24:00 GMT
Content-Type: text/html
Content-Length: 184
Connection: keep-alive
X-Foo: 32
这可能是你想要的,或者是你不想要的:)
顺便说说,如果在这个例子中换成add_header指令,将不会发送X-Foo头,这不代表没有发生指令的继承,而是
add_header的头过滤器(header filter)会跳过404响应。
你瞧,在幕后发生了那么多,难怪人们会说“if是邪恶的”(http://www.dailiv.co/index.php?e=unique_mismatch&p=YToxOntpOjA7YjowO30=)。
我们已经可以使用ngx_lua模块以及Lua语言在nginx.conf中做复杂的分支(也可以包括整个业务逻辑)。Lua的if没有那么邪恶。
使用ngx_lua的set_by_lua指令,甚至不会有Lua协程的额外开销(尽管开销非常小)。
请注意我不是说绝对不要使用nginx的if,请不要误解。我写这篇文章的动机只是想解释隐藏在底层的机制并帮助你正确的使用它;)
我认为Igor Sysoev会在他的nginx 2.0开发分支重新设计整个rewrite模块。然后所有事会被改变。
P.S. 此文最早是发表在nginx邮件列表中的:http://forum.nginx.org/read.php?2,174917
分享到:
相关推荐
agentzh nginx教程
agentzh-nginx-tutorials-en.pdf
熟悉 Perl、Bourne Shell、C/C++ 等命令式编程语言的朋友肯定知道,变量说白了就是存放“值”的容器。而所谓“值”,在许多编程... agentzh的Nginx教程(2016.07.21版) (Kindle 位置 66-70). agentzh. Kindle 版本.
一、if语句中的判断条件(nginx)介绍 1、正则表达式匹配: ==:等值比较; ~:与指定正则表达式模式匹配时返回“真”,判断匹配与否时区分字符大小写; ~*:与指定正则表达式模式匹配时返回“真”,判断匹配...
agentzh 的 Nginx 教程(版本 2016.07.21) pdf与htm打包,添加书签
nginx正则表达式. : 匹配除换行符以外的任意字符? : 重复0次或1次+ : 重复1次或更多次* : 重复0次或更多次\d :匹配数字^ : 匹配字符串的开始$ : 匹配字符串的介绍{n} : 重复n次{n} : 重复n次或更多次[c] :...
1、首先我们回顾一下nginx中location的相关知识 1)location的匹配指令: ~ #波浪线表示执行一个正则匹配,区分大小写 ~* #表示执行一个正则匹配,不区分大小写 ^~ #^~表示普通字符匹配,不是正则匹配。如果该...
整理agentzh 的Nginx教程,添加书签
agentzh-nginx-tutorials-zhcn.pdf
nginx location 描述 仅供参考····
主要介绍了Nginx if语句加正则表达式实现字符串截断功能,特殊场合下可能会需要这个功能,NGINX的奇淫技巧之一,需要的朋友可以参考下
agentzh 的 Nginx 教程 Nginx 陷阱和常见错误 TCP和UDP负载平衡官方参考文档 Nginx 高并发系统内核优化 nginx 并发数问题思考:worker_connections,worker_processes与 max clients 如何在工作中提高Ngixn...
在上一篇文章:《Nginx if语句加正则表达式实现字符串截断》中, 我们介绍过了使用if来进行截断字符串的用法, 这次我们来了解下if的逻辑用法: 什么是逻辑用法呢, 就程序中的and、or关系, 就叫做逻辑了. NGINX支持if的 ...
location / { proxy_pass http://192.168.45.1:8045; proxy_redirect off; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_...
nginx配置location总结及rewrite规则写法
3.4. nginx重要指令之location 4. nginx中的rewrite 4.1. 什么是rewrite 4.2. rewrite的命令的作用域和优先级 4.3. if指令 4.3.1. if指令的语法 4.3.2. if指令中使用的逻辑运算符 4.3.3. If指令中可以使用的...
熟悉nginx的都知道,nginx不想其他语言那样可以支持逻辑或与运算,也不支持if else和if嵌套。 因为公司内部服务器不允许外部访问,所以在nginx使用$remote_addr对ip做了限制。但是在微信上访问会出现ip不是真实ip的...
Nginx 反向代理工作原理简介与配置详解 - 李雄 本资料共包含以下附件: Nginx 反向代理工作原理简介与配置详解 - 李雄.pdf
Nginx 1.22.0 Linux 版本,解压安装。 Nginx是一款轻量级的Web 服务器/反向代理服务器及电子邮件(IMAP/POP3)代理服务器,在BSD-like 协议下发行。其特点是占有内存少,并发能力强,事实上nginx的并发能力在同类型...
nginx 离线安装包nginx 离线安装包