Composer不管理静态资源,只处理PHP包;改vendor目录需用config.vendor-dir并重装,installer-paths仅对非library类型包生效,且必须配合对应installer插件。

Composer 没有“静态资源库”这个概念,别被名字带偏
Composer 管理的是 PHP 包(library、framework、plugin),不是前端的 CSS/JS 图片等静态资源。所谓“静态资源库保存路径”,大概率是混淆了以下几种情况:
- 想把
vendor/目录挪到非默认位置(比如libs/或third-party/) - 想让某些包(如 WordPress 插件、Laravel Nova)安装到特定子目录(如
public/vendor/) - 误以为
installer-paths是通用路径重定向,想用它把所有包都塞进assets/之类目录
先明确一点:Composer 不负责托管或分发前端静态文件。如果你真要管理 CSS/JS,该用 npm、yarn 或 asset-packagist.org 这类专用方案。
想改 vendor 目录位置?只认 config.vendor-dir
这是唯一稳定生效的方式,但必须满足三个硬性条件:
-
composer.json根节点下写"config": {"vendor-dir": "libs"}—— 路径必须是相对路径,不能以/开头,也不能含~或$HOME - 执行
composer install前,旧vendor/目录必须已删除;composer update不会迁移已有包 - PHP 代码里所有
require 'vendor/autoload.php'都得手动改成require 'libs/autoload.php'
常见错误:COMPOSER_VENDOR_DIR=libs composer install 在 Composer 2.x 中完全无效,该环境变量已被移除。
想让特定包装进指定目录?得靠 installer-paths + 正确 type
这功能不是“按包名路由”,而是“按包类型分发”。必须同时满足:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 目标包的
composer.json明确声明了"type": "wordpress-plugin"(或其他非library的类型) - 你的项目已
require对应 installer,比如composer/installers或wpackagist/installer -
extra.installer-paths的键是项目根目录下的路径(如wp-content/plugins/{$name}),值是严格匹配的包名("acme/my-plugin"),不支持通配符
普通 library 包哪怕写进 installer-paths 规则里,也照旧进 vendor/。别指望用它把 monolog/monolog 塞进 public/js/。
为什么改了路径后 autoload 和 bin 命令全挂了
因为 Composer 把所有路径逻辑锚定在 vendor/ 根目录上。一旦你动了 vendor-dir:
-
vendor/autoload.php是生成时写死路径的入口文件 —— 不删旧vendor重装,它就还在老地方 -
vendor/bin/下的命令(如phpunit)是软链接,指向vendor/{package}/bin/xxx—— 路径一变,链接就断 - IDE(如 PHPStorm)默认只索引
vendor/,新路径需手动加进 Settings → PHP → Include Paths - CI 脚本里硬编码的
vendor/bin/phpunit必须同步更新为新路径,否则直接报Command not found
最易忽略的一点:改完 vendor-dir 后,composer dump-autoload 不够 —— 它只刷新类映射,不重建 autoload.php 入口和 bin/ 符号链接。必须清空再 install。










