Yii 2.0.46 是关键分水岭版本，正式支持 Bootstrap 4/5、要求 PHP ≥7.4，并依赖 fxp/composer-asset-plugin 桥接 Bower 包；需更新插件至 ^1.4.7（PHP 8+）、松动 composer.json 版本约束、切换 bootstrap 扩展命名空间并检查必需 PHP 扩展。
Yii 2.0.46 是一个关键分水岭版本——它开始正式支持 Bootstrap 4/5，并引入了对 PHP 8+ 更严格的兼容性要求，同时废弃了大量旧类和插件机制。安装这个版本及更高版（如 2.0.48、2.0.49）时，不能沿用早期 Yii 2.0.x 的老套路，否则大概率卡在 composer 报错、白屏或类找不到。
必须提前装对 fxp/composer-asset-plugin
Yii 2.0.46+ 仍重度依赖 Bower 包（如 bootstrap、jquery、inputmask），而新版 Composer（尤其是 2.0+）已默认禁用 Bower 支持。fxp/composer-asset-plugin 是唯一能桥接的方案，但版本错不得：
- PHP 7.4 环境：用 ^1.4.6
- PHP 8.0 或 8.1：必须用 ^1.4.7 或更高（1.4.6 及以下在 PHP 8 下会静默失败）
- 执行全局安装：
composer global require "fxp/composer-asset-plugin:^1.4.7" - 装完立刻运行
composer global update，确保插件自身也更新到位 - 若之前装过旧版（如 1.1.x），先
composer global remove fxp/composer-asset-plugin再重装
Composer.json 版本约束要松动
硬写死 "yiisoft/yii2": "2.0.45" 会导致 composer update 完全跳过升级。正确做法是：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 把版本号改成
"^2.0.46"或直接删掉该行（让 Composer 自动选最新兼容版） - 只更新核心包：
composer update yiisoft/yii2 yiisoft/yii2-composer，避免连带升级 bootstrap/jQuery 引发样式或 JS 崩溃 - 升级后务必检查
composer.lock中yiisoft/yii2的 version 和 hash 是否已变更——这是真实生效的依据
Bootstrap 集成方式彻底变了
2.0.46+ 不再兼容旧版 yii\bootstrap\BootstrapAsset（来自 yiisoft/yii2-bootstrap），必须切换到新扩展：
- 用 Bootstrap 4：安装
yiisoft/yii2-bootstrap4（命令：composer require "yiisoft/yii2-bootstrap4:^2.0"） - 用 Bootstrap 5：安装
yiisoft/yii2-bootstrap5（命令：composer require "yiisoft/yii2-bootstrap5:^3.0"） - 确认
config/web.php中'view' => ['theme' => [...]]已配置，否则组件样式不加载 - 代码中改用新命名空间，例如：
use yii\bootstrap4\ActiveForm;而非yii\bootstrap\ActiveForm
PHP 和扩展检查不能跳过
2.0.46+ 明确要求 PHP ≥ 7.4（官方推荐 8.0+），且以下扩展必须启用：
-
mbstring（字符串处理，强制依赖） -
openssl（cookie 加密、HTTP 请求必需） -
pdo及对应驱动（如pdo_mysql） -
gd或imagick（验证码、图片处理） - Windows 用户需确认 PHP 路径已加入系统环境变量，CMD 中能直接调用
php -v
升级不是覆盖文件，而是重建依赖链。每一步都影响下一步是否能跑起来。不复杂但容易忽略。
