# Laravel 测试之:测试模拟器
- [介绍](#introduction)
- [任务模拟](#bus-fake)
- [事件模拟](#event-fake)
- [邮件模拟](#mail-fake)
- [通知模拟](#notification-fake)
- [队列模拟](#queue-fake)
- [Storage 模拟](#storage-fake)
- [Facades 模拟](#mocking-facades)
## 介绍
测试 Laravel 应用时,有时候你可能想要「模拟」实现应用的部分功能的行为,从而避免该部分在测试过程中真正执行。例如,控制器执行过程中会触发一个事件( Events ),你想要模拟这个事件的监听器,从而避免该事件在测试这个控制器时真正执行。如上可以让你仅测试控制器的 HTTP 响应情况,而不用去担心触发事件。当然,你可以在单独的测试中测试该事件的逻辑。
Laravel 针对事件、任务和 facades 的模拟提供了开箱即用的辅助函数。这些辅助函数基于 Mockery 封装而成,使用非常简单,无需你手动调用复杂的 Mockery 函数。当然,你也可以使用 [Mockery](http://docs.mockery.io/en/latest/) 或者 PHPUnit 创建自己的模拟器。
## 任务模拟
你可以使用 `Bus` facade 的 `fake` 方法来模拟任务执行,测试的时候任务不会被真实执行。使用 fakes 的时候,断言一般出现在测试代码的后面:
order->id === $order->id;
});
// 断言任务并没有被执行...
Bus::assertNotDispatched(AnotherJob::class);
}
}
## 事件模拟
你可以使用 `Event` facade 的 `fake` 方法来模拟事件监听,测试的时候不会触发事件监听器运行。然后你就可以断言事件运行了,甚至可以检查它们收到的数据。使用 fakes 的时候,断言一般出现在测试代码的后面:
order->id === $order->id;
});
Event::assertNotDispatched(OrderFailedToShip::class);
}
}
## 邮件模拟
你可以使用 `Mail` facade 的 `fake` 方法来模拟邮件发送,测试时不会真的发送邮件。然后你可以断言 [mailables](/docs/{{version}}/mail) 发送给了用户,甚至可以检查他们收到的数据. 使用 fakes 时,断言一般在测试代码的后面:
order->id === $order->id;
});
// 断言一封邮件已经发送给了指定用户...
Mail::assertSent(OrderShipped::class, function ($mail) use ($user) {
return $mail->hasTo($user->email) &&
$mail->hasCc('...') &&
$mail->hasBcc('...');
});
// 断言 mailable 没有发送...
Mail::assertNotSent(AnotherMailable::class);
}
}
## 通知模拟
你可以使用 `Notification` facade 的 `fake` 方法来模拟通知发送,测试的时候并不会真的发送通知。然后你可以断言 [通知](/docs/{{version}}/notifications) 已经发送给你的用户,甚至可以检查他们收到的数据。使用 fakes 时, 断言一般出现在测试代码的后面.
order->id === $order->id;
}
);
// 断言通知已经发送给了指定用户...
Notification::assertSentTo(
[$user], OrderShipped::class
);
// 断言通知没有发送...
Notification::assertNotSentTo(
[$user], AnotherNotification::class
);
}
}
## 队列模拟
你可以使用 `Queue` facade 的 `fake` 方法来模拟任务队列,测试的时候并不会真的把任务放入队列。然后你可以断言任务被放进了队列,甚至可以检查它们收到的数据。使用 fakes 的时候,断言一般出现在测试代码的后面。
order->id === $order->id;
});
// 断言任务进入了指定队列
Queue::assertPushedOn('queue-name', ShipOrder::class);
// 断言任务没有进入队列
Queue::assertNotPushed(AnotherJob::class);
}
}
## Storage 模拟
利用 `Storage` facade 的 `fake` 方法,你可以轻松地生成一个模拟的磁盘,结合 `UploadedFile` 类的文件生成工具,极大地简化了文件上传测试。例如:
json('POST', '/avatar', [
'avatar' => UploadedFile::fake()->image('avatar.jpg')
]);
// 断言文件已存储
Storage::disk('avatars')->assertExists('avatar.jpg');
// 断言文件不存在
Storage::disk('avatars')->assertMissing('missing.jpg');
}
}
## Facades 模拟
不同于传统的静态函数的调用, [facades](/docs/{{version}}/facades) 也是可以被模拟的,相对静态函数来说这是个巨大的优势,即使你在使用依赖注入,测试时依然会非常方便。在很多测试中,你可能经常想在控制器中模拟对 Laravel facade 的调用。比如下面控制器中的行为:
once()
->with('key')
->andReturn('value');
$response = $this->get('/users');
// ...
}
}
> {note} 不可以模拟 `Request` facade,测试时,如果需要传递指定的数据请使用 HTTP 辅助函数,例如 `get` 和 `post`。类似的,请在你的测试中通过调用 `Config::set` 来模拟 `Config` facade。
---
> {note} 欢迎任何形式的转载,但请务必注明出处,尊重他人劳动共创开源社区。
>
> 转载请注明:本文档由 Laravel China 社区 [laravel-china.org] 组织翻译,详见 [翻译召集帖](https://learnku.com/laravel/t/3810/laravel-54-document-translation-come-and-join-the-translation)。
>
> 文档永久地址: http://d.laravel-china.org