Yii项目从Bootstrap 3升级到Bootstrap 5时Composer安装报错求助

报错信息 #

Your requirements could not be resolved to an installable set of packages.

  Problem 1
    - yiisoft/yii2-bootstrap[2.0.9, ..., 2.0.11] require bower-asset/bootstrap 3.4.* | 3.3.* | 3.2.* | 3.1.* -> satisfiable by bower-asset/bootstrap[v3.1.0, ..., v3.4.1].
    - yiisoft/yii2-bootstrap[2.0.1, ..., 2.0.8] require bower-asset/bootstrap 3.3.* | 3.2.* | 3.1.* -> satisfiable by bower-asset/bootstrap[v3.1.0, ..., v3.3.7].
    - yiisoft/yii2-bootstrap 2.0.0 requires bower-asset/bootstrap 3.2.* | 3.1.* -> satisfiable by bower-asset/bootstrap[v3.1.0, v3.1.1, v3.2.0].
    - You can only install one version of a package, so only one of these can be installed: bower-asset/bootstrap[v3.1.0, ..., v3.4.1, v4.0.0, ..., v4.6.2, v5.0.0, ..., v5.2.0].
    - yiisoft/yii2-bootstrap5[2.0.1, ..., 2.0.3] require bower-asset/bootstrap ^5.1.0 -> satisfiable by bower-asset/bootstrap[v5.1.0, ..., v5.2.0].
    - Root composer.json requires yiisoft/yii2-bootstrap5 * -> satisfiable by yiisoft/yii2-bootstrap5[2.0.1, 2.0.2, 2.0.3].
    - Root composer.json requires yiisoft/yii2-bootstrap ~2.0.0 -> satisfiable by yiisoft/yii2-bootstrap[2.0.0, ..., 2.0.11].

Use the option --with-all-dependencies (-W) to allow upgrades, downgrades and removals for packages currently locked to specific versions.

冲突原因 #

项目同时依赖了yiisoft/yii2-bootstrap（适配Bootstrap3）和yiisoft/yii2-bootstrap5（适配Bootstrap5），这两个包分别要求安装不同版本的bower-asset/bootstrap，而Composer不允许同一软件包存在多个版本，因此抛出依赖无法解析的错误。

解决步骤 #

1. 清理旧依赖

执行以下命令移除适配Bootstrap3的Yii扩展：

composer remove yiisoft/yii2-bootstrap

同时手动检查composer.json文件，确保require部分已删除yiisoft/yii2-bootstrap ~2.0.0这一行配置。

2. 安装Bootstrap5适配扩展

执行命令安装Yii的Bootstrap5扩展：

composer require yiisoft/yii2-bootstrap5

如果遇到依赖锁定导致的安装失败，加上-W参数允许Composer调整相关依赖版本：

composer require yiisoft/yii2-bootstrap5 -W

3. 项目代码适配

完成依赖更新后，需对项目代码进行调整以适配Bootstrap5：

• 替换Widget类：将视图文件中所有yii\bootstrap\*命名空间的组件替换为yii\bootstrap5\*，例如yii\bootstrap\Navbar改为yii\bootstrap5\Navbar，yii\bootstrap\Modal改为yii\bootstrap5\Modal等。
• 更新HTML与CSS类：Bootstrap5对组件类名做了大量调整，比如将navbar-toggle改为navbar-toggler，dropdown-menu-right改为dropdown-menu-end，栅格系统的响应式前缀保持但部分细节有变化，需逐一检查更新。
• 调整JavaScript逻辑：Bootstrap5不再依赖jQuery，所有组件的初始化和交互逻辑需改用原生JS实现，移除原有的jQuery相关调用。

内容的提问来源于stack exchange，提问作者Benjamin