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 工具链：

前端开发

ys-agent 前端（frontend/）功能迭代的工程规范守门 skill。当任何 agent 接到 ys-agent 前端相关任务时——新增页面、新增组件、加 API、加 Pinia store、改路由、写 mock、调整布局、修改样式、对接后端接口、迁移 demo 代码、做主题、加权限、写公共组件、做数据可视化、做表单、做弹窗、做表格、做搜索过滤、调 Element Plus 用法、做响应式、做性能优化，或仅仅是在 frontend/ 目录下编辑任何 .vue / .ts / .scss / .c

下载

• 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 被淘汰的根本原因。