database.php中直接调用env()会返回null，因环境变量尚未初始化；正确做法是用闭包延迟执行env()，如'hostname' => function() { return env('DB_HOST', '127.0.0.1'); }，确保加载时机正确。
database.php 里直接调用 env() 会返回 null
因为 database.php 被加载时，ThinkPHP 尚未完成环境变量的完整初始化——env() 函数依赖的底层 $_ENV 和 .env 文件解析逻辑，在 database.php 被 Config::load() 加载时还没跑完。这时候调用 env('DB_HOST')，基本等于读一个空数组，结果就是 null 或空字符串。
常见现象：数据库连接报错 SQLSTATE[HY000] [1045] Access denied for user ''@'localhost'，用户名密码全丢了。
- 别在
database.php顶层直接写env('DB_NAME') - 也不要用
getenv('DB_NAME')—— 它不走 ThinkPHP 的.env解析逻辑，读不到 .env 里的值（除非你手动putenv()过） - 更不要试图在
database.php里 requireEnv::load()—— 会破坏框架启动顺序，引发不可预知错误
正确做法：用闭包延迟执行 env()
ThinkPHP 6+ 的配置系统支持「闭包式配置」：把需要动态获取的值写成匿名函数，等真正要用数据库配置时才执行，此时 env() 已就绪。
示例（config/database.php）：
立即学习“PHP免费学习笔记（深入）”；
'mysql' => [
'type' => 'mysql',
'hostname' => function () {
return env('DB_HOST', '127.0.0.1');
},
'database' => function () {
return env('DB_NAME', 'thinkphp');
},
'username' => function () {
return env('DB_USERNAME', 'root');
},
'password' => function () {
return env('DB_PASSWORD', '');
},
// 其他项保持字符串即可（如 port、charset），无需闭包
'hostport' => env('DB_PORT', 3306),
'charset' => 'utf8mb4',
],
注意：hostport、charset 这类纯数值或固定字符串可以直接用 env()，因为它们不参与数据库连接初始化的早期路径；但 hostname、username 等关键连接参数必须用闭包包裹。
替代方案：改用 config() + 独立配置文件
如果项目有多个数据库或环境差异大，硬塞闭包会让 database.php 变臃肿。更清晰的做法是抽离为独立配置文件，比如 config/database_extra.php：
<?php
return [
'connections' => [
'mysql' => [
'hostname' => env('DB_HOST', '127.0.0.1'),
'database' => env('DB_NAME', 'thinkphp'),
'username' => env('DB_USERNAME', 'root'),
'password' => env('DB_PASSWORD', ''),
],
],
];
然后在 database.php 里合并进去：
'mysql' => array_merge([
'type' => 'mysql',
'hostport' => env('DB_PORT', 3306),
'charset' => 'utf8mb4',
], config('database_extra.connections.mysql')),
这样既保持了可读性，又规避了初始化时机问题——config() 调用本身是延迟的，且确保了环境变量已加载。
验证是否生效的最快方式
别只靠连库成功来判断，容易漏掉静默 fallback（比如 env('DB_NAME', 'thinkphp') 在取不到时自动用了默认值，你以为对了，其实没读到 .env）。
- 在控制器里加一行：
dump(env('DB_USERNAME'));，看输出是不是你 .env 里写的值 - 检查
.env文件权限和位置：必须放在根目录（与public同级），且不能有 BOM 头 - 确认
APP_ENV设对了：APP_ENV=production时，env()默认只读.env.production，不是.env
闭包写法看着多两行，但它堵死了最常踩的「配置加载时机」漏洞；而抽离配置文件的方式更适合中大型项目——复杂点在于要多维护一个文件，但换来的是逻辑清晰和后期可扩展性。
