本地包调试不能直接在扩展包目录执行composer install,因为生成的vendor仅限该目录,宿主项目只认其根目录下的vendor/autoload.php;真正生效的是宿主项目运行composer require时,解析扩展包composer.json中require声明的依赖并统一安装到宿主vendor目录。

本地包调试为什么不能直接 composer install
在扩展包目录下执行 composer install 会生成一个独立的 vendor,但这对宿主项目完全无效。Composer 只认项目根目录下的 vendor/autoload.php,而你的扩展包只是被加载的代码,不是运行主体。
真正起作用的是:宿主项目执行 composer require your-vendor/your-package 时,Composer 解析你包里的 composer.json,把其中 require 声明的依赖一并拉进宿主项目的 vendor 目录。
- 本地
vendor是冗余的,CI 流程中应加.gitignore忽略 - 开发阶段想让修改立刻生效,必须绕过 Packagist,用路径映射让宿主项目「直接加载源码」
- 测试用例里需要
autoload-dev映射,但这些路径不会被宿主项目自动识别,需手动require或靠composer dump-autoload --dev生成
用 repositories.path 让宿主项目加载本地代码
在宿主项目的 composer.json 中添加 repositories 配置,指向本地扩展包路径:
{
"repositories": [
{
"type": "path",
"url": "../my-awesome-package"
}
],
"require": {
"my-vendor/my-awesome-package": "*"
}
}
然后运行 composer update my-vendor/my-awesome-package(不要用 install,它不读新配置)。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
-
url必须是相对路径,且指向含composer.json的目录 -
"*"版本号会被 Composer 自动解析为“软链接”,修改本地代码后无需重新 install/update 即可生效 - 若报错
Could not find package ... at any version,检查路径是否拼错、composer.json是否有语法错误、或是否漏了name字段
调试时 autoload 和服务提供者怎么生效
扩展包的 autoload 字段决定它的类能否被宿主项目自动加载;而服务提供者(如 TestPackageServiceProvider)需由宿主框架手动注册(Laravel)或显式引入(纯 PHP)。
- Laravel 项目中,确保
composer.json的autoload正确映射了src/,再运行composer dump-autoload - 服务提供者不会自动注册——Laravel 需在
config/app.php的providers数组中手动加一行;Slim/Lumen 等需在启动脚本中new TestPackageServiceProvider()并调用register() - 如果类找不到,先确认
vendor/composer/autoload_psr4.php里是否已写入你的命名空间映射
常见卡点:改了代码却没反应
最常被忽略的是 OpCache 和自动加载缓存。即使你改了 src/ 下的类,PHP 可能还在用旧字节码;composer dump-autoload 也不会刷新已加载的类映射。
- 执行
php -r "opcache_reset();"清空 OpCache(CLI 和 Web 环境需分别执行) - 修改
composer.json的autoload后,必须运行composer dump-autoload,否则新映射不生效 - Windows 用户注意路径分隔符:用
../my-package,别写成..\my-package,Composer 不识别反斜杠 - Linux/macOS 权限问题:确保宿主项目有读取本地包目录的权限,否则
composer update会静默跳过
路径映射本身不解决逻辑错误,但它把「改代码 → 看效果」的链路压到秒级。真正难的永远是 autoload 配置是否精准、服务提供者是否被调用、以及 OpCache 是否被遗忘。










