ThinkPHP公共文件配置说明在哪里？

本文共计934个文字，预计阅读时间需要4分钟。

ThinkPHP的公共配置必须放在项目根目录下的`config.php`文件中，而不是`app/config.php`或`app/common.php`。否则，在命令行执行、多应用、模型生成等场景下，配置将直接失效。

为什么 config.php 是唯一可靠入口

框架启动时，think\App::initCommonConfig() 会优先加载根目录 config.php，此时连应用层都还没初始化。所有后续逻辑（包括 Db::connect()、Cache::store()、php think migrate:run）都依赖它提供基础运行参数。

• 写在 app/config.php 的数据库配置：网页请求能用，但 php think make:model User 会报“找不到数据库配置”
• 写在 common.php 的函数或配置：只在 HTTP 请求进入应用后才加载，命令行下根本不可见
• 多应用模式下，config.php 对所有应用生效；app/config.php 只覆盖当前应用，且合并时机晚于核心初始化

database、cache、log 配置必须提进根目录

这些不是“建议提取”，而是“不提就崩”的硬性依赖项：

• database 块缺失 → php think migrate 报错退出，Db::name('user')->select() 在命令行直接抛异常
• cache 驱动未定义 → Cache::store('redis') 静默 fallback 到 file，且缓存路径可能写入失败目录
• log 的 path 未设 → 日志写入 runtime/log/ 外的未知位置，或因权限问题完全丢失
• 像 app_debug、app_timezone 这类影响时间处理和错误输出的配置，也必须在 config.php 中明确声明

如何安全读取 .env 变量

config.php 加载阶段，env() 函数已就绪，但 $_ENV 和 getenv() 不可用：

立即学习“PHP免费学习笔记（深入）”；

• 错：使用 $_ENV['DB_HOST'] → 报 Undefined index，因为 Env 类尚未初始化
• 错：用 getenv('DB_PORT') → PHP-FPM 默认禁用，且不会自动类型转换（APP_DEBUG=true 会被当字符串）
• 对：'hostname' => env('DB_HOST', '127.0.0.1')
• 对：'port' => (int) env('DB_PORT', 3306)（PDO 要求整型端口）
• 对：'password' => env('DB_PASSWORD', '')（空字符串是安全默认值，不是 null 或字面量 'DB_PASSWORD'）

__PUBLIC__ 路径配置实际生效位置

__PUBLIC__ 是模板渲染时的替换字符串，不归 config.php 管，而由视图配置控制：

• ThinkPHP 6+：在 config/app.php 的 view_replace_str 数组里设置，例如 '__PUBLIC__' => '/static'
• ThinkPHP 5.x：同样在 app.php，但部分老项目误写在 app/config.php，导致仅当前应用生效
• 注意：该配置不影响静态资源物理路径，只影响模板中 __PUBLIC__/css/app.css 这类写法的最终 URL 替换结果
• 如果用了 CDN，这里可直接填完整域名：'__PUBLIC__' => 'https://cdn.example.com/static'

真正容易被忽略的是环境变量加载顺序和类型转换——env('DB_PORT') 返回的是字符串，不显式转 (int)，PDO 就会拒绝连接；env('APP_DEBUG') 自动转布尔，但 getenv() 不会。这点在部署到新服务器时几乎必踩。