Test sending email

app/Http/Controllers/OrderShipmentController.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Mail\OrderShipped;
+use App\Models\Order;
+use Illuminate\Support\Facades\Mail;
+
+class OrderShipmentController extends Controller
+{
+    public function shipOrderBasic(Order $order)
+    {
+        $order->status = 'shipped';
+        $order->save();
+
+        Mail::to(auth()->user())->send(new OrderShipped($order));
+
+        return ['message' => 'Your order has been shipped.'];
+    }
+}

database/migrations/2023_01_06_152053_create_orders_table.php

@@ -19,6 +19,8 @@ public function up()
             $table->unsignedBigInteger('shipper_id');
             $table->string('name');
             $table->unsignedDecimal('price');
+            $table->enum('status', ['pending', 'processing', 'shipped', 'cancelled', 'completed'])
+                ->default('pending');
             $table->timestamps();
         });
     }

routes/web.php

@@ -2,6 +2,7 @@
 
 use App\Http\Controllers\HomeController;
 use App\Http\Controllers\MediaUploaderController;
+use App\Http\Controllers\OrderShipmentController;
 use App\Http\Controllers\PostController;
 use App\Http\Controllers\PostPublishController;
 use Illuminate\Support\Facades\Route;
@@ -61,5 +62,8 @@
     Route::prefix('mailable')->group(function() {
         Route::get('template/{id}', [PostPublishController::class, 'previewMailTemplate'])
             ->name('mailable.preview');
+
+        Route::post('orders/{order}/shipped/basic', [OrderShipmentController::class, 'shipOrderBasic'])
+            ->name('order.shipped.basic');
     });
 });

tests/Feature/MailTest.php

@@ -11,6 +11,7 @@
 use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Foundation\Testing\WithFaker;
 use Illuminate\Mail\Mailables\Attachment;
+use Illuminate\Support\Facades\Mail;
 use Tests\TestCase;
 
 class MailTest extends TestCase
@@ -136,4 +137,21 @@ public function mailable_can_have_attachments_at_runtime()
 
         $mailable->assertHasAttachmentFromStorageDisk('public', 'your-order.pdf');
     }
+
+    /** @test */
+    public function email_api_can_be_instructed_to_send_a_mailable()
+    {
+        $this->actingAs($user = User::factory()->create());
+
+        Mail::fake();
+
+        Mail::assertNotSent(OrderShipped::class);
+
+        $this->post(route(
+            'order.shipped.basic',
+            Order::factory()->create(['user_id' => $user->id])
+        ));
+
+        Mail::assertSent(OrderShipped::class);
+    }
 }