TP5中环境变量必须在config/*.php文件中用env('KEY','default')显式调用才生效，putenv()或$_ENV运行时设置无效；.env需根目录、UTF-8无BOM、等号无空格、值含特殊字符须单引号包裹，修改后必须执行php think clear:config清缓存。
TP5里不能靠自定义函数“写”环境变量
PHP 的 putenv() 和 $_ENV 是运行时变量，不是 ThinkPHP 配置系统的一部分。你在控制器或公共函数里写 putenv('DB_HOST=192.168.1.100') 或 $_ENV['DB_HOST'] = '192.168.1.100'，对框架后续加载的配置（比如 config/database.php）完全无效——因为配置已在 App 初始化阶段一次性解析并缓存了。
常见错误现象：
-
env('DB_HOST')在控制器里返回新值，但数据库连的还是旧地址 - 执行
php think clear:config后，自定义设置彻底丢失 - CLI 命令下看似生效，Web 请求中却没反应（因 PHP-FPM 进程隔离）
真正起作用的只有配置文件里的 env() 调用
ThinkPHP 5 的环境变量生效逻辑非常明确：只在 config/ 目录下的 PHP 配置文件中，通过 env('KEY', 'default') 显式读取，才参与最终配置生成。这个调用必须出现在配置数组定义过程中，且不能被包裹在条件判断或函数体内延迟执行。
正确写法示例（config/database.php）：
return [
'connections' => [
'mysql' => [
'hostname' => env('DB_HOST', '127.0.0.1'),
'database' => env('DB_NAME', ''),
'username' => env('DB_USER', 'root'),
'password' => env('DB_PWD', ''),
'hostport' => env('DB_PORT', 3306),
'prefix' => env('DB_PREFIX', ''),
],
],
];
关键点：
-
env()必须直接作为数组值，不能是变量赋值后再引用 - 第二个参数不能为空（
null），推荐用空字符串''或明确默认值 - 变量名必须全大写、下划线分隔，如
DB_PWD，不能写成db_pwd或database_password - 修改后必须运行
php think clear:config，否则缓存未更新，改了也白改
.env 文件格式错一个字符就静默失效
vlucas/phpdotenv 解析器对格式极其敏感，出错不报行号，只 fallback 到默认值，导致你以为改了但其实没加载。
典型格式陷阱：
-
DB_HOST = 127.0.0.1❌（等号两侧有空格）→ 必须写成DB_HOST=127.0.0.1✅ -
DB_PWD=pass@123!❌（特殊字符未包裹）→ 必须写成DB_PWD='pass@123!'✅ -
# DB_HOST=127.0.0.1✅（独占一行注释）；DB_HOST=127.0.0.1 # local❌（行末注释不支持） -
1DB_PORT=3306❌（变量名不能数字开头）；DB_PORT_1=3306✅
验证是否加载成功最直接的方式：var_dump(env('DB_HOST')) 放在 config/database.php 开头，看输出是否符合预期。
想动态切换？别碰 env()，改配置文件或环境变量注入
如果真需要运行时切换（比如多租户场景），env() 不是设计来干这事的。可行路径只有两条：
- Web 服务器层注入：Nginx/Apache 配置中用
fastcgi_param或SetEnv传入真实环境变量，确保variables_order包含E - Docker/K8s 场景：用
-e DB_HOST=xxx启动容器，配合.env仅作本地开发兜底
任何试图在 TP5 应用内“动态写环境变量再让 config 重读”的方案，本质都是绕过框架加载机制，最终会卡在缓存、进程隔离或初始化时机上。复杂点在于：你得同时控制 PHP 运行时、框架生命周期、Web 服务器变量传递三者，缺一不可。
