thinkphp多环境配置依赖.env文件而非目录名，通过app_env值加载对应配置；数据库等敏感配置应使用env()函数动态获取，避免硬编码或延迟加载导致失效。
ThinkPHP 多环境配置靠 .env 文件，不是靠目录名
ThinkPHP 6+ 默认不支持“按目录名自动切换配置”，所谓“多环境目录配置”是常见误解。真实做法是用 .env 文件控制 APP_ENV，再由框架根据该值加载对应配置文件（如 config/app.php 中的条件分支或独立配置文件）。手动建 config/dev/、config/prod/ 目录并指望框架自动识别，不会生效。
实操建议：
-
.env必须放在项目根目录，且不能被 Git 提交（加到.gitignore） - 确保
think\Env已启用 —— ThinkPHP 6 默认开启，但若手动禁用过Env::load()就会失效 -
APP_ENV=testing和APP_ENV=prod是标准取值，非标准值（如staging）需在代码中显式判断，框架不自动识别
怎么让不同环境加载不同的数据库配置
数据库配置最常需要区分环境，但别在 config/database.php 里硬写 if-else。ThinkPHP 提供更干净的方式：用 env() 函数动态取值。
实操建议：
- 在
.env中定义：DATABASE_HOST=127.0.0.1、DATABASE_PORT=3306、DATABASE_NAME=dev_db - 在
config/database.php中直接引用：'hostname' => env('DATABASE_HOST', '127.0.0.1') - 避免在配置文件中调用
file_get_contents或include加载其他 PHP 配置 —— 这会破坏配置缓存，导致php think optimize:config失效 - 敏感字段（如密码）不要写死在
.env，生产环境应通过系统环境变量覆盖：export DATABASE_PASSWORD="xxx"，env()会优先读系统变量
自定义配置文件没生效？检查 Config::parse() 的加载时机
有人想把开发配置单独放 config/dev/redis.php，然后在 app/common.php 里用 Config::parse() 手动加载，结果上线后 redis 连不上 —— 原因是配置加载太晚，中间件或服务启动时已读过默认配置。
实操建议：
- 自定义配置必须在
app/bootstrap.php或public/index.php初始化阶段完成加载，不能拖到common.php或控制器里 - 如果真要按环境分文件，推荐统一入口：
config/extra/下放redis_dev.php、redis_prod.php，再在config/extra/redis.php中根据env('APP_ENV')返回对应数组 - 注意
Config::set()是运行时修改，无法被配置缓存捕获；要用Config::parse()+Config::set()组合，且确保只执行一次
部署时 .env 被覆盖或权限错误导致配置丢失
线上部署常用 rsync 或 CI/CD 覆盖整个 config/ 目录，一不小心就把 .env 删了，或者部署用户没有读取权限，env() 返回 null，所有依赖它的配置都退化成默认值。
实操建议：
- CI/CD 脚本中明确排除
.env：rsync -av --exclude='.env' ... - 上线后加一行健康检查：
php -r "var_dump(env('APP_ENV'));"，输出bool(false)就说明.env没加载成功 - Linux 下确认权限：
ls -l .env应为-rw-r--r--，web 用户需有读权限；若用apache用户运行，别设成root:root - 容器部署时，别用
COPY . /app全量复制，改用COPY --chown=www-data:www-data .env /app/单独注入
环境配置真正的复杂点不在怎么写，而在“谁在什么时候以什么权限读到了哪一份内容”。.env 只是起点，系统变量、命令行参数、运行时 set 都可能参与覆盖，查问题时得一层层剥开看实际生效的是哪个值。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
