composer-asset-plugin 已废弃，因其自2017年起停止维护、不兼容Composer 2.x、依赖已关闭的Bower registry，且无法处理peer dependency和ESM等现代前端语义；应改用yarn或npm配合webpack/vite等工具链管理前端资源。
Composer 本身不支持 Bower 包，composer-asset-plugin 是一个已废弃的过渡方案，**现在不应再使用它管理前端资源**。
为什么不能用 composer-asset-plugin
该插件早在 2017 年就停止维护，且与 Composer 2.x 完全不兼容——安装时会报错 Plugin installation failed 或直接拒绝加载。它依赖已下线的 Bower registry（bower.io 关站），且无法处理现代前端包的 peer dependency、ESM 导入等语义。
替代方案：用 yarn 或 npm 管理前端依赖
所有主流 PHP 框架（Laravel、Yii2、Symfony）都已弃用 Asset Plugin，转而推荐原生 Node.js 工具链：
-
yarn add bootstrap@5.3或npm install jquery --save-dev直接写入package.json - 通过
webpack、vite或laravel-mix构建并输出到public/目录 - PHP 后端只负责提供 API 或渲染静态 HTML 入口，不再参与前端包解析
如果必须兼容旧项目（如 Yii2 2.0.13 以下）
仅限无法升级的遗留系统，且必须锁定环境：
立即学习“前端免费学习笔记（深入）”；
- 强制使用 Composer 1.10.22：
composer self-update 1.10.22 - 全局安装插件：
composer global require fxp/composer-asset-plugin:~1.4.6 - 在项目根目录
composer.json中添加："extra": {"asset-installer-paths": {"npm-asset-library": "vendor/npm", "bower-asset-library": "vendor/bower"}} - 注意：Bower 包名需改写为
bower-asset/jquery格式，且大量包已不可下载
真正麻烦的不是配置，而是当 jquery 的某个子依赖突然从 GitHub 删除 tag、或 bootstrap 发布 v6 不再提供 UMD 版本时，整个构建链会静默失败——这种不确定性才是 composer-asset-plugin 被淘汰的根本原因。
