Composer如何安装Mockery Mock库_Composer安装Mockery Mock库要点

Composer安装Mockery Mock库要点

直接运行 composer require --dev mockery/mockery 就能装好，但装完报 “Class 'Mockery' not found” 是最常踩的坑，问题几乎都不出在安装本身。

为什么 composer require --dev mockery/mockery 装完还找不到类

根本原因不是没下载成功，而是自动加载没生效或测试入口没触发它：

• 没在测试引导文件（如 tests/bootstrap.php）里 require_once 'vendor/autoload.php'；
• 用 phpunit tests/ExampleTest.php 直接跑单个文件时，PHPUnit 默认不加载项目级 bootstrap，得显式加参数：phpunit --bootstrap vendor/autoload.php tests/ExampleTest.php；
• composer.json 的 "autoload-dev" 段没包含测试目录（比如 "tests/": ["tests/"]），导致 Mockery 的命名空间没注册进 Composer 加载器；
• PHP 版本低于 7.4 —— Mockery v1.6+ 要求 PHP ≥ 7.4，旧项目需降级安装：composer require --dev mockery/mockery:^1.5。

PHPUnit 10+ 下 Mockery 报错 “Dynamic class generation is disabled” 怎么办

PHPUnit 10 默认禁用 eval()，而 Mockery 默认靠它动态生成 mock 类。不改配置就会卡住：

• 最快方案：在 phpunit.xml 的 根节点加属性 processIsolation="false"；
• 更稳妥方案：改用 Mockery::namedMock('MyClass') 替代 Mockery::mock(MyClass::class)，它不依赖 eval；
• 别碰 ini_set('zend.enable_gc', 0) 这类绕过限制的 hack，PHP 8.2+ 已彻底移除相关兼容层。

Mockery::close() 忘写或写错位置会怎样

不调 Mockery::close() 不只是内存泄漏，更会导致后续测试失败，且错误现象非常隐蔽：

• 在 setUp() 里写 Mockery::close() 是错的 —— 它会清空上一个测试留下的所有 mock，下一个测试刚起步就发现 mock 状态已毁；
• 正确位置是 tearDown() 末尾，且必须在 parent::tearDown() 之后（PHPUnit 9.3+）；
• 如果用了 setUpBeforeClass() 创建全局 mock，Mockery::close() 会把它也干掉，引发 “Undefined index” 类错误；
• 常见错误信息：No matching handler found 或 Method xxx not allowed on this mock，八成是前一个测试的 mock 残留干扰了当前测试。

话说回来，Mockery 的核心矛盾在于：它强大在动态行为定义能力，代价是必须严格管理生命周期。漏掉 Mockery::close() 或放错位置，比装不上库更难排查——因为代码能跑、断言能过，只在特定测试顺序下才崩。