测试模拟器 Mocking

未匹配的标注
本文档最新版为 10.x,旧版本可能放弃维护,推荐阅读最新版!

Mocking

简介

在 Laravel 应用程序测试中,你可能希望「模拟」应用程序的某些功能的行为,从而避免该部分在测试中真正执行。例如:在控制器执行过程中会触发事件,您可能希望模拟事件监听器,从而避免该事件在测试时真正执行。这允许你在仅测试控制器 HTTP 响应的情况时,而不必担心触发事件,因为事件侦听器可以在它们自己的测试用例中进行测试。

Laravel 针对事件、任务和 Facades 的模拟,提供了开箱即用的辅助函数。这些函数基于 Mocker 封装而成,使用非常方便,无需手动调用复杂的 Mockery 函数。

模拟对象

当模拟一个对象将通过 Laravel 的 服务容器 注入到应用中时,你将需要将模拟实例作为 instance 绑定到容器中。这将告诉容器使用对象的模拟实例,而不是构造对象的真身:

use App\Service;
use Mockery;
use Mockery\MockInterface;

public function test_something_can_be_mocked()
{
    $this->instance(
        Service::class,
        Mockery::mock(Service::class, function (MockInterface $mock) {
            $mock->shouldReceive('process')->once();
        })
    );
}

为了让以上过程更加便捷,你可以使用 Laravel 的基本测试用例类提供 mock 方法:

use App\Service;
use Mockery\MockInterface;

$mock = $this->mock(Service::class, function (MockInterface $mock) {
    $mock->shouldReceive('process')->once();
});

当你只需要模拟对象的几个方法时,可以使用 partialMock 方法。 未被模拟的方法将在调用时正常执行:

use App\Service;
use Mockery\MockInterface;

$mock = $this->partialMock(Service::class, function (MockInterface $mock) {
    $mock->shouldReceive('process')->once();
});

同样,如果你想侦查一个对象,Laravel 的基本测试用例类提供了一个便捷的 spy 方法作为 Mockery::spy 的替代方法,但是,spy会记录spy与被测试代码之间的任何交互,从而允许您在执行代码后做出断言:

use App\Service;

$spy = $this->spy(Service::class);

// ...

$spy->shouldHaveReceived('process');

Facades模拟

与传统静态方法调用不同的是,facades (including real-time facades) 也可以被模拟。相较传统的静态方法而言,它具有很大的优势,即便你使用依赖注入,可测试性不逊半分。在测试中,你可能想在控制器中模拟对 Laravel Facade 的调用。比如下面控制器中的行为:

<?php

namespace App\Http\Controllers;

use Illuminate\Support\Facades\Cache;

class UserController extends Controller
{
    /**
     * 显示该应用程序的所有用户的列表.
     *
     * @return \Illuminate\Http\Response
     */
    public function index()
    {
        $value = Cache::get('key');

        //
    }
}

我们可以使用 shouldReceive 方法模拟对 Cache Facade 的调用,该方法将返回一个 Mockery 模拟的实例。由于 Facades 实际上是由 Laravel 服务容器 解析和管理的,因此它们比传统的静态类具有更好的可测试性。例如,让我们模拟对 Cache Facade 的 get 方法的调用:

<?php

namespace Tests\Feature;

use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Foundation\Testing\WithoutMiddleware;
use Illuminate\Support\Facades\Cache;
use Tests\TestCase;

class UserControllerTest extends TestCase
{
    public function testGetIndex()
    {
        Cache::shouldReceive('get')
                    ->once()
                    ->with('key')
                    ->andReturn('value');

        $response = $this->get('/users');

        // ...
    }
}

注意:你不应该模拟 Request facade。相反,在运行测试时将您想要的输入传递到 HTTP 测试方法 中,例如 getpost。同样,不要模拟 Config facade,而是在测试中调用 Config::set 方法。

Facade Spies

如果你想 spy 一个 facade,你可以在相应的 facade 上调用 spy 方法。spy 类似于模拟;但是,spy 记录 spy 和被测试代码之间的所有交互,允许你在代码执行后做出断言:

use Illuminate\Support\Facades\Cache;

public function test_values_are_be_stored_in_cache()
{
    Cache::spy();

    $response = $this->get('/');

    $response->assertStatus(200);

    Cache::shouldHaveReceived('put')->once()->with('name', 'Taylor', 10);
}

Bus Fake

在测试分发任务的代码时,您通常希望断言已分发给定任务,但实际不进入队列或执行任务。这是因为任务的执行通常可以在单独的测试类中进行测试。

您可以使用 Bus facade 的 fake 方法来防止将任务分发到队列。然后,在执行测试代码后,您可以使用 assertDispatchedassertNotDispatched 方法检查应用试图分发的任务:

<?php

namespace Tests\Feature;

use App\Jobs\ShipOrder;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Foundation\Testing\WithoutMiddleware;
use Illuminate\Support\Facades\Bus;
use Tests\TestCase;

class ExampleTest extends TestCase
{
    public function test_orders_can_be_shipped()
    {
        Bus::fake();

        // 执行订单发货……

        // 断言任务被分发……
        Bus::assertDispatched(ShipOrder::class);

        // 断言任务没有被分发
        Bus::assertNotDispatched(AnotherJob::class);
    }
}

您可以将闭包传递给 assertDispatchedassertNotDispatched 方法,以断言已分发的任务通过了给定的「真实性测试」。如果至少分发了一个通过给定真实性测试的任务,则断言将成功。例如,您可能希望声明已为特定订单分发任务:

Bus::assertDispatched(function (ShipOrder $job) use ($order) {
    return $job->order->id === $order->id;
});

任务链

Bus facade 的 assertChained 方法可用于断言 任务链 已被调度。 assertChained 方法接受一个链式任务数组作为它的第一个参数:

use App\Jobs\RecordShipment;
use App\Jobs\ShipOrder;
use App\Jobs\UpdateInventory;
use Illuminate\Support\Facades\Bus;

Bus::assertChained([
    ShipOrder::class,
    RecordShipment::class,
    UpdateInventory::class
]);

如上例所示,链式任务的数组可是任务类名的数组。但是,您也可以提供实际任务实例的数组。执行此操作时,Laravel 将确保任务实例属于同一类,并且具有与应用分发的任务链相同的属性值:

Bus::assertChained([
    new ShipOrder,
    new RecordShipment,
    new UpdateInventory,
]);

任务批处理

Bus facade 的 assertBatched 方法可以用来断言 批量任务 被分发。提供给 assertBatched 方法的闭包接收一个 Illuminate\Bus\PendingBatch 的实例,它可用于检查批处理中的任务:

use Illuminate\Bus\PendingBatch;
use Illuminate\Support\Facades\Bus;

Bus::assertBatched(function (PendingBatch $batch) {
    return $batch->name == 'import-csv' &&
           $batch->jobs->count() === 10;
});

事件模拟

在测试分发事件的代码时,您可能希望指示 Laravel 不要执行事件的监听器。 使用 Event facade 的 fake 方法可以阻止监听器执行,执行测试代码后使用 assertDispatchedassertNotDispatchedassertNothingDispatched 方法断言应用分发了哪些事件:

<?php

namespace Tests\Feature;

use App\Events\OrderFailedToShip;
use App\Events\OrderShipped;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Foundation\Testing\WithoutMiddleware;
use Illuminate\Support\Facades\Event;
use Tests\TestCase;

class ExampleTest extends TestCase
{
    /**
     * 测试订单发货
     */
    public function test_orders_can_be_shipped()
    {
        Event::fake();

        // 指定订单发货……

        // 断言事件被分发……
        Event::assertDispatched(OrderShipped::class);

        // 断言事件被分发了两次……
        Event::assertDispatched(OrderShipped::class, 2);

        // 断言事件未被分发……
        Event::assertNotDispatched(OrderFailedToShip::class);

        // 断言没有任务事件被分发……
        Event::assertNothingDispatched();
    }
}

您可以将闭包传递给 assertDispatchedassertNotDispatched 方法,以断言已分发的事件通过了给定的「真实性测试」。如果至少分发了一个通过给定真实性测试的事件,则断言将成功

Event::assertDispatched(function (OrderShipped $event) use ($order) {
    return $event->order->id === $order->id;
});

注意:调用 Event::fake() 后不会执行事件监听器。所以,如果你的测试用到了依赖于事件的模型工厂,例如,在模型的 creating 事件中创建 UUID ,那么你应该在使用模型工厂 之后 调用 Event::fake()

模拟事件的子集

如果你只想为特定的一组事件模拟事件监听器,你可以将它们传递给 fakefakeFor 方法:

/**
 * 测试订单流程。
 */
public function test_orders_can_be_processed()
{
    Event::fake([
        OrderCreated::class,
    ]);

    $order = Order::factory()->create();

    Event::assertDispatched(OrderCreated::class);

    // 其他事件照常分发……
    $order->update([...]);
}

Scoped 事件模拟

如果你只想为部分测试模拟事件监听,则可以使用 fakeFor 方法:

<?php

namespace Tests\Feature;

use App\Events\OrderCreated;
use App\Models\Order;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\Event;
use Illuminate\Foundation\Testing\WithoutMiddleware;
use Tests\TestCase;

class ExampleTest extends TestCase
{
    /**
     * 测试订单流程。
     */
    public function test_orders_can_be_processed()
    {
        $order = Event::fakeFor(function () {
            $order = Order::factory()->create();

            Event::assertDispatched(OrderCreated::class);

            return $order;
        });

        // 事件照常分发,且观察者将运行 ...
        $order->update([...]);
    }
}

HTTP 模拟

Http facade 的 fake 方法允许您指示 HTTP 客户端在发出请求时返回虚拟响应。有关伪造发出 HTTP 请求的更多信息,请参阅 HTTP客户端测试文档

邮件模拟

您可以使用 Mail facade 的 fake 方法阻止邮件发送。通常,发送邮件与实际测试的代码无关。一般只要断言发送了给定的邮件就足够了。

调用 Mail facade 的 fake 方法后,您可以断言 mailables 被指示发送给用户,甚至检查 mailables 收到的数据:

<?php

namespace Tests\Feature;

use App\Mail\OrderShipped;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Foundation\Testing\WithoutMiddleware;
use Illuminate\Support\Facades\Mail;
use Tests\TestCase;

class ExampleTest extends TestCase
{
    public function test_orders_can_be_shipped()
    {
        Mail::fake();

        // 执行订单发货……

        // 断言没有发送任何邮件……
        Mail::assertNothingSent();

        // 断言发送了邮件……
        Mail::assertSent(OrderShipped::class);

        // 断言邮件发送了两遍……
        Mail::assertSent(OrderShipped::class, 2);

        // 断言邮件未发送……
        Mail::assertNotSent(AnotherMailable::class);
    }
}

如果你用后台任务执行邮件发送队列,你应该使用 assertQueued 代替 assertSent

Mail::assertQueued(OrderShipped::class);

Mail::assertNotQueued(OrderShipped::class);

Mail::assertNothingQueued();

你可以将闭包传递给 assertSentassertNotSent 方法,以断言发送的邮件通过了给定的 「真实性测试」。如果至少发送了一封通过给定真实性测试的邮件,则断言将成功:

Mail::assertSent(function (OrderShipped $mail) use ($order) {
    return $mail->order->id === $order->id;
});

调用 Mail facade 的断言方法时, 所提供的闭包接受的 mailable 实例公开了检查 mailable 的收件人的实用方法:

Mail::assertSent(OrderShipped::class, function ($mail) use ($user) {
    return $mail->hasTo($user->email) &&
           $mail->hasCc('...') &&
           $mail->hasBcc('...');
});

通知模拟

您可以使用 Notification facade 的 fake方法来阻止发送通知。通常,发送通知与实际测试的代码无关。一般,只要断言 Laravel 发送给定的通知就足够了。

调用了 Notification facade 的 fake 方法之后,你可以断言 通知 被发送给用户, 甚至可以检查 notifications 收到的数据。

<?php

namespace Tests\Feature;

use App\Notifications\OrderShipped;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Foundation\Testing\WithoutMiddleware;
use Illuminate\Support\Facades\Notification;
use Tests\TestCase;

class ExampleTest extends TestCase
{
    public function test_orders_can_be_shipped()
    {
        Notification::fake();

        // 执行订单发货……

        // 断言没有发送任何通知……
        Notification::assertNothingSent();

        // 断言通知被发送给指定用户……
        Notification::assertSentTo(
            [$user], OrderShipped::class
        );

        // 断言通知未发送……
        Notification::assertNotSentTo(
            [$user], AnotherNotification::class
        );
    }
}

您可以将闭包传递给 assertSentToassertNotSentTo 方法,以断言发送的通知通过了给定的 「真实性测试」。如果至少发送了一个通过给定真实性测试的通知,则断言将成功:

Notification::assertSentTo(
    $user,
    function (OrderShipped $notification, $channels) use ($order) {
        return $notification->order->id === $order->id;
    }
);

按需通知

如果您正在测试发送 按需通知,则您需要断言通知已发送到 Illuminate\Notifications\AnonymousNotifiable 实例:

use Illuminate\Notifications\AnonymousNotifiable;

Notification::assertSentTo(
    new AnonymousNotifiable, OrderShipped::class
);

通过将闭包作为第三个参数传递给通知断言方法,您可以确定是否已将按需通知发送到正确的「路由」地址:

Notification::assertSentTo(
    new AnonymousNotifiable,
    OrderShipped::class,
    function ($notification, $channels, $notifiable) use ($user) {
        return $notifiable->routes['mail'] === $user->email;
    }
);

队列模拟

可以使用 Queue facade 的 fake 方法来防止任务被推送到队列中。通常,只要断言将给定的任务推送到队列就足够了,因为队列任务本身可以在另一个测试类中进行测试。

调用 Queue facade 的 fake 方法后,您可以断言应用试图将任务推送到队列:

<?php

namespace Tests\Feature;

use App\Jobs\AnotherJob;
use App\Jobs\FinalJob;
use App\Jobs\ShipOrder;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Foundation\Testing\WithoutMiddleware;
use Illuminate\Support\Facades\Queue;
use Tests\TestCase;

class ExampleTest extends TestCase
{
    public function test_orders_can_be_shipped()
    {
        Queue::fake();

        // 执行订单发货……

        // 断言没有任务被推送……
        Queue::assertNothingPushed();

        // 断言任务被推送到指定队列……
        Queue::assertPushedOn('queue-name', ShipOrder::class);

        //  断言任务被推送了两次……
        Queue::assertPushed(ShipOrder::class, 2);

        // 断言任务未被推送……
        Queue::assertNotPushed(AnotherJob::class);
    }
}

您可以将闭包传递给 assertPushedassertNotPushed 方法,以断言推送的任务通过了给定的 「真实性测试」。如果至少推送了一个通过给定真实性测试的任务,则断言将成功:

Queue::assertPushed(function (ShipOrder $job) use ($order) {
    return $job->order->id === $order->id;
});

任务链

Queue facade 的 assertPushedWithChainassertPushedWithoutChain 方法可用于检查推送任务的任务链。 assertPushedWithChain 方法接受主任务作为第一个参数,接受链式任务数组作为第二个参数:

use App\Jobs\RecordShipment;
use App\Jobs\ShipOrder;
use App\Jobs\UpdateInventory;
use Illuminate\Support\Facades\Queue;

Queue::assertPushedWithChain(ShipOrder::class, [
    RecordShipment::class,
    UpdateInventory::class
]);

如上例所示,链式任务的数组可能是任务类名的数组。但是,您也可以提供实际任务实例的数组。执行此操作时,Laravel 将确保任务实例属于同一类,并且具有应用调度的任务链的相同属性值:

Queue::assertPushedWithChain(ShipOrder::class, [
    new RecordShipment,
    new UpdateInventory,
]);

您可以使用 assertPushedWithoutChain 方法断言在没有任务链的情况下推送任务:

Queue::assertPushedWithoutChain(ShipOrder::class);

存储模拟

你可以使用 Storage Facade 的 fake 方法,轻松的生成一个模拟磁盘,结合 Illuminate\Http\UploadedFile 类的文件生成工具,极大的简化了文件上传测试。例如:

<?php

namespace Tests\Feature;

use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Foundation\Testing\WithoutMiddleware;
use Illuminate\Http\UploadedFile;
use Illuminate\Support\Facades\Storage;
use Tests\TestCase;

class ExampleTest extends TestCase
{
    public function test_albums_can_be_uploaded()
    {
        Storage::fake('photos');

        $response = $this->json('POST', '/photos', [
            UploadedFile::fake()->image('photo1.jpg'),
            UploadedFile::fake()->image('photo2.jpg')
        ]);

        // 断言一个或多个文件已存储……
        Storage::disk('photos')->assertExists('photo1.jpg');
        Storage::disk('photos')->assertExists(['photo1.jpg', 'photo2.jpg']);

        //  断言一个或多个文件未存储……
        Storage::disk('photos')->assertMissing('missing.jpg');
        Storage::disk('photos')->assertMissing(['missing.jpg', 'non-existing.jpg']);
    }
}

有关测试文件上传的更多信息,您可以参考 HTTP测试文档的文件上传信息

技巧:默认情况下,fake 方法将删除临时目录下所有文件。如果你想保留这些文件,你可以使用 「persistentFake」。

时间交互

测试时,有时可能需要修改诸如 nowIlluminate\Support\Carbon::now() 之类的助手返回的时间。 值得庆幸的是,Laravel 的基本功能测试类包括一些帮助程序,可让您操纵当前时间:

public function testTimeCanBeManipulated()
{
    // 调至未来……
    $this->travel(5)->milliseconds();
    $this->travel(5)->seconds();
    $this->travel(5)->minutes();
    $this->travel(5)->hours();
    $this->travel(5)->days();
    $this->travel(5)->weeks();
    $this->travel(5)->years();

    // 调至过去……
    $this->travel(-5)->hours();

    // 调至一个明确的时间……
    $this->travelTo(now()->subHours(6));

    // 返回现在……
    $this->travelBack();
}

本文章首发在 LearnKu.com 网站上。

本译文仅用于学习和交流目的,转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议,如果我们的工作有侵犯到您的权益,请及时联系我们。

原文地址:https://learnku.com/docs/laravel/8.5/moc...

译文地址:https://learnku.com/docs/laravel/8.5/moc...

上一篇 下一篇
《L02 从零构建论坛系统》
以构建论坛项目 LaraBBS 为线索,展开对 Laravel 框架的全面学习。应用程序架构思路贴近 Laravel 框架的设计哲学。
《G01 Go 实战入门》
从零开始带你一步步开发一个 Go 博客项目,让你在最短的时间内学会使用 Go 进行编码。项目结构很大程度上参考了 Laravel。
贡献者:3
讨论数量: 0
发起讨论 查看所有版本


暂无话题~