thinkphp的.env文件中布尔值必须写为1/0或on/off，不能写true/false；因为parse_ini_file()将其视为字符串，需用filter_var($val, filter_validate_boolean)显式转换才能正确判断。
ThinkPHP 的 .env 文件里布尔值不能写 true 或 false
直接写 DEBUG=true 或 APP_DEBUG=false 是无效的——ThinkPHP 的 Env 类底层用的是 parse_ini_file()（默认 INI_SCANNER_NORMAL 模式），它**不识别 true/false 为布尔类型**，一律当字符串处理。所以 env('APP_DEBUG') 拿到的是字符串 "true"，不是 PHP 的 true，条件判断会出错。
.env 中布尔配置必须写成 on/off 或 1/0
ThinkPHP 官方文档虽未显式强调，但其源码中对布尔环境变量的解析逻辑实际依赖于 filter_var($value, FILTER_VALIDATE_BOOLEAN)（见 think\Env::get()），该函数只把以下值转为 true：1、"1"、"on"、"yes"、"true"（注意：小写且带引号时才可能被识别，但受 ini 解析限制，不推荐）；而 "false" 字符串本身会被转成 false，但前提是它没被 ini 解析器提前截断或误判。
最稳妥、无歧义的写法是：
-
APP_DEBUG=1（等价于true） -
APP_DEBUG=0（等价于false） - 或使用
APP_DEBUG=on/APP_DEBUG=off
避免写 APP_DEBUG=true、APP_DEBUG=False、APP_DEBUG=TRUE，大小写混用或单词形式在不同 PHP 版本和 ini 配置下行为不一致。
代码里读取后要显式转换，别依赖自动类型判断
即使你写了 APP_DEBUG=1，env('APP_DEBUG') 返回的仍是字符串 "1"。ThinkPHP 内部在关键位置（如调试开关）做了 filter_var(..., FILTER_VALIDATE_BOOLEAN) 转换，但你自己写的逻辑不会自动转换。
所以业务代码中应这样写：
if (filter_var(env('APP_DEBUG'), FILTER_VALIDATE_BOOLEAN)) {
// 开启调试
}
而不是：
if (env('APP_DEBUG')) { // ❌ 字符串 "0" 也会为 true
// ...
}
常见坑：用 env('CACHE_ON') === true 判断——永远不成立，因为左边是字符串。
验证是否生效：用 var_dump(env('KEY')) 看原始值
遇到配置不生效，第一反应不是改框架，而是确认 .env 值有没有被正确读出来：
- 确保
.env文件位于项目根目录（与think文件同级） - 确保没有被
.gitignore或部署脚本意外删除 - 执行
php think clear:config清除配置缓存（开发环境也要清） - 加一行
var_dump(env('APP_DEBUG'));在入口或命令行测试，看输出是string(1) "1"还是string(4) "true"
如果输出是 "true"，说明你写错了格式；如果是 "1" 但逻辑没走通，大概率是你忘了用 filter_var 转换。
环境变量的“真假”不是靠写得像布尔，而是靠写得让 PHP 能稳稳转成布尔——写 1/0 最省心，也最不容易被团队新人搞错。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
