Composer无法管理前端资源，asset-packagist.org已失效，唯一稳定方案是composer/installers配合手动路径映射，但需包声明type字段且含dist目录；推荐直接用npm管理前端依赖。
Composer 不能管理非 PHP 资源文件，它压根不处理 JS/CSS/字体等前端资产的下载、构建或路径映射——你看到的“成功安装”只是把元信息或空包放进 vendor/，实际资源根本没落地。
asset-packagist.org 已不可用，别再配仓库源
截至 2026 年，https://asset-packagist.org 元数据长期未更新、大量包返回 404、不支持 HTTPS 和 Composer 2.2+ 的安全协议校验。你在 composer.json 里加这段：
"repositories": [{"type": "composer", "url": "https://asset-packagist.org"}]只会让每次 composer install 多一次失败的网络请求，CI 构建超时概率陡增。它不是慢，是失效了。
- 官方 Packagist 从不收录纯前端包，asset-packagist 是第三方桥接层，2021 年底起停止同步
-
fxp/composer-asset-plugin在 PHP 8.2+ 下直接报Class "Fxp\Composer\AssetPlugin\Repository\NpmRepository" not found - 即使侥幸拉到包（如
npm-asset/bootstrap），版本号常错乱（npm 的5.3.3映射成5.3.3.0），且无dist/目录
想让静态资源进 public/，只靠 composer/installers + 手动路径映射
这是目前唯一稳定、无需 Node.js、不依赖外部镜像的方案，但前提是：目标包自己声明了 "type" 字段，且你项目启用了对应 installer。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
立即学习“PHP免费学习笔记（深入）”；
- 确认你要装的包在它的
composer.json里有"type": "component"或"type": "npm-asset"（例如components/jquery、twbs/bootstrap） - 项目中
requirecomposer/installers：composer require composer/installers --dev - 在
extra.installer-paths中写死映射规则，例如："extra": { "installer-paths": { "public/assets/js/{$name}/": ["type:component"], "public/css/bootstrap/": ["twbs/bootstrap"] } } - 运行
composer install后，twbs/bootstrap会解压进public/css/bootstrap/，但仅限它composer.json中autoload.files或dist/目录被 zip 打包进发布版的情况
post-install-cmd 调用 npm 必须加环境和存在性判断
如果你的项目确实有 package.json，且需要构建（比如 Vue 组件库要 npm run build），那脚本必须防御性编写，否则 CI 一报错就中断。
- 先检查
package.json是否存在：@php -r "if (file_exists('package.json')) { echo `npm install && npm run build`; }" - 不要写裸命令
npm install—— 某些 Docker 镜像或 Windows CI 环境没装 Node.js，会直接退出 - 目标目录用
mkdir -p public/build开头，避免因父目录不存在导致后续cp静默失败 - 复制前加
if [ -d "dist/" ]; then cp -r dist/* public/build/; fi，防止构建失败后拷空目录
真正该做的，是放弃让 Composer “管理”前端资源
它不是设计来干这事的。你花半天调 extra.asset-installer-paths 格式，不如直接 npm install bootstrap 然后在 resources/js/app.js 里 import 'bootstrap'。复杂点在于路径映射和构建时机，但最易被忽略的是：所有“自动拷贝”方案都绕过了 package-lock.json 的版本锁定，一旦上游删 tag 或改结构，你的生产环境就可能加载到不兼容的 CSS 文件——而这个风险，composer.lock 压根不管。
