Apache全局环境变量必须在httpd.conf或其包含文件中设置，.htaccess仅限目录级生效；SetEnvIf支持条件匹配实现请求级分支，PHP需PassEnv透传且用getenv()读取，Python WSGI则需手动设置或通过请求头注入。

Apache 的 SetEnv 本身不支持“动态分支”逻辑，它只是静态设置一个环境变量值；真正实现应用层动态分支，需要结合 Apache 配置（如 SetEnvIf、RewriteCond）与后端语言（如 PHP、Python WSGI）协同完成。关键在于：变量必须在正确作用域设置，并被后端可靠读取。

全局变量必须写在 httpd.conf 或包含文件中

要让所有虚拟主机、所有请求都继承某个基础变量（例如 APP_ENV=production），必须在主配置上下文中定义：

• 放在 httpd.conf 文件顶部或 Include conf/env.conf 引入的独立文件里
• 不能依赖 .htaccess —— 它只影响当前目录及子目录，且需 AllowOverride FileInfo，生产环境通常禁用
• 推荐使用 <IfModule mod_env.c> 包裹，确保模块已加载

用 SetEnvIf 实现请求级条件分支

静态 SetEnv 无法识别用户、路径或请求头差异，这时要用 SetEnvIf 做运行时判断：

Apache Superset Dashboard and SQL Exploration Skill

Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。

下载

• 根据 Host 设置不同站点标识：SetEnvIf Host "^(www\.)?site-a\.com$" SITE_ID=a
• 根据请求路径启用调试模式：SetEnvIf Request_URI "^/debug" DEBUG_MODE=1
• 根据 User-Agent 标记移动端：SetEnvIf User-Agent "Mobile|Android|iPhone" IS_MOBILE=1

注意：正则中的点号 . 必须转义为 \.，否则匹配任意字符；多条规则按顺序执行，同名变量会被后设值覆盖。

PHP 如何稳定读取这些变量

Apache 设置的环境变量默认不会自动传给 PHP-FPM 进程，必须显式透传：

• 在 httpd.conf 或 VirtualHost 中添加：PassEnv APP_ENV SITE_ID DEBUG_MODE
• PHP 中统一用 getenv('APP_ENV') 或 $_SERVER['APP_ENV'] 获取（二者行为可能不同，取决于 variables_order 配置）
• 避免在 .htaccess 中用 SetEnv 设变量再指望 PHP 读到——除非你用的是已淘汰的 mod_php

WSGI/Django 等 Python 应用的适配方式

Python 的 WSGI 应用不通过 PassEnv 继承 Apache 变量，而是由 WSGI 脚本直接控制环境：

• 在 wsgi.py 开头手动设置：os.environ['APP_ENV'] = 'production'
• 或根据 Apache 传入的 HTTP_X_APP_ENV 请求头解析：environ.get('HTTP_X_APP_ENV', 'dev')
• 更健壮的做法是：用 SetEnvIf + RequestHeader set 把变量注入请求头，再在 WSGI 层读取