Yii2模块参数必须定义为模块类的公共$params属性，在init()中直接赋值或通过Yii::configure()加载纯数组配置，不可套用应用级params键结构，否则导致Undefined array key错误。
Yii 框架没有“全局变量”概念，只有 params —— 一个被框架原生支持、可跨组件/控制器安全访问的键值对集合。它不是 PHP 全局变量（$GLOBALS），也不该用 define() 或 global 手动污染作用域。
config/params.php 是唯一推荐的参数入口
所有静态、环境无关或需版本控制的应用级配置项，必须写进 config/params.php。这个文件被 web.php 和 console.php 自动加载，最终挂载为 Yii::$app->params。
- 必须返回纯数组，不能有逻辑判断或函数调用（否则无法被配置合并机制识别）
- 键名建议全小写+下划线，避免大小写混用导致访问不一致
- 敏感值（如密钥、邮箱）不应硬编码在此文件中，应通过
getenv()动态读取 - 示例内容：
return [ 'adminEmail' => getenv('ADMIN_EMAIL') ?: 'admin@example.com', 'siteName' => 'My Yii App', 'uploadMaxSize' => 8 * 1024 * 1024, ];
环境变量必须在入口文件中提前加载
getenv() 调用依赖服务器环境或 .env 文件预加载。Yii 本身不自动读取 .env，你得自己加 —— 否则 params.php 里 getenv('DB_PASSWORD') 会返回 false，导致连接失败。
- 在
web/index.php开头（require __DIR__ . '/../vendor/autoload.php';之后、require __DIR__ . '/../vendor/yiisoft/yii2/Yii.php';之前）插入：if (file_exists(__DIR__ . '/../.env')) { $dotenv = new \Dotenv\Dotenv(__DIR__ . '/..'); $dotenv->load(); } - 确保已安装
vlucas/phpdotenv：运行composer require vlucas/phpdotenv - 不要在
params.php里做isset($_SERVER['...'])判断——它不总可靠，且破坏配置纯净性
模块级参数不能塞进全局 params
模块（Module）有自己的生命周期和作用域。Yii::$app->params 是应用级共享区，模块参数若也往里写，会污染全局命名空间、引发键名冲突、难以追踪来源。
- 正确做法：在模块类的
init()中定义$this->params，并通过Yii::$app->getModule('xxx')->params显式访问 - 错误写法：
Yii::$app->params['payment_api_key'] = 'xxx'—— 这属于运行时篡改，下次请求可能失效，且无法被配置合并机制管理 - 若模块参数需多处复用，可封装为独立配置文件（如
modules/payment/config/main.php），再在模块init()中用\Yii::configure($this, ...)加载
真正容易被忽略的是：params 的键名一旦被多个模块或组件同时使用（比如都叫 debug），框架不会报错，但后加载的会覆盖先加载的——这种静默覆盖在多团队协作时极难排查。所以，模块参数务必加前缀，全局参数要严格按语义域划分，例如 mail_from_address、payment_timeout_ms，而不是笼统的 from 或 timeout。
