Yii2 中 config/main.php 和 config/web.php 的合并由开发者手动控制，典型做法是在 web.php 中通过 ArrayHelper::merge() 合并，main.php 为基础配置、web.php 为覆盖层，顺序不可颠倒，且需避免空数组覆盖和文件加载错误。
Yii2 中 config/main.php 和 config/web.php 是怎么合并的
Yii2 启动时不会“自动合并”两个配置文件，而是靠 require 手动拼装。最常见写法是 web.php 里先 require 'main.php'，再用 array_merge_recursive 或 + 运算符叠加局部配置。
关键点在于：合并逻辑完全由你写的代码决定，框架不干预。所以别指望“默认覆盖规则”，得看你自己怎么写那几行 require 和 array_* 调用。
-
array_merge_recursive对相同键会递归合并数组，但遇到同名数字键会重编号，容易把'components' => [...]里的组件列表意外打乱 - 更安全的是用
+（右操作数覆盖左操作数），但它只做一层合并，嵌套数组不会递归，比如'components' => ['db' => [...]]整体会被替换，不是合并字段 - Yii 官方模板用的是
yii\helpers\ArrayHelper::merge()—— 它才是兼顾递归和键语义的正确选择，能处理数字键不重排、字符串键深度覆盖
ArrayHelper::merge() 怎么用才不丢配置
它比原生函数多一个语义：对同为数组的值递归合并，对非数组值直接用右边覆盖左边。这是 Yii 应用多环境配置的基础。
典型写法：
$config = yii\helpers\ArrayHelper::merge(
require __DIR__ . '/main.php',
require __DIR__ . '/web.php'
);
注意顺序：main.php 在前是基础配置，web.php 在后是覆盖层。如果反过来，web 的基础设置（如 'bootstrap'）可能被 main 里空数组清掉。
- 不要在
main.php里写'components' => []，否则ArrayHelper::merge()会把它当空数组，导致 web 层定义的组件全失效 - 如果某模块要加自己的配置（比如
console.php），也必须用同样方式加载，且确保它在 merge 链条的最右侧 -
ArrayHelper::merge()不识别注释或条件逻辑，所有require进来的文件都会无差别参与合并
局部配置（如 params-local.php）为什么有时不生效
因为 Yii 不强制你加载它——是否读取、何时读取、怎么合并，全靠你自己在 main.php 或 web.php 里写逻辑。
常见错误是把 params-local.php 放在 main.php 之后加载，结果被 ArrayHelper::merge() 丢掉了；或者用了 include_once 却没检查文件是否存在，导致报错中断。
- 推荐写法：在
main.php末尾加上return ArrayHelper::merge($config, file_exists(__DIR__ . '/params-local.php') ? require __DIR__ . '/params-local.php' : []); - 不要用
require加载可选配置，它会在文件不存在时报致命错误；file_exists + require是安全底线 -
params-local.php里返回的数组结构必须和$config['params']兼容，否则会覆盖整个params数组，而不是只改其中几个键
环境变量和 getenv() 混合配置时的坑
很多人想用 getenv('APP_ENV') 动态切配置，但直接在 main.php 里调用会失败——因为 getenv() 在 PHP-FPM 下默认被禁用，且环境变量可能还没被 Web 服务器注入。
真正可靠的方式是：在入口脚本（web/index.php 或 console/yii）顶部就调用 putenv() 或 $_ENV 注入，再传给配置文件。
- 别在
main.php里执行exec('echo $APP_ENV')，CLI 和 Web 环境行为不一致，且性能差 - 如果用 Docker，确保
env_file或environment正确挂载到了 PHP 进程，而不是只在 shell 里生效 -
getenv()返回值永远是字符串，if (getenv('DEBUG')) { ... }在值为'0'时仍为 true，要用filter_var(getenv('DEBUG'), FILTER_VALIDATE_BOOLEAN)
配置合并这件事，没有魔法，只有你写的那几行 require 和 ArrayHelper::merge()。哪一层漏了 return，哪一层少了个 file_exists，问题就出在哪——它不会报错，只会静默丢掉你的配置。
