使用 Event::fake() 拦截事件后,可通过 assertDispatched 断言事件被触发、assertDispatchedTimes 验证触发次数、assertNotDispatched 确保未触发,并可结合闭包验证事件数据。在 Laravel 测试中,你可以使用框架提供的测试辅助方法来断言某个事件是否被正确分发。Laravel 的事件系统与测试工具集成良好,使得在功能测试或单元测试中验证事件触发变得简单直观。
示例代码:
use Illuminate\Support\Facades\Event;
use App\Events\UserRegistered;
public function test_user_registration_dispatches_event()
{
Event::fake();
$this->expectsEvents(UserRegistered::class);
// 执行触发事件的操作
$this->post('/register', [
'name' => 'John Doe',
'email' => 'john@example.com',
'password' => 'secret'
]);
}
注意:`expectsEvents` 是一个便捷方式,它本质上会配合 `Event::fake()` 使用,确保只有列出的事件被允许触发。
常用方法包括:
tched():断言事件未被触发
use Illuminate\Support\Facades\Event;
use App\Events\OrderShipped;
public function test_order_shipment_dispatches_event()
{
Event::fake();
// 执行业务逻辑
$order = Order::factory()->create();
$order->ship();
// 断言事件被触发
Event::assertDispatched(OrderShipped::class);
// 断言事件触发一次
Event::assertDispatchedTimes(OrderShipped::class, 1);
// 断言事件带有特定数据
Event::assertDispatched(OrderShipped::class, function ($event) use ($order) {
return $event->order->id === $order->id;
});
}
Event::fake(); // 执行某些操作 $user = User::factory()->make(); $user->save(); // 假设未触发 UserRegistered Event::assertNotDispatched(UserRegistered::class);这种方法常用于避免重复触发或条件性触发场景。 基本上就这些。只要记得先调用 `Event::fake()` 拦截事件,再用 `assertDispatched` 系列方法做判断,就能轻松完成事件断言。