ThinkPHP配置文件在哪_config目录多环境配置方法【操作】-ThinkPHP-PHP中文网

thinkphp 的主配置必须放在项目根目录的 config.php 中，它是框架启动时唯一被提前加载的配置入口；database、cache 等硬依赖项若未在此定义，命令行功能将直接失效。

thinkphp配置文件在哪_config目录多环境配置方法【操作】

ThinkPHP 的配置文件不在 application/config 下——至少不能只靠它跑全场景，尤其命令行、迁移、多应用启动时会直接报错。

config.php 必须放在项目根目录

框架启动第一阶段就调用 think\App::initCommonConfig()，此时应用层还没初始化，config.php 是唯一被提前加载的入口。写在 application/config/database.php 里的数据库配置，网页请求能连上，但执行 php think migrate:run 或 php think make:model User 会提示“找不到数据库配置”。database、cache、log、app_debug 这些硬依赖项必须放在这里，否则命令行功能直接瘫痪。

常见错误现象：

php think migrate 报错：SQLSTATE[HY000] [1045] Access denied for user ''@'localhost'
Cache::store('redis') 静默 fallback 到 file 驱动，且缓存路径写入失败
日志不落盘，或写进 runtime/log/ 外的未知路径

.env 文件优先级最高，但要用对函数

env() 函数在 config.php 加载阶段已就绪，但 $_ENV 和 getenv() 不可用——前者未初始化，后者在 PHP-FPM 下默认禁用，且不会自动类型转换（比如 APP_DEBUG=true 会被当字符串处理）。

正确写法示例：

'hostname' => env('DB_HOST', '127.0.0.1'),
'port'     => (int) env('DB_PORT', 3306),
'password' => env('DB_PASSWORD', ''),
'debug'    => filter_var(env('APP_DEBUG', 'false'), FILTER_VALIDATE_BOOLEAN),

注意：env() 返回的是字符串，端口必须强制转 int，布尔值必须用 filter_var 转换，不能直接写 true/false 字面量。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

多环境配置别堆在 config.php 里硬判断

把 if (APP_ENV === 'prod') { ... } else { ... } 塞进 config.php 看似简单，但会导致配置不可复用、难以测试、git diff 混乱。推荐做法是拆出独立文件 + 启动时动态加载：

建立 config/dev.php、config/prod.php、config/test.php
在 config.php 末尾加一行：return array_merge(require 'config/' . env('APP_ENV', 'dev') . '.php', $config);
部署时设环境变量：APP_ENV=prod（Linux）或 set APP_ENV=prod（Windows CMD）

这样既能保证敏感信息不出代码库，又能让 CI/CD 流水线按需注入配置，避免手改文件引发的线上事故。

database.php 等子文件只是“补充”，不是主配置源

很多人以为 config/database.php 是数据库配置的唯一位置，其实它只是被 config.php 主配置合并进去的子项。如果 config.php 里没定义 database 键，框架会回退到默认值，导致生产环境误连本地库。

关键点：

config/database.php 只在 config.php 中显式 return [..., 'database' => require 'database.php'] 时才生效
ThinkPHP 6+ 默认不自动加载子文件，必须手动 require 或用 Config::load()
路由配置更特殊：route/app.php 是唯一自动加载的路由文件，它不是配置，而是可执行逻辑，Route::import() 引入的其他文件必须清缓存才能生效

真正容易被忽略的是：所有配置最终都要汇入 config.php 的返回数组，它才是整个生命周期的配置源头。哪怕你写了十个子文件，只要没被这个入口包含，就等于不存在。