2
0

Nginx-3

2026-09-12
Nginx-3

Nginx内置变量

常见的内置变量有如下几种:

$args,此变量与请求行中的参数相等

$document_root,此变量等同于当前请求的root指令指定的值

$uri,表示不带请求参数的当前URI,$uri不包含主机名。

$document_uri,此变量与$uri含义一样。

$host,此变量与请求头部中“Host”行指定的值一致。

$limit_rate,此变量用来设置限制连接的速率。

$request_method,此变量等同于request的method,通常是“GET”或“POST”。

$remote_addr,此变量表示客户端IP地址。

$remote_port,此变量表示客户端端口。

$remote_user,此变量等同于用户名,由ngx_http_auth_basic_module认证。

$request_filename,此变量表示当前请求的文件的路径名,由root或alias和URI request组合而成。

$request_uri,此变量表示含有参数的完整的初始URI。

$query_string,此变量与$args含义一致。

$server_addr #表示请求的服务器地址。

$server_name,此变量表示请求到达的服务器名。默认是localhost

$server_port,此变量表示请求到达的服务器的端口号。

$request_uri #包含请求参数的原始URI,不包含主机名,由客户端请求决定,不能修改。

if指令

if指令用于判断一个条件,如果条件成立,则后面的大括号内的语句将执行,相关配置从上级继承。if指令的使用方法如下:

语法:if (condition) { … }

默认值:none

使用字段:server, location

在默认情况下,if指令默认值为空,可在nginx配置文件的server、location部分使用,另外,if指令可以在判断语句中指定正则表达式或通过nginx内置变量匹配条件等,相关匹配条件如下:

正则表达式匹配规则:

~ 表示区分大小写匹配

~* 表示不区分大小写匹配

!~和!~*分别表示区分大小写不匹配及不区分大小写不匹配

文件及目录匹配:

-f和!-f用来判断是否存在文件

-d和!-d用来判断是否存在目录

-e和!-e用来判断是否存在文件或目录

-x和!-x用来判断文件是否可执行

rewrite指令

Nginx通过ngx_http_rewrite_module模块支持url重写、支持if条件判断,但要使用rewrite功能,需要PCRE支持,应在编译nginx时指定PCRE源码目录。rewrite的使用语法如下:

语法:rewrite regex flag

默认值:none

使用字段:server, location, if

rewrite指令的最后一项参数为flag标记,其支持的flag标记主要有以下几种:

last, 相当于Apache里的[L]标记,表示完成rewrite之后搜索相应的URI或location。

break,表示终止匹配, 不再匹配后面的规则。

redirect,将返回302临时重定向,在浏览器地址栏会显示跳转后的URL地址。

permanent,将返回301永久重定向,在浏览器地址栏会显示跳转后的URL地址。

其中,last和break用来实现URL重写,浏览器地址栏中的URL地址不变。

示例配置,仅列出整个配置中的location部分:

location ~ ^/new/ {
        rewrite ^/new/(.*)$  /old/$1  break;

        proxy_pass  http://www.tb.com;

 }

在这个例子中,假定访问的域名是www.newtb.com,那么当访问www.newtb.com/new/web.html时,nginx可以通过rewrite将页面重定向到www.tb.com/old/web.html,由于是通过反向代理实现了重定向,因此页面重写后不会引起浏览器地址栏中URL的变化。这个功能在新旧网站交替的时候非常有用。

set指令

通过set指令可以设置一个变量并为其赋值,其值可以是文本、变量或它们的组合。也可以使用set定义一个新的变量,但是不能使用set设置$http_xxx头部变量的值。

set使用语法如下:

语法:set variable value

默认值:none

使用字段:server, location, if

示例配置,仅列出整个配置中的location部分:

location / {
       if ($query_string ~ "id=(.*)") {

        set  $myid  $1; 

        rewrite ^/app.php$ /m-$myid.html?;          

        }

} 

这是一个伪静态的例子,假如访问的域名是www.abc.com,那么上面这个配置要实现的功能是将请求为www.abc.com/app.php?id=100重定向到www.abc.com/m-100.html。

这里用到了if指令和set指令,并且还使用了$query_string变量,此变量用于获取请求行中的参数,if指令用来判断请求参数中的id值,然后通过set指令定义了一个变量$myid,并将$query_string变量中获取到的id值赋给$myid,最后通过rewrite指令进行了url重写。

这里需要注意的是:rewrite只能针对请求的uri进行重写,而对请求参数无能为力,/app.php问号后面的“id=100”是请求参数,要获取到参数,需要使用nginx的一个内部变量$query_string,这样在重写的时候只需把$query_string变量追加到重写的uri后面即可,另外,为了防止uri中的参数追加到重写后的uri上,需要在rewrite最后面加个问号。

break指令

break的用法在前面的介绍中其实已经出现过,它表示完成当前设置的规则后,不再匹配后面的重写规则。break使用语法如下:

语法:break

默认值:none

使用字段:server, location, if

下面是一个应用实例,仅列出整个配置中的server部分:

server {
        listen       80;
        server_name  www.tb.cn;
        if ($host != 'www.tb.cn') {
        rewrite ^/(.*)$ http://www.tb.cn/error.txt
        break;
        rewrite ^/(.*)$ http://www.tb.cn/$1 permanent;
        }
}

在这个例子中,定义了一个域名www.tb.cn,当访问的域名不是www.tb.cn时,会将请求重定向到“http://www.tb.cn/error.txt” 页面, 由于设置了break指令,因此下面的rewrite规则不再被执行,直接退出。而当访问的域名是www.tb.cn时,将直接执行最后一个rewrite指令。

这里需要重点掌握一下break的功能,它表示完成当前设置的规则后,不再匹配后面的重写规则,也就是当满足if指令后,直接退出,而不会去执行最后一个rewrite指令的规则。

虚拟主机功能

每个虚拟主机就是一个独立的站点,对应一个域名,如果需要多个域名指向到一个IP上时,通过虚拟主机功能可以轻松实现。

下面在Nginx中创建三个虚拟主机,需要说明的是,这里仅仅列出了虚拟主机配置部分。

http {
	server {
	listen          80;
	server_name     www.domain1.com;
	access_log      logs/domain1.access.log main;
	location / {
	index index.html;
	root  /data/www/domain1.com;
	}
  }
	server {
	listen          80;
	server_name     www.domain2.com;
	access_log      logs/domain2.access.log main;
	location / {
	index index.html;
	root  /data/www/domain2.com;
	}
  }
  include    /usr/local/nginx/conf/vhosts/www.domain3.conf;
}

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或者给予支持!