yii2环境切换应通过php init命令统一管理，而非硬编码yii_env；需同步设置yii_debug，新增环境须修改environments/index.php、新建目录并配置文件，运行时不可动态重定义yii_env。
YII_ENV 常量决定当前环境，切换本质就是改它——但直接硬编码在 index.php 或 console.php 里容易出错、难维护，推荐用 init 命令统一管理。
用 init 命令切换环境（最安全）
这是 Yii2 官方推荐方式，会自动复制对应环境的配置文件到 config/ 下，并设置好权限和密钥。
- 运行
php init，按提示选环境编号（0=dev，1=prod，其他取决于environments/index.php中定义） - 确保
environments/下已有目标环境目录（如test/），否则init会报错或覆盖错文件 - 执行后检查
config/web.php是否已合并了environments/test/web.php的内容（不是简单复制，而是array_merge） - 注意：
init不会修改YII_DEBUG，需手动在入口文件中同步调整（比如测试环境常设YII_DEBUG = false但开启日志）
YII_ENV 和 YII_DEBUG 必须配对设置
只改 YII_ENV 不动 YII_DEBUG，会导致行为异常：比如 YII_ENV = 'prod' 但 YII_DEBUG = true，错误页面仍显示堆栈，暴露敏感信息。
- 开发环境：
defined('YII_DEBUG') or define('YII_DEBUG', true); defined('YII_ENV') or define('YII_ENV', 'dev'); - 生产环境：
defined('YII_DEBUG') or define('YII_DEBUG', false); defined('YII_ENV') or define('YII_ENV', 'prod'); - 测试环境常见组合：
YII_DEBUG = false+YII_ENV = 'test'，避免调试信息干扰自动化测试断言
新增环境（如 test）要改三处
光在 environments/index.php 加一个数组项不够，漏掉任何一处都会导致 init 失败或配置不生效。
- 在
environments/index.php的$environments数组里添加新环境键值，例如'test' => [...] - 新建
environments/test/目录，并复制dev/或prod/的结构（含web.php、db.php等） - 确认
environments/test/web.php中的配置实际用了YII_ENV_TEST判断逻辑（如果要用YII_ENV === 'test'，得自己加判断，框架不内置该常量）
运行时动态切换环境？别这么做
YII_ENV 是常量，PHP 中无法在运行时重新定义；试图用 define('YII_ENV', 'test') 覆盖会触发 Notice: Constant YII_ENV already defined，且后续逻辑仍按最初值走。
- 需要“临时切库”或“临时换配置”，应该用组件级覆盖，比如
Yii::$app->db->dsn = ...，而不是碰环境常量 - 想让命令行脚本走测试配置？改
yii入口文件里的YII_ENV，或用不同入口（如yii-test）隔离 - Web 请求中靠 URL 参数切换环境？危险——等于把配置控制权交给用户，禁止
YII_DEBUG 的独立性。很多人以为 init 一把梭就完事，结果上线后 YII_DEBUG 还开着，或者 environments/test/db.php 里写的是本地数据库地址却忘了改，直接连上生产库删库。
