Mockery项目教程：如何在类内部模拟其他类的实例

原创于 2025-06-04 09:01:46 发布 · 179 阅读

CC 4.0 BY-SA版权

Mockery项目教程：如何在类内部模拟其他类的实例

mockery Mockery是一个针对PHP的轻量级模拟对象框架，专为进行依赖注入和隔离测试设计，通过创建模拟对象替代真实依赖，使得单元测试更便捷、高效。项目地址: https://gitcode.com/gh_mirrors/mo/mockery

理解问题场景

在单元测试中，我们经常需要模拟(mock)某些类的行为，特别是当这些类执行一些我们不希望在测试中实际执行的操作时（如数据库访问、网络请求等）。Mockery作为PHP的一个强大的模拟框架，可以帮助我们实现这一目标。

但在某些特定场景下，直接使用Mockery会遇到挑战。比如当一个类在其方法内部直接实例化另一个类时，传统的模拟方法就会失效。让我们通过一个具体例子来理解这个问题。

示例代码分析

假设我们有两个类：

// Point.php
namespace App;

class Point {
    public function setPoint($x, $y) {
        echo "Point (" . $x . ", " . $y . ")" . PHP_EOL;
    }
}

// Rectangle.php
namespace App;
use App\Point;

class Rectangle {
    public function create($x1, $y1, $x2, $y2) {
        $a = new Point();
        $a->setPoint($x1, $y1);
        
        $b = new Point();
        $b->setPoint($x2, $y1);
        
        $c = new Point();
        $c->setPoint($x2, $y2);
        
        $d = new Point();
        $d->setPoint($x1, $y2);
        
        $this->draw([$a, $b, $c, $d]);
    }
    
    public function draw($points) {
        echo "Do something with the points";
    }
}

在这个例子中，Rectangle类的create方法内部直接实例化了多个Point对象。如果我们想测试create方法，但不希望实际执行Point的setPoint方法或Rectangle的draw方法，传统的模拟方法会遇到问题。

传统模拟方法的问题

尝试直接模拟这两个类：

class MyTest extends PHPUnit\Framework\TestCase {
    public function testCreate() {
        $point = Mockery::mock("App\Point");
        $point->shouldReceive("setPoint")->andThrow(Exception::class);
        
        $rect = Mockery::mock("App\Rectangle")->makePartial();
        $rect->shouldReceive("draw");
        
        $rect->create(0, 0, 100, 100);  // 不会抛出异常
        Mockery::close();
    }
}

这个测试不会按预期工作，因为Point类已经被自动加载，Mockery无法拦截new Point()的调用。

问题根源

问题的核心在于PHP的类加载机制。当类已经被加载后，Mockery无法拦截对该类的直接实例化。在复杂的依赖关系中，这会导致一系列连锁反应：

A        // 主加载入口
|- B     // 另一个加载入口
|  |-E
|  +-G
|
|- C     // 另一个加载入口
|  +-F
|
+- D

每个加载入口都会触发一系列类的加载，使得在这些路径上的类难以被模拟。

解决方案：工厂方法模式

解决这个问题的有效方法是引入工厂方法，将对象的创建封装到一个单独的方法中：

class Rectangle {
    public function newPoint() {
        return new Point();
    }
    
    public function create($x1, $y1, $x2, $y2) {
        $a = $this->newPoint();
        $a->setPoint($x1, $y1);
        // ... 其他点
    }
    // ...
}

然后在测试中，我们可以模拟这个工厂方法：

class MyTest extends PHPUnit\ramework\TestCase {
    public function testCreate() {
        $point = Mockery::mock("App\Point");
        $point->shouldReceive("setPoint")->andThrow(Exception::class);
        
        $rect = Mockery::mock("App\Rectangle")->makePartial();
        $rect->shouldReceive("draw");
        
        // 让newPoint方法返回我们的模拟Point对象
        $rect->shouldReceive("newPoint")->andReturn($point);
        
        $this->expectException(Exception::class);
        $rect->create(0, 0, 100, 100);
        Mockery::close();
    }
}