イントロダクション
Laravelアプリケーションをテストするとき、アプリケーションの一部分を「モック」し、特定のテストを行う間は実際のコードを実行したくない場合があります。たとえば、イベントをディスパッチするコントローラをテストする場合、テスト中に実際に実行されないように、イベントリスナをモックすることができます。これにより、イベントリスナはそれ自身のテストケースでテストできるため、イベントリスナの実行について気を取られずに、コントローラのHTTPレスポンスのみをテストできます。
Laravelは最初からイベント、ジョブ、その他のファサードをモックするための便利な方法を提供しています。これらのヘルパは主にMockeryの便利なレイヤーを提供するため、複雑な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の基本テストケースクラスは、Mockery::spy
メソッドの便利なラッパーとしてspy
メソッドを提供しています。スパイはモックに似ています。ただし、スパイはスパイとテスト対象のコードとの間のやり取りを一度記録するため、コードの実行後にアサーションを作成できます。
use App\Service;
$spy = $this->spy(Service::class);
// …
$spy->shouldHaveReceived('process');
ファサードのモック
従来の静的メソッド呼び出しとは異なり、ファサード(リアルタイムファサードを含む)もモックできます。これにより、従来の静的メソッドに比べて大きな利点が得られ、従来の依存注入を使用した場合と同じくテストが簡単になります。テスト時、コントローラの1つで発生するLaravelファサードへの呼び出しをモックしたい場合がよくあるでしょう。例として、次のコントローラアクションについて考えてみます。
<?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
ファサードへの呼び出しをモックできます。これにより、Mockeryモックのインスタンスが返されます。ファサードは実際にはLaravelサービスコンテナによって依存解決および管理されるため、通常の静的クラスよりもはるかにテストがやりやすいのです。たとえば、Cache
ファサードの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');
// …
}
}
Warning!!
Request
ファサードをモックしないでください。代わりに、テストの実行時に、get
やpost
などのHTTPテストメソッドに必要な入力を渡します。同様に、Config
ファサードをモックする代わりに、テストではConfig::set
メソッドを呼び出してください。
ファサードのスパイ
ファサードでスパイしたい場合は、対応するファサードで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
ファサードのfake
メソッドを使用して、ジョブがキューにディスパッチされないようにすることができます。それから、テスト対象のコードを実行した後、assertDispatched
メソッドとassertNotDispatched
メソッドを使用してアプリケーションがディスパッチしようとしたジョブを調べられます。
<?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);
// 同期的にジョブがディスパッチされたことをアサート
Bus::assertDispatchedSync(AnotherJob::class);
// 同期的にジョブがディスパッチされなかったことをアサート
Bus::assertNotDispatchedSync(AnotherJob::class);
// レスポンス送信後にジョブがディスパッチされたことをアサート
Bus::assertDispatchedAfterResponse(AnotherJob::class);
// レスポンス送信後にジョブがディスパッチされなかったことをアサート
Bus::assertNotDispatchedAfterResponse(AnotherJob::class);
// 1つもジョブがディスパッチされないことをアサート
Bus::assertNothingDispatched();
}
}
特定の「論理テスト」に合格するジョブがディスパッチされたことをアサートするために、上記利用可能なメソッドへクロージャを渡せます。指定する論理テストに合格するジョブが最低1つディスパッチされた場合、アサーションは成功します。たとえば、ジョブが特定の注文でディスパッチされたことをアサートしたい場合があります。
Bus::assertDispatched(function (ShipOrder $job) use ($order) {
return $job->order->id === $order->id;
});
ジョブのサブセットのFake
もし、特定のジョブだけをディスパッチさせないようにしたい場合は、fake
メソッドへFakeするそのジョブを渡してください。
/**
* 注文処理のテスト
*/
public function test_orders_can_be_shipped()
{
Bus::fake([
ShipOrder::class,
]);
// ...
}
except
メソッドを使うと、指定したジョブ以外を全てFakeにできます。
Bus::fake()->except([
ShipOrder::class,
]);
ジョブチェーン
Bus
ファサードの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
ファサードの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;
});
ジョブ/バッチ間テスト
さらに、個々のジョブとその裏で動作しているバッチ間の相互作用をテストする必要がある場合があります。例えば、あるジョブがそのバッチの処理をキャンセルしたかどうかをテストする必要があるかもしれません。これを行うには、withFakeBatch
メソッドでFakeバッチをジョブへ割り当てる必要があります。withFakeBatch
メソッドは、ジョブのインスタンスとFakeバッチを含むタプルを返します。
[$job, $batch] = (new ShipOrder)->withFakeBatch();
$job->handle();
$this->assertTrue($batch->cancelled());
$this->assertEmpty($batch->added);
Event Fake
イベントをディスパッチするコードをテストするときは、イベントのリスナを実際に実行しないようにLaravelに指示することを推奨します。Event
ファサードのfake
メソッドを使用すると、リスナの実行を阻止し、テスト対象のコードを実行してから、assertDispatched
、assertNotDispatched
、assertNothingDispatched
メソッドを使用してアプリケーションがディスパッチするイベントをアサートできます。
<?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);
// イベントが2回ディスパッチされることをアサート
Event::assertDispatched(OrderShipped::class, 2);
// イベントがディスパッチされないことをアサート
Event::assertNotDispatched(OrderFailedToShip::class);
// イベントがディスパッチされなかったことをアサート
Event::assertNothingDispatched();
}
}
特定の「論理」に合格するイベントがディスパッチされたことをアサートするために、assertDispatched
またはassertNotDispatched
メソッドへクロージャを渡すことができます。指定する論理テストに合格するイベントが少なくとも1つディスパッチされた場合、アサーションは成功します。
Event::assertDispatched(function (OrderShipped $event) use ($order) {
return $event->order->id === $order->id;
});
イベントリスナが特定のイベントをリッスンしていることを単にアサートしたい場合は、assertListening
メソッドを使用することができます。
Event::assertListening(
OrderShipped::class,
SendShipmentNotification::class
);
Warning!!
Event::fake()
を呼び出した後、イベントリスナはすべて実行されません。したがって、モデルのcreating
イベント中にUUIDを作成するなど、イベントに依存するモデルファクトリをテストで使用する場合は、ファクトリを使用した後にEvent::fake()
を呼び出す必要があります。
イベントのサブセットのFake
特定のイベントに対してだけ、イベントリスナをFakeしたい場合は、fake
かfakeFor
メソッドに指定してください。
/**
* 受注処理のテスト
*/
public function test_orders_can_be_processed()
{
Event::fake([
OrderCreated::class,
]);
$order = Order::factory()->create();
Event::assertDispatched(OrderCreated::class);
// その他のイベントは通常通りディスパッチされる
$order->update([...]);
}
except
メソッドを使用すると、指定するイベントセットを除外した、残りのイベントをFakeできます。
Event::fake()->except([
OrderCreated::class,
]);
限定的なEvent Fake
テストの一部分だけでイベントをFakeしたい場合は、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 Fake
Http
ファサードのfake
メソッドでHTTPリクエスト作成時に、スタブした/ダミーのレスポンスを返すようにHTTPクライアントへ指示できます。送信するHTTPリクエストのFakeの詳細は、HTTPクライアントテストのドキュメントを調べてください。
Mail Fake
Mail
ファサードのfake
メソッドを使用して、メールが送信されないようにすることができます。通常、メールの送信は、実際にテストするコードとは関係ありません。ほとんどの場合、Laravelが特定のメールを送信するよう指示されたとアサートするだけで十分です。
Mail
ファサードの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();
// 注文の実行コード…
// mailableが送信されなかったことをアサート
Mail::assertNothingSent();
// mailableが送られたことをアサート
Mail::assertSent(OrderShipped::class);
// mailableが2回送信されたことをアサート
Mail::assertSent(OrderShipped::class, 2);
// mailableが送信されなかったことをアサート
Mail::assertNotSent(AnotherMailable::class);
}
}
バックグラウンドで配信するためにMailableをキュー投入する場合は、assertSent
の代わりにassertQueued
メソッドを使用する必要があります。
Mail::assertQueued(OrderShipped::class);
Mail::assertNotQueued(OrderShipped::class);
Mail::assertNothingQueued();
特定の「論理テスト」に合格したMailableが送信されたことをアサートするために、assertSent
、assertNotSent
、assertQueued
、assertNotQueued
メソッドにクロージャを渡すこともできます。指定する論理テストに合格するMailableが少なくとも1つ送信された場合、アサーションは成功します。
Mail::assertSent(function (OrderShipped $mail) use ($order) {
return $mail->order->id === $order->id;
});
Mail
ファサードのアサートメソッドを呼び出すと、引数中のクロージャが受け取るMailableインスタンスは、Mailableを調べる便利なメソッドを提供しています。
Mail::assertSent(OrderShipped::class, function ($mail) use ($user) {
return $mail->hasTo($user->email) &&
$mail->hasCc('...') &&
$mail->hasBcc('...') &&
$mail->hasReplyTo('...') &&
$mail->hasFrom('...') &&
$mail->hasSubject('...');
});
Mailableインスタンスは、添付ファイルを調べるために便利なメソッドもいくつか持っています。
use Illuminate\Mail\Mailables\Attachment;
Mail::assertSent(OrderShipped::class, function ($mail) {
return $mail->hasAttachment(
Attachment::fromPath('/path/to/file')
->as('name.pdf')
->withMime('application/pdf')
);
});
Mail::assertSent(OrderShipped::class, function ($mail) {
return $mail->hasAttachment(
Attachment::fromStorageDisk('s3', '/path/to/file')
);
});
Mail::assertSent(OrderShipped::class, function ($mail) use ($pdfData) {
return $mail->hasAttachment(
Attachment::fromData(fn () => $pdfData, 'name.pdf')
);
});
メールが送信されなかったことを宣言する方法として、assertNotSent
とassertNotQueued
の2つの方法があるのにお気づきでしょうか。時には、メールが送信されなかったこと、またはキューに入れられなかったことをアサートしたい場合があります。これを実現するには、assertNothingOutgoing
やassertNotOutgoing
メソッドを使用してください。
Mail::assertNothingOutgoing();
Mail::assertNotOutgoing(function (OrderShipped $mail) use ($order) {
return $mail->order->id === $order->id;
});
Mailable内容のテスト
Mailableの内容のテストと、Mailableが特定のユーザーへ「送信」されたことをアサートするテストは別にすることをお勧めします。Mailableの内容をテストする方法は、Mailablesのテストのドキュメントを参照してください。
Notification Fake
Notification
ファサードのfake
メソッドを使用して、通知が送信されないようにすることができます。通常、通知の送信は、実際にテストしているコードとは関係ありません。ほとんどの場合、Laravelが特定の通知を送信するように指示したことをアサートするだけで十分です。
Notification
ファサードのfake
メソッドを呼び出した後、通知がユーザーへ送信されるように指示されたことをアサートし、通知が受信したデータを検査することもできます。
<?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
);
// 指定した数の通知が送信されたことをアサート
Notification::assertCount(3);
}
}
特定の「論理テスト」に合格した通知が送信されたことをアサートするために、assertSentTo
またはassertNotSentTo
メソッドへクロージャを渡すこともできます。指定する論理テストに合格する通知が少なくとも1つ送信された場合、アサーションは成功します。
Notification::assertSentTo(
$user,
function (OrderShipped $notification, $channels) use ($order) {
return $notification->order->id === $order->id;
}
);
オンデマンド通知
テストしているコードがオンデマンド通知を送る場合、assertSentOnDemand
メソッドにより、そのオンデマンド通知が送られたことをテストできます。
Notification::assertSentOnDemand(OrderShipped::class);
assertSentOnDemand
メソッドの第2引数にクロージャを渡し、オンデマンド通知が正しい「ルート(route)」アドレスへ送られたかを判定できます。
Notification::assertSentOnDemand(
OrderShipped::class,
function ($notification, $channels, $notifiable) use ($user) {
return $notifiable->routes['mail'] === $user->email;
}
);
Queue Fake
Queue
ファサードのfake
メソッドを使用して、キュー投入するジョブをキュー投入しないでおくことができます。ほとんどの場合、キュー投入するジョブ自体は別のテストクラスでテストされる可能性が高いため、Laravelが特定のジョブをキューへ投入するように指示したことをアサートするだけで十分です。
Queue
ファサードの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);
// ジョブが2回投入されたことをアサート
Queue::assertPushed(ShipOrder::class, 2);
// ジョブが投入されなかったことをアサート
Queue::assertNotPushed(AnotherJob::class);
}
}
特定の「論理テスト」に合格するジョブが投入されたことをアサートするために、assertPushed
またはassertNotPushed
メソッドにクロージャを渡すこともできます。指定する論理テストに合格するジョブが少なくとも1つ投入された場合、アサートは成功します。
Queue::assertPushed(function (ShipOrder $job) use ($order) {
return $job->order->id === $order->id;
});
もし、特定のジョブだけをfakeし、他のジョブは通常通り実行させたい場合は、fake
メソッドにfakeするジョブのクラス名を渡します。
public function test_orders_can_be_shipped()
{
Queue::fake([
ShipOrder::class,
]);
// 注文の発送処理の実行…
// ジョブが2回キュー投入されることをアサート
Queue::assertPushed(ShipOrder::class, 2);
}
ジョブチェーン
Queue
ファサードのassertPushedWithChain
メソッドとassertPushedWithoutChain
メソッドを使用して、投入したジョブのジョブチェーンを検査できます。assertPushedWithChain
メソッドは、最初の引数にプライマリジョブをとり、2番目の引数としてチェーンジョブの配列を取ります。
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 Fake
Storage
ファサードの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']);
// 指定したディレクトリが空であることをアサート
Storage::disk('photos')->assertDirectoryEmpty('/wallpapers');
}
}
fake
メソッドはデフォルトで、一時ディレクトリにあるすべてのファイルを削除します。これらのファイルを残しておきたい場合は、代わりにpersistentFake
メソッドを使用してください。ファイルアップロードのテストの詳細は、ファイルアップロードに関するHTTPテストドキュメントの情報を参照してください。
Warning!!
image
メソッドには、GD拡張が必要です。
時間操作
テスト時、now
やIlluminate\Support\Carbon::now()
のようなヘルパが返す時間を変更したいことはよくあります。幸いなことに、Laravelのベース機能テストクラスは現在時間を操作するヘルパを用意しています。
use Illuminate\Support\Carbon;
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->freezeTime(function (Carbon $time) {
// ...
});
// 過去へ移行する
$this->travel(-5)->hours();
// 特定の時間へ移行する
$this->travelTo(now()->subHours(6));
// 現在時刻へ戻る
$this->travelBack();
}