ThinkPHP配置修改核心原则是不硬改、不入口写、不覆盖缓存；生效方式仅静态配置文件修改和环境变量注入两种，推荐用.env+env()函数动态读取，运行时修改需单独文件、检查权限并清缓存。
ThinkPHP 修改配置文件，核心原则是：**不硬改、不入口写、不覆盖缓存**。真正生效的方式只有两种——静态配置文件修改（适合部署前）和环境变量注入（适合多环境部署）。运行时直接调用 Config::set() 或在 public/index.php 里写配置，基本无效。
配置文件位置与结构
ThinkPHP 6+ 的配置统一放在 config/ 目录下，按功能拆分为多个 PHP 文件：
-
app.php：应用基础设置（调试模式、默认时区、路由前缀等） -
database.php：数据库连接参数（主机、库名、账号、端口等） -
cache.php、log.php、view.php：分别控制缓存、日志、视图行为 -
middleware.php：中间件注册列表
每个文件返回一个关联数组，框架启动时自动合并加载。新增自定义配置文件（如 wechat.php）也放在此目录，命名随意，只要后缀是 .php 并返回数组即可。
推荐方式：用 .env + env() 函数动态读取
这是官方唯一支持的“运行前动态载入”方案，适用于开发/测试/生产环境切换：
立即学习“PHP免费学习笔记（深入）”；
- 在项目根目录（与
public/同级）新建.env文件 - 内容全大写加下划线，例如：
DB_HOST=192.168.10.100<br>DB_NAME=shop_v2<br>APP_DEBUG=true
- 在
config/database.php中引用：'hostname' => env('DB_HOST', '127.0.0.1'),<br>'database' => env('DB_NAME', 'thinkphp'), - 框架会自动调用
Env::load()加载.env，无需手动触发
注意：.env 不进 Git，敏感信息（密码、密钥）必须放这里；env() 第二个参数是默认值，避免环境缺失时报错。
谨慎使用：运行时生成或修改配置文件
仅适用于后台可编辑的业务参数（如站点标题、客服电话），且需满足以下条件：
- 配置文件单独存放，比如
config/setting.php，内容为return ['site_name' => 'XX商城', 'tel' => '400-xxx']; - 写入逻辑要检查目录权限：
is_writable()，并确保config/可写（生产环境通常禁用） - 写入后必须清空配置缓存：
php think optimize:config --clear，否则新内容不生效 - 生成代码需严格转义单引号、换行符，避免 PHP 语法错误（如用
addslashes()处理字符串值）
示例片段（简化版）：
$content = "<?php\nreturn [\n\t'site_name' => '" . addslashes($data['name']) . "',\n\t'tel' => '" . addslashes($data['tel']) . "',\n];";<br>file_put_contents(config_path() . 'setting.php', $content);
绝对避免的操作
这些做法看似简单，实际会导致配置失效或被覆盖：
- 在
public/index.php末尾写Config::set('database.hostname', 'xxx');—— 此时配置已冻结 - 直接修改
config/app.php内容并期望运行时生效 —— 文件只读一次，不重载 - 用正则替换整个配置文件字符串 —— 易破坏格式，引发解析错误
- 启用配置缓存（
php think optimize:config）后还试图硬编码改值 —— 缓存优先，代码被跳过
不复杂但容易忽略：改完配置，记得清缓存（runtime/config.php）、确认 .env 路径正确、检查是否用了 env() 而不是直接写死值。
