必须用path类型仓库,因只有它能建立符号链接实现源码级调试;直接require、复制vendor或global安装均无法触发autoload注册和实时代码映射,导致Class not found等问题。

本地 Composer 包调试必须用 path 类型仓库,否则改代码不生效、类找不到、autoload 断掉——这不是配置问题,是机制绕不过去。
为什么不能直接 require 或复制到 vendor
常见错误现象:Class not found、改了 src/ 里的类却没反应、phpunit 报错说测试类不存在。这些都不是 PHPUnit 的锅,而是加载链路根本没走通。
-
composer require vendor/package:@dev+ Git 仓库:仍会克隆远程分支,你本地的修改要git commit && git push才能被拉下来,完全违背“本地调试”初衷 - 手动把包目录拷进
vendor/:Composer 不认它为已安装包,autoload规则不生效,composer dump-autoload也救不了 -
composer global require:脱离当前项目上下文,vendor/autoload.php路径错乱,连phpunit都初始化失败
path 仓库三要素必须对齐
错一个字符,composer update 就报 Could not find package。重点核验这三点:
- 主项目
composer.json的repositories中url值是相对路径,比如"../my-package"(不是绝对路径,也不是./my-package) - 主项目
require里写的是"my-vendor/my-package": "@dev"—— 必须用@dev,*或dev-main在 path 模式下不可靠 - 本地包根目录的
composer.json中"name": "my-vendor/my-package",大小写、连字符、斜杠全部一致,不能多空格、不能少斜杠
autoload 和测试类怎么配才不翻车
测试类报 Class not found,90% 是 autoload-dev 写错了,和 PHPUnit 无关。
使用 template.yaml 定义创建 Spotify Backstage 软件模板,包含 Scaffolder 操作,包括 fetch:template、publish:github 和 catalog:register。通过其 REST API 管理 Backstage 软件目录。
-
autoload-dev的 PSR-4 映射末尾必须带反斜杠:"MyPackageTests\": "tests/",少那个\就断掉 -
tests/Http/ClientTest.php里声明namespace MyPackageTestsHttp,那映射就不能写成"MyPackageTests": "tests/"(缺了Http层级) - 无命名空间的辅助文件(如
tests/bootstrap.php)不能塞进 PSR-4,得用autoload-dev.files单独引入 - 改完
autoload-dev后,必须手动运行composer dump-autoload --dev,否则vendor/composer/autoload_dev.php不更新
打包前验证是否真生效
别只看 vendor/ 目录有没有那个文件夹,得确认符号链接和类加载都跑通了:
- Linux/macOS 下运行
readlink vendor/my-vendor/my-package,输出应是你本地包的绝对路径;Windows 下用dir vendormy-vendormy-package看是否为目录映射而非复制 - 执行
php -r "echo class_exists('MyPackageCalculator') ? 'ok' : 'fail';",输出ok才说明生产 autoload 生效 - 再跑
php -r "echo class_exists('MyPackageTestsClientTest') ? 'ok' : 'fail';",确认测试类也能加载 - 最后执行
composer archive --format=zip --dir=./dist --file=my-package-1.0.0,注意composer.json里要有明确的version字段,否则文件名带dev-前缀
最容易被忽略的是:打包前没清掉 tests/ 和 .git/,结果 dist/ 里混进了测试代码或敏感提交记录;archive.exclude 配置里的路径必须带前导斜杠,比如 /tests/,写成 tests/ 可能不生效。










