composer 不处理前端资源，应使用 npm/yarn/pnpm；旧方案如 asset-packagist、fxp/composer-asset-plugin 已过时废弃；正确做法是前后端物理隔离，通过构建脚本将 frontend 构建产物输出至 public/assets。
Composer 本身不装前端资源
Composer 是 PHP 的依赖管理工具，只处理 composer.json 里声明的 PHP 包（比如 monolog/monolog），它不会下载 jQuery、Bootstrap 或 Vue.js 这类前端库。你看到某些老项目用 Composer 加载前端资源，基本是靠自定义 installer-paths + asset-packagist.org 这类非官方方案，现在已过时且不稳定。
常见错误现象：composer require twbs/bootstrap 看似成功，但实际装进 vendor/twbs/bootstrap 的只是个空壳或元信息包，没有 dist/ 文件，直接引用会 404。
- 真正要装前端资源，该用
npm、yarn或pnpm - 如果必须走 Composer（例如老旧 CMS 插件系统强制要求），得手动配置
fxp/composer-asset-plugin—— 但该插件从 2019 年起就停止维护，PHP 8+ 下大概率报错Class "Fxp\Composer\AssetPlugin\Repository\NpmRepository" not found - 现代替代方案是用构建脚本：在
post-install-cmd里调用npm install，再把产物复制到public/assets/
Bower 已废弃，别再配合 Composer 用
Bower 在 2017 年官方宣布归档（deprecated），npm 官方也早在 2021 年移除了对它的支持。你现在搜到的 “Composer + Bower 集成” 教程，基本都基于早已失效的 composer-asset-plugin 或私有仓库镜像，这些服务多数已下线。
使用场景：只有极少数遗留系统（如旧版 Yii 1.x 或 Drupal 7 某些模块）还残留 Bower 逻辑，新项目绝对不该引入。
立即学习“前端免费学习笔记（深入）”；
- 运行
bower install很可能卡在https://bower.herokuapp.com（已关闭）或返回ENOTFOUND - 即使强行换源（如
registry=https://registry.bower.io），也会遇到大量包缺失main字段，导致无法自动提取 JS/CSS - Composer 的
require-dev里写"bower-asset/jquery": "^3.6"这类写法，在 Composer 2.2+ 中默认被禁用，需额外开启config.platform模拟旧环境，徒增维护成本
前端资源该往哪放、怎么引
PHP 后端和前端资源天然分层，硬塞一起只会让路径、缓存、CDN 分发变复杂。正确做法是物理隔离 + 构建串联。
典型结构：
project/ ├── composer.json ← 管 PHP 依赖 ├── public/ │ ├── index.php ← 入口 │ └── assets/ ← 前端构建产物目标目录（空，由构建生成） ├── frontend/ ← 独立前端工程（含 package.json、src/、vite.config.js） │ ├── package.json │ └── src/ └── vendor/ ← 只放 PHP 包
- 开发时用
vite或webpack监听frontend/，输出到public/assets/ - PHP 模板里用
<script src="/assets/index.a1b2c3.js"></script>，不写死版本号，靠构建哈希控制缓存 - 部署时先
cd frontend && npm ci && npm run build，再跑composer install --no-dev，顺序不能反 - 别把
node_modules/提交进 Git，也别让 Composer 自动执行npm install—— 权限、网络、Node 版本差异会导致 CI 失败
如果你真被 legacy 项目困住了
有些老系统（比如某定制版 Magento 1 或 Joomla 插件）确实把前端包当 Composer 包注册在私有源里，这时绕不开兼容逻辑。
关键点不是“怎么配”，而是“怎么最小化影响”：
- 确认
composer.json中是否含"repositories"指向内部 HTTP 源，且该源仍存活；否则所有bower-asset/*依赖都会失败 - 检查
vendor/composer/installed.json里对应包的dist字段是否含有效url，很多老包 URL 已跳转 404 - 临时解法：把需要的 JS/CSS 手动下载，放进
public/vendor/，然后改模板路径 —— 比折腾插件更省时间 - 长期必须拆：把前端部分抽成独立 Git 仓库，用 GitHub Pages 或 S3 托管静态资源，PHP 只负责 API
真正的麻烦从来不在工具链怎么连，而在于谁来承担迁移成本、测试回归范围、以及上线后用户浏览器缓存怎么清——这些没法用 composer update 解决。
