Composer 不支持直接安装前端资源，composer-asset-plugin 已废弃，因其依赖停更的 Bower、不兼容 Composer 2.x、GitHub 归档，且 asset-packagist.org 已关停；应改用 npm/yarn 管理前端依赖。
Composer 本身不支持直接安装前端资源（如 jQuery、Bootstrap），composer-asset-plugin 是一个已废弃的过渡方案，**现在不应再使用它**。
为什么不能用 composer-asset-plugin
该插件依赖 Bower（2017 年已停止维护），且与 Composer 2.x 不兼容。启用后常出现以下错误：
Plugin installation failed, rolling backCould not fetch https://bower.herokuapp.com/packages/xxx- 执行
composer install卡在Installing bower-asset/jquery (3.6.0)并超时
官方早在 2019 年就将该项目归档（GitHub archive），所有主流框架（Yii2 除外）均已移除对其支持。
替代方案：用 npm / yarn 管理前端包
现代 PHP 项目应把前端依赖交给专用工具处理，Composer 只管 PHP 包。典型做法是：
立即学习“前端免费学习笔记（深入）”；
- 在项目根目录运行
npm init -y初始化package.json - 安装包：例如
npm install jquery bootstrap（会写入node_modules/） - 通过构建工具（如 Webpack、Vite）导入并打包，或直接在 HTML 中引用
node_modules/bootstrap/dist/css/bootstrap.min.css - 把
node_modules/加入.gitignore，CI 流程中执行npm ci
不需要任何 Composer 插件，也不需要修改 composer.json 的 repositories 或 config 字段。
如果必须兼容老 Yii2 项目
少数遗留 Yii2 项目仍依赖 fxp/composer-asset-plugin，可临时降级解决：
- 卸载当前插件：
composer global remove fxpio/composer-asset-plugin - 降级安装 v1.4.6（最后兼容 Composer 1.x 的版本）：
composer global require fxpio/composer-asset-plugin:^1.4.6 - 确认 PHP 版本 ≤ 7.4（v1.4.6 不支持 PHP 8.0+）
注意：这仅用于维持旧系统运行，不可用于新项目。
composer.json 中误配 asset-repository 的后果
有些教程建议手动添加如下配置：
{
"repositories": [
{
"type": "composer",
"url": "https://asset-packagist.org"
}
]
}
这是危险操作——asset-packagist.org 已于 2022 年关停，会导致：
-
composer update永久卡住或报Connection refused - 即使换镜像也无法恢复，必须手动删掉整个
repositories块 - 无法通过
composer config --unset repositories清理嵌套结构
真实项目里，composer.json 中出现 "type": "composer" + 前端域名，基本可以判定是过时资料。
前端包和 PHP 包的生态早已分离，强行用 Composer 拉取 JS/CSS，就像用 MySQL 存图片——技术上曾有人试过，但代价远大于收益。
