thinkphp中.env配置生效需满足：所有配置项必须显式调用env()并设默认值，变量名全大写加下划线，.env格式严格（等号无空格、值含特殊字符需单引号），app_env被系统预设时会跳过.env，cli下推荐用闭包延迟解析。
env() 必须出现在配置文件里，不能补救式写在控制器中
改完 .env 发现数据库连不上，跑去控制器里写 env('DB_HOST') 测试返回正常——这只能说明环境变量“读得出来”，不代表配置已生效。ThinkPHP 的配置加载是一次性行为：启动时执行所有 config/*.php 文件，结果缓存起来。如果 config/database.php 里还是 'hostname' => '127.0.0.1' 这种硬编码，.env 再怎么改也白搭。
必须把每个字段都显式替换成 env() 调用，并带默认值：
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),
],
],
];
-
env()第二个参数不可省略，空字符串''比null更安全，尤其对DB_PREFIX这类可能为空的字段 - 变量名必须全大写+下划线：
DB_PWD不能写成db_pwd或db_password，否则返回false - 配置缓存开启后（如运行过
php think optimize:config），改了.env必须手动清缓存：php think clear:config
.env 文件格式错一个空格，整个就静默失效
vlucas/phpdotenv 对格式极其敏感，报错不提示具体哪行错了，而是直接 fallback 到默认值，或抛出 Dotenv\Exception\InvalidPathException（其实跟路径无关）。
- 等号两侧**绝对不能有空格**：
DB_HOST = 127.0.0.1❌，必须写成DB_HOST=127.0.0.1✅ - 值含空格或特殊字符（如
@、!、#）必须用单引号包裹：DB_PWD='pass@123!'✅；双引号会被 shell 展开，不推荐 - 注释只能独占一行且以
#开头，前面不能有空格；DB_HOST=127.0.0.1 # local这种行末注释不支持 - 变量名只能是字母、数字、下划线，且不能以数字开头：
API_V1_URL✅，1API_URL❌
APP_ENV 被系统变量预设时，.env 直接被跳过
本地开发一切正常，一上服务器配置就“不生效”？大概率是 Nginx、CLI 或 php-fpm 已经设置了 APP_ENV=prod。ThinkPHP 的逻辑是：只要 getenv('APP_ENV') 有值，就不再读取 .env 文件。
验证方式：在控制器里输出 getenv('APP_ENV') 和 env('APP_ENV')，两者不一致就说明被系统变量覆盖了。
- Linux/macOS 下检查是否执行过
export APP_ENV=prod；Windows 下检查set APP_ENV=prod - Nginx 配置中若有
fastcgi_param APP_ENV "prod"，会强制覆盖 - Apache 的
SetEnv APP_ENV production同样优先级更高 - 若需保留
.env，可在 Web 服务器配置中移除APP_ENV注入，或改用.env.prod等命名文件配合APP_ENV值自动加载
配置文件里用闭包延迟解析，避免 CLI 场景失效
在命令行执行 php think migrate 时，config/database.php 里的 env('DB_HOST') 有时返回空——因为 ThinkPHP 配置加载早于 .env 加载完成，尤其在 CLI 模式下更明显。
正确做法不是放弃 env()，而是用闭包延迟执行：
'hostname' => function() {
return env('DB_HOST', '127.0.0.1');
},
- TP6.1+ 原生支持这种写法，框架会在真正需要该配置项时才调用闭包
- 不要写成顶层键值对直接调用
env()，那是“静态求值”，时机不对 - 也可在
app/common.php或服务提供者中用Config::set()覆盖关键项，但闭包更轻量、更聚焦
多环境配置真正的复杂点不在语法，而在加载时机与作用域边界——CLI、Swoole、FPM 子进程各自持有一份环境变量快照，改了主进程的 $_ENV 不会自动同步过去。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
