nginx if 指令的具体使用

 更新时间:2024年05月11日 09:33:28   作者:sayyy  
if指令该指令用来支持条件判断,并根据条件判断结果选择不同的Nginx配置,本文主要介绍了nginx if 指令的具体使用,具有一定的参考价值,感兴趣的可以了解一下

nginx if 指令

参考这里

Syntax:	if (condition) { ... }
Default:	—
Context:	server, location

if指令的格式如下:

if (condition) { ... }

condition可以是如下类型:

  • 变量名,如果变量的值是空字符串或者0表示false
  • 变量使用“=”和“!=”来跟字符串比较
  • 可以是正则表达式
  • 检查文件是否存在使用“-f” 和 “!-f”
  • 检查目录是否存在使用 “-d” 和 “!-d”
  • 检查文件、目录、符号链接是否存在使用 “-e” 和 “!-e”
  • 检查是否是可执行文件使用“-x” 和 “!-x”

if指令不支持多条件、不支持嵌套、不支持else,与常见的条件表达式不同的特点是,if指令使用单个等号=而不是双等号==表达等值比较。

直接判断变量

  • 如果变量值是空字符串或者"0"时,判定为false;否则,判定为true。
  • 1.0.1版本前,任何以"0"开头的字符串,判定为false。
if ($slow) {
    limit_rate 10k;
}

if ($invalid_referer) {
    return 403;
}

判断是否等于字符串

使用 “=” 和 “!=” 操作符判断是否等于字符串

if ($request_method = POST) {
    return 405;
}

判断变量是否匹配正则表达式

使用 “~” 和 “!~” 操作符判断变量是否匹配正则表达式。

  • ~:判断时区分字符大小写
  • ~*:判断时不区分字符大小写
  • !~:判断时区分字符大小写
  • !~*:判断时不区分字符大小写
if ($http_user_agent ~ MSIE) {
    rewrite ^(.*)$ /msie/$1 break;
}

if ($http_cookie ~* "id=([^;]+)(?:;|$)") {
    set $id $1;
}

文件及目录判断

  • “-f”, “!-f”:判断指定的路径是否为存在且为文件;
  • “-d”, “!-d”:判断指定的路径是否为存在且为目录;
  • “-e”, “!-e”:判断指定的路径是否存在,文件或目录均可;
  • “-x”, “!-x”:判断指定路径的文件是否存在且可执行;

示例1:判断index.html是否存在

location =/index.html {
	if (!-f "$document_root/index.html") {
	    rewrite ^(.*)$  /index2.html;
	}
}

示例2:判断URL中是否存在某个参数Parameter

if ($query_string ~* ".*(?:^|\?|&)method=autoGenerateIndex(?:(?:&.*)|$)") { 
	...
}

示例3:判断URI中是否为某个特定路径

if ($request_uri ~* "^/app/stat/"){
    ...
}

示例4:开放白名单内的功能,其余功能禁止访问

# 白名单开关。false,打开;true,关闭。
set $isInWhiteList 'false';
# 白名单1:统计
if ($request_uri ~* "^/app/stat/"){
    set $isInWhiteList  'true';
}
# 白名单2:ajax接口
if ($request_uri ~* "^/app/ajax/"){
    set $isInWhiteList 'true';
}
# 采用白名单方式放行功能
location /app {
    if ($isInWhiteList != 'true') {
        rewrite ^/ /deny;
    }
    proxy_pass  http://127.0.0.1:8080;
}

# 禁止访问
location =/deny {
    deny all;  
}

示例5:if-else

# 条件:if
if ($request_uri ~* "abc"){
	set $flag '${flag}1';
}
# 条件:else
if ($request_uri !~* "abc"){
	set $flag '${flag}2';
}

示例6:多重if判断

server {
	...
	
	set $flag "";
	
	# 条件1:if
	if ($request_uri ~* "abc"){
		set $flag '${flag}1';
	}
	# 条件1:else
	if ($request_uri !~* "abc"){
		set $flag '${flag}2';
	}
	
	# 条件2:if
	if ($query_string ~* ".*(?:^|\?|&)method=autoGenerateIndex(?:(?:&.*)|$)") { 
		set $flag '${flag}1';
	}
	# 条件2:else
	if ($query_string !~* ".*(?:^|\?|&)method=autoGenerateIndex(?:(?:&.*)|$)") { 
		set $flag '${flag}2';
	}
	
	# 多重if完了,根据结果做相应处理
	if ($flag = '11') {
		...
	}
	if ($flag = '12') {
		...
	}
	if ($flag = '21') {
		...
	}
	if ($flag = '22') {
		...
	}
	
	location / {
		...
	}
}

参考

https://nginx.org/en/docs/http/ngx_http_rewrite_module.html#if

Nginx的多重if判断

到此这篇关于nginx if 指令的具体使用的文章就介绍到这了,更多相关nginx if 指令内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Nginx配置防盗链保护静态资源的详细教程

    Nginx配置防盗链保护静态资源的详细教程

    防盗链是一种通过检查 HTTP 请求头中的 Referer 字段来限制资源访问的技术,常用于保护图片、视频等静态资源不被其他网站直接引用,以下是Nginx防盗链的原理、配置步骤以及测试方法,帮助你快速配置和验证防盗链功能,需要的朋友可以参考下
    2025-02-02
  • 基于Nginx搭建WebDAV服务的详细过程

    基于Nginx搭建WebDAV服务的详细过程

    在搭建 Joplin 笔记服务的时候,发现了可以通过 WebDAV 服务来实现云笔记的功能,所以本篇就来介绍一下,怎么快速搭建 WebDAV 服务,需要的朋友可以参考下
    2022-12-12
  • Nginx用户认证配置方法详解(域名/目录)

    Nginx用户认证配置方法详解(域名/目录)

    Nginx超级强大它可以单独为一个域名设置用户认证,方法也很简单我们只要生成用户认证的用户名和密码,然后再Nginx添加auth认证配置即可
    2013-08-08
  • nginx访问报403错误的几种情况详解

    nginx访问报403错误的几种情况详解

    最近访问新安装的nginx,发现报403错误,所以这篇文章主要给大家介绍了关于nginx访问报403错误的几种情况,文中通过图文介绍的非常详细,需要的朋友可以参考下
    2022-07-07
  • Nginx服务器的反向代理proxy_pass配置方法讲解

    Nginx服务器的反向代理proxy_pass配置方法讲解

    这篇文章主要介绍了Nginx服务器的反向代理proxy_pass配置方法讲解,包括经常被提到的url的/问题的相关说明,需要的朋友可以参考下
    2016-01-01
  • Nginx启动显示80端口占用问题的解决方案

    Nginx启动显示80端口占用问题的解决方案

    这篇文章主要介绍了Nginx启动显示80端口占用问题的解决方案,文中通过代码示例和图文讲解的非常详细,对大家解决问题有一定的帮助,需要的朋友可以参考下
    2024-04-04
  • Nginx服务器中配置非80端口的端口转发方法详解

    Nginx服务器中配置非80端口的端口转发方法详解

    这篇文章主要介绍了Nginx服务器中配置非80端口的端口转发方法详解,文中使用到了Nginx中的proxy_pass配置项,需要的朋友可以参考下
    2016-04-04
  • 详解Nginx虚拟主机配置中server_name的具体写法

    详解Nginx虚拟主机配置中server_name的具体写法

    这篇文章主要介绍了Nginx虚拟主机配置中server_name的具体写法,server_name服务器名是虚拟主机中必须配置的重要参数,需要的朋友可以参考下
    2016-03-03
  • nginx不允许iframe嵌套报表的解决过程

    nginx不允许iframe嵌套报表的解决过程

    该文章主要了Nginx配置中X-Frame-Options设置导致iframe嵌套页面出现问题的解决方法,具体表现为Nginx配置禁止了iframe嵌套,通过编辑Nginx配置文件,添加或修改相应指令,保存并重新加载配置文件即可解决问题,该文章为个人经验总结,仅供参考
    2026-05-05
  • Nginx+Proxy_cache高速缓存配置

    Nginx+Proxy_cache高速缓存配置

    本文主要介绍了Nginx+Proxy_cache高速缓存配置,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2026-01-01

最新评论