Composer如何在单元测试环境内临时动态加载模拟的假包（测试技巧）-composer-PHP中文网

不能靠composer自动加载临时假包，必须手动干预autoloader——因dump-autoload生成的映射是静态快照，只认composer.json声明路径；未配置autoload-dev并执行dump-autoload，tests/stubs/下的类永远不会进入加载链，且ide或phpunit可能提前冻结autoloader使运行时addpsr4无效。

composer如何在单元测试环境内临时动态加载模拟的假包（测试技巧）

不能靠 Composer 自动加载临时假包，必须手动干预 autoloader —— 因为 composer dump-autoload 生成的映射是静态的，不支持运行时“注册一个还没存在的包”。

为什么 vendor/autoload.php 加不进你写的假类？

Composer 的 autoload.php 是构建时生成的快照文件，只认 composer.json 里声明过的路径。你把 tests/stubs/MyFakeService.php 放进去，不改 autoload-dev、不跑 composer dump-autoload，它就永远不在自动加载链里。

更麻烦的是：有些 IDE 或测试 runner（比如 PHPUnit 的 process isolation）会提前冻结 autoloader，后续 $loader->addPsr4() 也无效。

常见错误现象：Class 'StubsMyFakeService' not found，哪怕文件存在、命名空间写对了
根本原因：不是路径错，是 autoloader 根本没注册这个前缀
别指望 require-dev 能解决——那是装包用的，不是挂载本地 PHP 文件用的

真正能用的三种动态加载方式

绕过 Composer 自动生成逻辑，直接操作 ClassLoader 实例或硬引入：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

在 phpunit.xml 的 bootstrap 文件里（如 tests/bootstrap.php），拿到全局 loader：

$loader = require 'vendor/autoload.php';<br>$loader->addPsr4('Stubs\', __DIR__.'/stubs/');

如果测试里只用一两个类，更简单：require_once __DIR__.'/stubs/MyFakeService.php'; —— 不依赖命名空间，也不怕 autoloader 冻结
用 class_alias() 替换真实类（慎用）：class_alias('StubsMyFakeService', 'AppServicesRealService');，但要注意类已加载就不能 alias

注意：$loader->addPsr4() 必须在任何类被 new 或 use 前调用，否则无效；Laravel 的 TestCase 默认已在 setUp() 前完成 autoload，所以 bootstrap 是唯一安全时机。

Mockery 和假包混用时的坑

Mockery 本身不解决“假包加载”，它只 mock 已存在的类。如果你要 mock 的类来自一个尚未安装的假包，得先让这个类能被加载，再 mock。

别在 setUp() 里 require_once 假类 —— 可能触发多次，导致 Cannot declare class 错误
别用 Mockery::mock('StubsMyFakeService') 期望它自动加载 —— 它不会帮你 require
如果假包有复杂依赖（比如用了 IlluminateSupportStr），确保这些真实依赖已装且可加载，否则 require_once 会直接 fatal

CI 环境下特别容易失效的点

Docker 构建缓存、CI 的 vendor 目录复用、甚至 IDE 的文件监听延迟，都会让你以为“刚改完 autoload-dev 就生效了”，其实没有。

每次改完 autoload-dev，必须显式执行：composer dump-autoload --dev
CI 脚本里别省这步，尤其用 --no-cache 或 --fresh 模式时
如果用路径仓库（"type": "path"）指向假包，记得 composer install 后检查 vendor/vendor-name/package-name 是符号链接还是复制体 —— 链接才能实时反映修改

最常被忽略的是：假包里的类用了 __DIR__ 或 __FILE__ 计算路径，而动态加载后它的实际位置变了，相对路径就崩了。