如何利用 set $variable 在 server 块定义局部变量优化配置逻辑-Nginx-PHP中文网

Nginx 通过 set 指令支持运行时局部变量，仅限当前请求生效，需在使用前初始化；推荐用 map 替代 if+set 实现高效安全的条件映射，变量可用于 rewrite、proxy_pass 等场景。

如何利用 set $variable 在 server 块定义局部变量优化配置逻辑

Nginx 本身不支持传统编程语言中的变量赋值和逻辑运算，但通过 set 指令（需启用 ngx_http_rewrite_module，默认已编译）可以在 server 块中定义**运行时局部变量**，用于简化重复判断、统一路径处理、动态拼接值等场景。关键在于理解它的作用域、执行时机和限制。

变量只在当前请求生命周期内有效

set $my_var "value"; 定义的变量仅对当前 HTTP 请求生效，不会跨请求共享，也不影响其他 worker 或连接。它不是全局配置变量（如 env 或 map），也不是编译期常量。常见误用是试图在 log_format 外直接引用未赋值的变量，或期望它在 proxy_pass 后还能被下游读取——实际不能。

变量必须在使用前通过 set、map 或内置变量（如 $host）初始化，否则为空字符串
同一请求中多次 set 同名变量，以最后一次为准
不能在 if 块外直接依赖 if 内的 set（因 if 是惰性执行，且有作用域陷阱）

用 set 避免重复写长路径或条件表达式

当多个指令需共用某个计算结果（如基于域名的根路径、带版本号的静态资源前缀），可用 set 提前定义，提升可读性和可维护性：

server {
    server_name example.com www.example.com;
<pre class="brush:php;toolbar:false;"># 统一提取主域名作为基础路径标识
set $base_path "/var/www/html";
if ($host ~ ^www\.(.+)$) {
    set $base_path "/var/www/html/www";
}

location /static/ {
    alias $base_path/static/;
}
location / {
    root $base_path;
    try_files $uri $uri/ /index.html;
}

}

注意：if + set 组合虽常用，但要避免在 if 中做复杂逻辑；更推荐用 map 实现无副作用的映射（见下条）。

配合 map 实现安全、高效的条件变量（推荐优先级高于 if+set）

map 指令在配置加载时预编译，性能更好，且规避了 if 的执行顺序问题。适合根据请求头、域名、参数等生成变量：

Scale AI

Scale AI是一款AI学习资源工具，AI机器学习标注训练平台。

下载

map $host $app_root {
    default          "/var/www/default";
    example.com      "/var/www/app-v1";
    ~^staging\..+$   "/var/www/app-staging";
    ~^v2\.example\.com "/var/www/app-v2";
}
<p>server {
listen 80;
server_name example.com staging.example.com v2.example.com;</p><pre class="brush:php;toolbar:false;">root $app_root;
location /api/ {
    proxy_pass http://backend;
    proxy_set_header X-App-Root $app_root; # 也可透传给后端
}

}

这样既避免了 if 嵌套，又让变量逻辑集中、清晰、可测试。

set 变量在 rewrite 和 proxy_pass 中的典型应用

动态构造重定向地址或代理目标时，set 能减少硬编码：

将带参 URL 重写为干净路径：set $clean_uri $1; rewrite ^/item/(\d+)$ /item?id=$clean_uri last;
根据请求头切换上游：if ($http_x_env = "prod") { set $upstream "https://prod-api"; } if ($http_x_env = "dev") { set $upstream "https://dev-api"; } proxy_pass $upstream;（注意：此处 if 仍存在风险，生产建议改用 map）
拼接带时间戳的缓存键：set $cache_key "$host$request_uri|$msec";，再用于 proxy_cache_key

不复杂但容易忽略：所有 set 变量在 proxy_pass 中若含协议（如 https://），必须确保 Nginx 编译时启用了对应模块（如 http_ssl_module）；纯域名或 IP 则无此限制。