Yii2中params.php默认位于config/目录下，需在web.php或console.php中通过require并赋值给$config['params']才能生效；它必须返回纯数组，且不可含运行时逻辑。
Yii2 中 params.php 文件在哪、怎么加载
Yii2 默认把 params.php 放在 config/ 目录下（如 config/params.php），它不是一个自动注册的配置文件，而是靠你在 config/web.php 或 config/console.php 里手动 require 并合并进 $config['params'] 才生效的。
常见错误是直接改了 params.php 却没在主配置里引用，结果 Yii::$app->params['xxx'] 报错或取不到值。
-
config/params.php必须返回一个数组，例如：return [ 'adminEmail' => 'admin@example.com', 'pageSize' => 20, ]; - 在
config/web.php中，必须显式合并进去：'params' => array_merge( require __DIR__ . '/params.php', require __DIR__ . '/params-local.php' ), - 如果用的是高级模板，前后台可能各自有独立的
params.php（如frontend/config/params.php），注意别改错位置
Yii::$app->params 读取时为什么提示 undefined index
这个错误基本只有一种原因：你试图访问的 key 在 params 数组里根本不存在，或者该 key 被后面加载的配置（比如 params-local.php）覆盖/遗漏了。
- 检查 key 拼写，
Yii::$app->params['adminEmail']和Yii::$app->params['adminemail']是两个东西 - 确保
params.php确实被加载进了$config['params']，而不是只放在文件系统里“躺平” - 开发时可临时加一行调试：
var_dump(array_keys(Yii::$app->params));
看看到底有哪些 key 可用 - 不要在
params.php里写依赖 Yii 的逻辑（比如调用Yii::t()或访问Yii::$app），此时应用实例还没完全构建好
多个环境（dev/test/prod）下怎么管理 params
Yii2 官方推荐用 params-local.php 做环境隔离，它通常被 .gitignore 排除，避免敏感配置泄露。
立即学习“PHP免费学习笔记（深入）”；
-
params.php存通用参数（如'pageSize' => 20） -
params-local.php存环境专属参数（如数据库密码、API 密钥），格式一样，也必须返回数组 - 加载顺序很重要：后加载的会覆盖前面同名 key，所以一般把
params-local.php放在array_merge的最后 - 测试环境可以建
params-test.php，并在tests/bootstrap.php里按需加载，不一定要硬套 local 模式
params.php 里能写动态值吗？比如基于当前域名判断
可以，但得小心时机——params.php 是在应用初始化早期就被 require 的，此时 Yii::$app 还没创建，$_SERVER 或 getenv() 是安全的入口。
- 推荐用
getenv('APP_ENV')或$_SERVER['HTTP_HOST']做简单分支，例如：return [ 'uploadPath' => getenv('APP_ENV') === 'prod' ? '/var/www/uploads' : '@runtime/uploads', ]; - 避免在
params.php里 new 对象、查数据库、调用未加载的类——这会导致启动失败 - 如果逻辑复杂（比如要读 DB 配置再拼接 URL），建议改用
Bootstrap类或组件方式延迟计算，而不是塞进 params
params 不是万能容器，它适合静态、轻量、启动即确定的配置；一旦涉及运行时上下文或副作用，就得换更合适的扩展点。
