ThinkPHP 6+ 需手动启用 vlucas/phpdotenv 并在 index.php 中加载 .env;配置文件中须用闭包延迟解析 Env::get();可通过 APP_ENV 动态引入环境专属配置;.env 应忽略 Git,通过 CI/CD 或服务器变量安全注入。

如何通过 .env 文件区分开发、测试、生产环境配置
ThinkPHP 6+ 原生支持基于 .env 的多环境配置,但默认不启用——必须手动开启并确保 vlucas/phpdotenv 已安装。很多项目卡在这一步,直接改 config/app.php 硬编码,结果部署时漏改数据库密码或调试开关。
实操要点:
- 在项目根目录新建
.env,内容如:APP_DEBUG = true APP_ENV = dev DB_HOST = 127.0.0.1 DB_NAME = tp_dev
- 确认
composer.json中已包含"vlucas/phpdotenv": "^5.4",若无则运行composer require vlucas/phpdotenv - 修改
public/index.php,在require __DIR__.'/../vendor/autoload.php';后添加:$dotenv = Dotenv\Dotenv::createImmutable(__DIR__.'/..'); $dotenv->load();
-
.env中的键名会自动转为大写 + 下划线格式,对应Env::get('app_debug')或Env::get('db_host')可读取
为什么 config/database.php 里用 Env::get() 有时不生效
常见错误是把 Env::get() 写在数组顶层键值位置,而 ThinkPHP 配置文件是 PHP 返回数组,执行时机早于 .env 加载完成——尤其在 CLI 模式下(如 php think migrate)更容易失败。
正确做法是延迟解析:
立即学习“PHP免费学习笔记(深入)”;
- 不要这样写:
'hostname' => Env::get('db_host', '127.0.0.1'), - 应改为闭包方式(TP6.1+ 支持):
'hostname' => function() { return Env::get('db_host', '127.0.0.1'); }, - 或使用配置预处理:在
app/common.php或服务提供者中调用Config::set()覆盖关键项 - 验证是否生效:命令行执行
php think env,看输出的环境变量是否与.env一致
如何让不同环境加载不同配置文件(如 config/log.php 分离)
ThinkPHP 不强制要求按环境拆配置文件,但可通过约定路径 + 自动加载实现。核心是利用 APP_ENV 值动态引入,而非硬编码判断。
操作步骤:
- 在
config/目录下建立子目录:config/dev/log.php、config/prod/log.php - 修改
config/log.php主文件,末尾追加:if (is_dir(__DIR__ . '/' . App::$env->get('app_env'))) { $envConfig = include __DIR__ . '/' . App::$env->get('app_env') . '/log.php'; return array_merge($config, $envConfig); } return $config; - 注意:该方式依赖
App::$env已初始化,因此不能在bootstrap.php阶段使用;推荐放在配置合并逻辑中(如自定义服务提供者) - 避免在
config/下直接放dev/、prod/并靠命名覆盖——ThinkPHP 不会自动扫描子目录
部署时 .env 被 Git 忽略,但线上配置怎么安全更新
线上环境严禁提交 .env 到仓库,但运维又需要可控地更新数据库密码、API 密钥等。硬写进服务器文件容易出错,且无法审计。
可行方案:
- CI/CD 流程中,在部署脚本最后一步用模板渲染生成
.env:envsubst .env,配合 Docker secrets 或 GitHub Actions secrets 注入变量 - 使用 Nginx/Apache 环境变量透传:在虚拟主机配置中设置
fastcgi_param APP_ENV prod;,再在index.php中用$_SERVER['APP_ENV']初始化Env - 禁止在控制器或模型里调用
Env::set()修改运行时环境变量——它只影响当前请求生命周期,且可能被并发覆盖 - 敏感字段(如
JWT_SECRET)务必设为不可读:部署后执行chmod 600 .env
真正麻烦的是环境变量嵌套引用(比如 DB_URL=mysql://{$DB_USER}:{$DB_PASS}@{$DB_HOST}/{$DB_NAME}),ThinkPHP 默认不支持,得自己写解析器或换用 symfony/dotenv 替代原生加载器。


















