如何在 PHP 中通过Composer安装 Mockery 库模拟复杂的对象行为-composer-PHP中文网

composer安装mockery报“找不到包”是因为默认仅拉取stable版本，而mockery最新版（如1.6.x-dev或dev-main）标记为dev状态；需显式指定版本如composer require mockery/mockery:^1.6 --with-all-dependencies或临时配置minimum-stability dev。

如何在 php 中通过composer安装 mockery 库模拟复杂的对象行为

Composer 安装 Mockery 时为什么 `composer require` 报错说找不到包？

Mockery 默认不发布在 Packagist 主仓库的稳定通道，直接运行 composer require mockery/mockery 可能失败，尤其在 PHP 8.2+ 或使用较新 Composer 版本时。根本原因是默认只拉取 stable 版本，而 Mockery 的最新版（如 dev-main 或 1.6.x-dev）常标记为 dev 状态。

解决办法是显式允许开发版本：

运行 composer require mockery/mockery:^1.6 --with-all-dependencies（推荐指定小版本号，避免意外升级到破坏性变更的预发布版）
若仍失败，临时放宽稳定性要求：composer config minimum-stability dev && composer config prefer-stable true，再执行 require
安装后检查 vendor/mockery/mockery 是否存在，并确认 autoload-dev 已自动注册（Mockery 是 dev-only 依赖，不应出现在生产 autoloader 中）

Mockery 在 PHPUnit 测试中无法识别 `Mockery::mock()` 怎么办？

常见现象是 PHP 报错 Class 'Mockery' not found 或 Call to undefined method Mockery::mock()，本质是自动加载没生效或命名空间用错。

关键点：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

确保测试文件顶部有 use Mockery; —— Mockery 不提供全局函数，Mockery::mock() 必须走类名调用或 alias
检查 phpunit.xml 是否包含 <php><include path="vendor/autoload.php"></include></php>，否则 Composer autoloader 不加载
若用 PHPUnit 10+，且项目启用了严格模式，需在 setUp() 里加 Mockery::resetContainer();，否则上一个测试残留的 mock 会干扰当前测试
别写成 mockery::mock()（小写）—— 类名区分大小写，PHP 会报错

模拟带构造参数或私有方法的对象时，`Mockery::mock()` 参数怎么填？

Mockery 支持三种主要模拟方式，参数结构差异大，填错会导致 mock 创建失败或行为异常：

模拟接口：Mockery::mock('MyInterface') —— 最安全，无构造函数干扰
模拟具体类并绕过构造函数：Mockery::mock('MyClass[]')（方括号表示忽略构造参数），或 Mockery::mock('MyClass')->makePartial()（只 mock 部分方法）
模拟带构造参数的类：Mockery::mock('MyClass[realMethod]', ['arg1', 'arg2'])，其中 [realMethod] 表示保留该方法真实逻辑，后面数组是传给构造函数的参数
注意：模拟 final 类或含 final 方法的类需启用 hhvm.enable_zend_compat=1（HHVM）或改用 PHP 8.0+ 的 #[\Mockery\NoAutoGenerate] 注解（Mockery 1.6+），否则直接失败

为什么 `Mockery::close()` 被弃用，现在该用什么？

Mockery 1.4+ 移除了全局 Mockery::close()，因为它依赖全局状态清理，在并行测试或复杂生命周期中不可靠。现在必须用容器机制显式管理。

正确做法：

在 tearDown() 中调用 Mockery::getContainer()->mocks()->clear();（清空当前容器所有 mock）
更推荐的方式是每个测试单独创建容器：$container = Mockery::getContainer(); $mock = $container->mock('Foo'); ... $container->mocks()->clear();
若用 PHPUnit 9.5+，可配合 Mockery\Adapter\Phpunit\MockeryTestCase 基类，它自动处理容器清理，但需确保测试类继承它而非 PHPUnit\Framework\TestCase
漏掉清理会导致后续测试收到“Undefined index”或“Method not found”等诡异错误，因为旧 mock 还挂在容器里

Mockery 的核心不是“造个假对象就完事”，而是控制行为契约和验证调用链——容器生命周期、方法签名匹配、构造绕过方式，这三个点没对齐，哪怕语法全对，也会在运行时崩。