Nginx配置与变量深度解析教程

Nginx中文教程

需积分: 10 169 浏览量更新于2024-07-16 收藏 10.27MB PDF 举报

身份认证购VIP最低享 7 折!

领优惠券(最高得80元）

"Nginx教程，由agentzh编写，涵盖了Nginx的多个核心主题，如变量和配置指令的执行顺序。教程旨在面向不同水平的Nginx用户，特别是对其他服务器（如Apache、Lighttpd）有经验的用户。教程内容确保与Nginx 0.8.54及以上版本兼容，并主要使用经生产环境验证的模块，包括非标准的第三方模块。推荐使用ngx_openresty软件包来方便地获取和安装所有必要的模块。教程注重实用性和实例教学，每个主题相对独立，但又构成一个整体的学习体系。" Nginx是一款高性能、轻量级的Web服务器/反向代理服务器，因其高效稳定和灵活的配置而受到广泛欢迎。本教程由知名Nginx开发者agentzh撰写，旨在深入浅出地介绍Nginx的相关知识，帮助用户更好地理解和运用Nginx。教程的核心部分包括了“Nginx变量漫谈”和“Nginx配置指令的执行顺序”两个序列。在“Nginx变量漫谈”中，作者详细阐述了Nginx内部的各种变量，这些变量在处理请求时扮演着重要角色，可用于构建动态响应和服务。读者将学习如何利用这些变量进行条件判断、变量赋值以及在配置文件中实现复杂的逻辑。 “Nginx配置指令的执行顺序”系列则探讨了Nginx配置文件中指令的解析和执行流程。理解这一顺序对于优化服务器配置、避免错误和冲突至关重要。教程通过多个章节逐步解析了从启动到结束的整个过程，让读者明白何时何地应用特定指令可以达到预期效果。此外，教程特别强调所有示例均基于实际生产环境，确保其可靠性和实用性。对于不熟悉Nginx的Apache或Lighttpd用户，这将是一份宝贵的转型指南。推荐的ngx_openresty软件包包含了一个集成的Nginx环境，包含了教程中提到的所有模块，使得学习和部署变得更加简便。教程采用系列化的方式进行编写，每个小主题独立但又相互关联，便于读者按照个人兴趣和需求选择学习路径。通过阅读此教程，无论是初学者还是经验丰富的系统管理员，都能深化对Nginx的理解，提升运维技能，从而更好地利用Nginx构建高性能的网络服务。

资源详情

资源推荐

$curl'http://localhost:8080/test'
originalargs:
args:a=3&b=4
$curl'http://localhost:8080/test?a=0&b=1&c=2'
originalargs:a=0&b=1&c=2
args:a=3&b=4
在第⼀次测试中，我们没有设置任何URL参数串，所以输出$orig_args变量的值时便得到空。⽽在第⼀次和第⼆次测试
中，⽆论我们是否提供URL参数串，参数串都会在location/test中被强⾏改写成a=3&b=4.
需要特别指出的是，这⾥的$args变量和$arg_XXX⼀样，也不再使⽤属于⾃⼰的存放值的容器。当我们读取$args时，
Nginx会执⾏⼀⼩段代码，从Nginx核⼼中专门存放当前URL参数串的位置去读取数据；⽽当我们改写$args时，Nginx会
执⾏另⼀⼩段代码，对相同位置进⾏改写。Nginx的其他部分在需要当前URL参数串的时候，都会从那个位置去读数据，
所以我们对$args的修改会影响到所有部分的功能。我们来看⼀个例⼦：
location/test{
set$orig_a$arg_a;
set$args"a=5";
echo"originala:$orig_a";
echo"a:$arg_a";
}
这⾥我们先把内建变量$arg_a的值，即原始请求的URL参数a的值，保存在⽤户变量$orig_a中，然后通过对内建变
量$args进⾏赋值，把当前请求的参数串改写为a=5，最后再⽤echo指令分别输出$orig_a和$arg_a变量的值。因为对
内建变量$args的修改会直接导致当前请求的URL参数串发⽣变化，因此内建变量$arg_XXX⾃然也会随之变化。测试的结
果证实了这⼀点：
$curl'http://localhost:8080/test?a=3'
originala:3
a:5
我们看到，因为原始请求的URL参数串是a=3,所以$arg_a最初的值为3,但随后通过改写$args变量，将URL参数串又
强⾏修改为a=5,所以最终$arg_a的值又⾃动变为了5.
我们再来看⼀个通过修改$args变量影响标准的HTTP代理模块ngx_proxy的例⼦：
server{
listen8080;
location/test{
set$args"foo=1&bar=2";
proxy_passhttp://127.0.0.1:8081/args;
}
}
server{
listen8081;
location/args{
echo"args:$args";
}
}
这⾥我们在http配置块中定义了两个虚拟主机。第⼀个虚拟主机监听8080端⼜，其/test接⼜⾃⼰通过改写$args变
量，将当前请求的URL参数串⽆条件地修改为foo=1&bar=2.然后/test接⼜再通过ngx_proxy模块的proxy_pass指令
配置了⼀个反向代理，指向本机的8081端⼜上的HTTP服务/args.默认情况下，ngx_proxy模块在转发HTTP请求到远⽅
HTTP服务的时候，会⾃动把当前请求的URL参数串也转发到远⽅。
⽽本机的8081端⼜上的HTTP服务正是由我们定义的第⼆个虚拟主机来提供的。我们在第⼆个虚拟主机的location
/args中利⽤echo指令输出当前请求的URL参数串，以检查/test接⼜通过ngx_proxy模块实际转发过来的URL请求参
数串。
我们来实际访问⼀下第⼀个虚拟主机的/test接⼜：

$curl'http://localhost:8080/test?blah=7'
args:foo=1&bar=2
我们看到，虽然请求⾃⼰提供了URL参数串blah=7，但在location/test中，参数串被强⾏改写成了
foo=1&bar=2.接着经由proxy_pass指令将我们被改写掉的参数串转发给了第⼆个虚拟主机上配置的/args接⼜，然后再
把/args接⼜的URL参数串输出。事实证明，我们对$args变量的赋值操作，也成功影响到了ngx_proxy模块的⾏为。
在读取变量时执⾏的这段特殊代码，在Nginx中被称为“取处理程序”（gethandler）；⽽改写变量时执⾏的这段特殊代码，
则被称为“存处理程序”（sethandler）。不同的Nginx模块⼀般会为它们的变量准备不同的“存取处理程序”，从⽽让这些变量
的⾏为充满魔法。
其实这种技巧在计算世界并不鲜见。⽐如在⾯向对象编程中，类的设计者⼀般不会把类的成员变量直接暴露给类的⽤户，⽽
是另⾏提供两个⽅法（method），分别⽤于该成员变量的读操作和写操作，这两个⽅法常常被称为“存取器”（accessor）。
下⾯是C++语⾔中的⼀个例⼦：
#include<string>
usingnamespacestd;
classPerson{
public:
conststringget_name(){
returnm_name;
}
voidset_name(conststringname){
m_name=name;
}
private:
stringm_name;
};
在这个名叫Person的C++类中，我们提供了get_name和set_name这两个公共⽅法，以作为私有成员变量m_name
的“存取器”。
这样设计的好处是显⽽易见的。类的设计者可以在“存取器”中执⾏任意代码，以实现所需的业务逻辑以及“副作⽤”，⽐如⾃
动更新与当前成员变量存在依赖关系的其他成员变量，抑或是直接修改某个与当前对象相关联的数据库表中的对应字段。⽽
对于后⼀种情况，也许“存取器”所对应的成员变量压根就不存在，或者即使存在，也顶多扮演着数据缓存的⾓⾊，以缓解被
代理数据库的访问压⼒。
与⾯向对象编程中的“存取器”概念相对应，Nginx变量也是⽀持绑定“存取处理程序”的。Nginx模块在创建变量时，可以选
择是否为变量分配存放值的容器，以及是否⾃⼰提供与读写操作相对应的“存取处理程序”。
不是所有的Nginx变量都拥有存放值的容器。拥有值容器的变量在Nginx核⼼中被称为“被索引的”（indexed）；反之，则被
称为“未索引的”（non-indexed）。
我们前⾯在（⼆）中已经知道，像$arg_XXX这样具有⽆数变种的变量群，是“未索引的”。当读取这样的变量时，其实是
它的“取处理程序”在起作⽤，即实时扫描当前请求的URL参数串，提取出变量名所指定的URL参数的值。很多新⼿都会对
$arg_XXX的实现⽅式产⽣误解，以为Nginx会事先解析好当前请求的所有URL参数，并且把相关的$arg_XXX变量的值都
事先设置好。然⽽事实并⾮如此，Nginx根本不会事先就解析好URL参数串，⽽是在⽤户读取某个$arg_XXX变量时，调
⽤其“取处理程序”，即时去扫描URL参数串。类似地，内建变量$cookie_XXX也是通过它的“取处理程序”，即时去扫描
Cookie请求头中的相关定义的。
Nginx变量漫谈（四）
在设置了“取处理程序”的情况下，Nginx变量也可以选择将其值容器⽤作缓存，这样在多次读取变量的时候，就只需要调
⽤“取处理程序”计算⼀次。我们下⾯就来看⼀个这样的例⼦：
map$args$foo{
default0;
debug1;
}
server{
listen8080;