Yii2中params配置需用ArrayHelper::merge()显式合并，顺序决定覆盖优先级；common的params不自动继承，模块需手动合并；组件定义是替换而非合并，$params必须显式赋值给配置的'params'键。
common 配置合并不是靠“自动叠加”，而是靠手动 array_merge() 或 ArrayHelper::merge() 显式拼接，顺序决定覆盖优先级。
为什么不能直接 require 多个 params 文件？
Yii2 的 params.php 是返回一个数组，如果连续 require 两个同名变量（比如都定义 $params），后一个会直接覆盖前一个——这不是合并，是替换。常见错误现象：common/config/params-local.php 里的调试开关没生效，就是因为被 params.php 里默认的 'debug' => false 覆盖了。
正确合并方式：用 ArrayHelper::merge() 拼接参数数组
在 common/config/main.php 或应用入口配置中，必须显式调用合并函数。典型写法如下：
$params = \yii\helpers\ArrayHelper::merge(
require __DIR__ . '/params.php',
require __DIR__ . '/params-local.php'
);
这样才真正把两组键值“合并”而非“覆盖”。注意点：
-
ArrayHelper::merge()是递归合并，嵌套数组（如'db' => ['dsn' => ..., 'charset' => ...]）也会逐层合并，比原生array_merge()更安全 - 顺序很重要：后面文件的同名键会覆盖前面的，所以
params-local.php必须放在最后，确保本地开发配置优先生效 - 不要在
params.php里写$params = [...]再return $params，而应直接return [...]，否则require得到的是数组，不是变量
模块内怎么复用 common 的 params？
模块（如 frontend、backend）不自动继承 common 的 params。要在模块配置中复用，得手动再合并一次：
// frontend/config/main.php
$params = \yii\helpers\ArrayHelper::merge(
require __DIR__ . '/../../common/config/params.php',
require __DIR__ . '/../../common/config/params-local.php',
require __DIR__ . '/params.php',
require __DIR__ . '/params-local.php'
);
常见坑：
- 路径写错（比如少一个
..），导致require失败，报Failed opening required - 把
params-local.php提交到 Git，泄露数据库密码等敏感信息——它应该加进.gitignore - 误以为模块 config 里定义的
$params会自动注入到Yii::$app->params，其实不会；必须在components里显式配'params' => $params
合并 components 时要注意类实例唯一性
common 的 main.php 中定义的 'db'、'cache' 等组件，会被所有应用（frontend/backend/api）共享。但如果你在 frontend/config/main.php 里又定义了一个 'db'，它会完全替代 common 里的——不是合并，是替换。所以：
- 全局通用组件（如主库、Redis 缓存）只在
common/config/main.php定义 - 需要差异化配置的组件（如 backend 用
_csrf-backend，api 用_csrf-api），应在对应应用的 config 中重写整个'request'或'user'组件，而不是试图“局部修改” - 多个数据库连接（如
dbStats、dbLog）可以全放在common/config/main.php里，只要别重名，各应用都能直接通过Yii::$app->dbStats访问
最易被忽略的一点：合并后的 $params 数组，必须作为顶层键显式传给应用配置的 'params' 字段，否则 Yii::$app->params['xxx'] 根本读不到——它不会因为你在配置文件里写了 $params 变量就自动挂载。
