Nginx入门教程：变量与配置指令探索

需积分: 10 192 浏览量更新于2024-07-25 收藏 419KB PDF 举报

"Nginx入门资料，包括agentzh的Nginx教程，详细讲解了Nginx变量和配置指令的执行顺序，适合各水平层次的Nginx用户学习，特别是对Apache、Lighttpd服务器有经验的用户。教程中的模块都经过生产环境验证，推荐使用ngx_openresty软件包，包含所有提及的模块。" Nginx是一个高性能的HTTP和反向代理服务器，它以其轻量级、高并发处理能力以及低内存占用而著名，常被用来作为网站服务器或用于负载均衡。本入门资料特别关注于agentzh的Nginx教程，该教程涵盖了从基础到进阶的多个方面。 "缘起"部分表达了作者编写教程的初衷，希望通过一系列文章分享他在Nginx领域的知识和经验，教程以"系列"的形式呈现，如"Nginx变量漫谈"，每个系列可能对应未来书籍的一章。作者的目标读者不仅包括现有的Nginx用户，也包括其他服务器平台的用户，如Apache和Lighttpd。 "变量漫谈"系列详细讨论了Nginx中的内置变量，这些变量在配置文件中起到关键作用，用于动态处理请求和响应。从一到八的部分，可能是逐步深入地介绍各种变量的使用场景和功能，帮助读者理解如何利用这些变量实现灵活的配置。 "配置指令的执行顺序"系列则详细解释了Nginx配置文件中指令的解析和执行流程，这对于理解和优化Nginx配置至关重要。从一到十一的部分，可能涵盖了从基本配置结构到复杂情况下的指令处理逻辑。教程强调了所有示例和提及的模块都与至少Nginx 0.8.54版本兼容，并且推荐使用ngx_openresty软件包，因为它包含了所有必要的第三方模块和最新稳定的Nginx核心。这使得读者可以方便地实践教程中的内容，而不必单独下载和安装各个模块。这份Nginx入门资料是一套全面且实用的学习资源，无论你是初学者还是有一定经验的管理员，都能从中受益，提升对Nginx的理解和操作能力。通过阅读和实践，你可以掌握如何有效利用Nginx的特性来构建高效、可靠的Web服务架构。

$ curl 'http://localhost:8080/test'

name:

class:

$ curl 'http://localhost:8080/test?name=Tom&class=3'

$ curl 'http://localhost:8080/test?

name=hello%20world&class=9'

其实 $arg_name 不仅可以匹配 name 参数，也可以匹配 NAME 参

数，抑或是 Name，等等：

$ curl 'http://localhost:8080/test?NAME=Marry'

class:

$ curl 'http://localhost:8080/test?Name=Jimmy'

class:

Nginx 会在匹配参数名之前，自动把原始请求中的参数名调整为全

部小写的形式。

如果你想对 URI 参数值中的 %XX 这样的编码序列进行解码，可以

使用第三方 ngx_set_misc 模块提供的 set_unescape_uri 配置指

令：

location /test {

set_unescape_uri $name $arg_name;

set_unescape_uri $class $arg_class;

echo "name: $name";

echo "class: $class";

}

现在我们再看一下效果：

$ curl 'http://localhost:8080/test?

name=hello%20world&class=9'

空格果然被解码出来了！

从这个例子我们同时可以看到，这个 set_unescape_uri 指令也像

set 指令那样，拥有自动创建 Nginx 变量的功能。后面我们还会专

门介绍到 ngx_set_misc 模块。

像 $arg_XXX 这种类型的变量拥有无穷无尽种可能的名字，所以

它们并不对应任何存放值的容器。而且这种变量在 Nginx 核心中

是经过特别处理的，第三方 Nginx 模块是不能提供这样充满魔法

的内建变量的。

类似 $arg_XXX 的内建变量还有不少，比如用来取 cookie 值的

$cookie_XXX 变量群，用来取请求头的 $http_XXX 变量群，以及

用来取响应头的 $sent_http_XXX 变量群。这里就不一一介绍了，

感兴趣的读者可以参考 ngx_http_core 模块的官方文档。

需要指出的是，许多内建变量都是只读的，比如我们刚才介绍的

$uri 和 $request_uri. 对只读变量进行赋值是应当绝对避免的，因

为会有意想不到的后果，比如：

? location /bad {

? set $uri /blah;

? echo $uri;

? }

这个有问题的配置会让 Nginx 在启动的时候报出一条令人匪夷所

思的错误：

[emerg] the duplicate "uri" variable in ...

如果你尝试改写另外一些只读的内建变量，比如 $arg_XXX 变

量，在某些 Nginx 的版本中甚至可能导致进程崩溃。

Nginx 变量漫谈（三）变量漫谈（三）

也有一些内建变量是支持改写的，其中一个例子是 $args. 这个变

量在读取时返回当前请求的 URL 参数串（即请求 URL 中问号后

面的部分，如果有的话），而在赋值时可以直接修改参数串。我

们来看一个例子：

location /test {

set $orig_args $args;

set $args "a=3&b=4";

echo "original args: $orig_args";

echo "args: $args";

}

这里我们把原始的 URL 参数串先保存在 $orig_args 变量中，然

后通过改写 $args 变量来修改当前的 URL 参数串，最后我们用

echo 指令分别输出 $orig_args 和 $args 变量的值。接下来我们

这样来测试这个 /test 接口：

$ 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 请求参数串。

剩余59页未读，继续阅读

StemonZhang

粉丝: 9
资源: 7

Nginx入门教程：变量与配置指令探索

Nginx入门&进阶.pdf

nginx入门到精通

Nginx 入门

nginx入门

nginx入门学习资料.pdf

Nginx入门到入门笔记

nginx入门PPT

nginx入门txt

nginx入门案例

Nginx入门指南

最新资源