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 完全跳过升级。正确做法是：

• 把版本号改成 "^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），必须切换到新扩展：

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

• 用 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

升级不是覆盖文件，而是重建依赖链。每一步都影响下一步是否能跑起来。不复杂但容易忽略。