nginx if 指令的具體使用

更新時間：2024年05月11日 09:33:28 作者：sayyy

if指令該指令用來支持條件判斷,并根據(jù)條件判斷結(jié)果選擇不同的Nginx配置,本文主要介紹了nginx if 指令的具體使用,具有一定的參考價值,感興趣的可以了解一下

nginx if 指令
直接判斷變量
判斷是否等于字符串
判斷變量是否匹配正則表達式
文件及目錄判斷
示例1：判斷index.html是否存在
示例2：判斷URL中是否存在某個參數(shù)Parameter
示例3：判斷URI中是否為某個特定路徑
示例4：開放白名單內(nèi)的功能，其余功能禁止訪問
示例5：if-else
示例6：多重if判斷
參考

nginx if 指令

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

if指令的格式如下：

if (condition) { ... }

condition可以是如下類型：

變量名，如果變量的值是空字符串或者0表示false
變量使用“=”和“!=”來跟字符串比較
可以是正則表達式
檢查文件是否存在使用“-f” 和 “!-f”
檢查目錄是否存在使用 “-d” 和 “!-d”
檢查文件、目錄、符號鏈接是否存在使用 “-e” 和 “!-e”
檢查是否是可執(zhí)行文件使用“-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;
}

判斷變量是否匹配正則表達式

使用 “~” 和 “!~” 操作符判斷變量是否匹配正則表達式。

~：判斷時區(qū)分字符大小寫
~*：判斷時不區(qū)分字符大小寫
!~：判斷時區(qū)分字符大小寫
!~*：判斷時不區(qū)分字符大小寫

if ($http_user_agent ~ MSIE) {
    rewrite ^(.*)$ /msie/$1 break;
}

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

文件及目錄判斷

“-f”, “!-f”：判斷指定的路徑是否為存在且為文件；
“-d”, “!-d”：判斷指定的路徑是否為存在且為目錄；
“-e”, “!-e”：判斷指定的路徑是否存在，文件或目錄均可；
“-x”, “!-x”：判斷指定路徑的文件是否存在且可執(zhí)行；

示例1：判斷index.html是否存在

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

示例2：判斷URL中是否存在某個參數(shù)Parameter

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

示例3：判斷URI中是否為某個特定路徑

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

示例4：開放白名單內(nèi)的功能，其余功能禁止訪問

# 白名單開關(guān)。false，打開；true，關(guān)閉。
set $isInWhiteList 'false';
# 白名單1：統(tǒng)計
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完了，根據(jù)結(jié)果做相應處理
	if ($flag = '11') {
		...
	}
	if ($flag = '12') {
		...
	}
	if ($flag = '21') {
		...
	}
	if ($flag = '22') {
		...
	}
	
	location / {
		...
	}
}