Section 1.1: User Registration Scenario

Consider a Laravel application with a registration endpoint located at /register. Once a user successfully registers, they receive a welcome email. Our goal is to rigorously test this feature.

Step 1: Setting Up the Registration Functionality

Before we can test, we need to implement the registration logic. In routes/web.php, we define the following route:

Route::post('/register', [RegistrationController::class, 'register']);

In app/Http/Controllers/RegistrationController.php, the method may look like this:

public function register(Request $request)

{

$validatedData = $request->validate([

'name' => 'required|string|max:255',

'email' => 'required|string|email|max:255|unique:users',

'password' => 'required|string|min:8|confirmed',

]);

$user = User::create([

'name' => $validatedData['name'],

'email' => $validatedData['email'],

'password' => Hash::make($validatedData['password']),

]);

Mail::to($user->email)->send(new WelcomeEmail($user));

return response()->json(['user' => $user], 201);

}

Step 2: Testing Registration and Email Dispatch

With the registration logic in place, we can now write our test in tests/Feature/UserRegistrationTest.php:

public function test_user_registration_sends_welcome_email()

{

Mail::fake();

$response = $this->post('/register', [

'name' => 'John Doe',

'email' => '[email protected]',

'password' => 'password',

'password_confirmation' => 'password',

]);

$response->assertStatus(201);

Mail::assertSent(WelcomeEmail::class, 1);

Mail::assertSent(WelcomeEmail::class, function ($mail) use ($response) {

return $mail->hasTo('[email protected]');

});

}

This test simulates the email sending process using Mail::fake(), confirming that the welcome email is sent correctly upon user registration.

The first video titled "Test-Driven Laravel" by Adam Wathan at Laracon US 2016 delves into TDD principles and their application in Laravel development, providing valuable insights into effective practices.

Section 1.2: Implementing a Newsletter Feature

In a Test-Driven Development (TDD) environment, we establish expected behaviors through tests before building the functionality. Let’s examine how to send newsletters to users.

Step 1: Writing the Newsletter Test

We begin by writing a test in tests/Feature/SendNewsletterTest.php:

public function test_newsletter_sending()

{

$userCount = User::factory()->count(5)->create();

$response = $this->post('/send-newsletter', [

'subject' => 'Our Latest News',

'content' => 'Here is the content of our latest newsletter.',

]);

$response->assertOk();

Mail::assertSent(NewsletterEmail::class, $userCount);

}

This test verifies that the newsletter is dispatched to the exact number of users created during setup, ensuring a dynamic and precise validation method.

Step 2: Developing the Newsletter Functionality

Once we outline our testing expectations, we proceed to implement the endpoint in routes/api.php:

Route::post('/send-newsletter', [NewsletterController::class, 'send']);

Then, we create the corresponding logic in app/Http/Controllers/NewsletterController.php:

public function send(Request $request)

{

$validated = $request->validate([

'subject' => 'required|string',

'content' => 'required|string',

]);

$users = User::all();

foreach ($users as $user) {

Mail::to($user->email)->send(new NewsletterEmail($validated['subject'], $validated['content']));

}

return response()->json(['message' => 'Newsletter sent successfully!']);

}

Finally, we define the NewsletterEmail Mailable in app/Mail/NewsletterEmail.php:

public function __construct($subject, $content)

{

$this->subject = $subject;

$this->content = $content;

}

public function build()

{

return $this->subject($this->subject)

->view('emails.newsletter', ['content' => $this->content]);

}

The second video titled "Laravel Testing 22/24: What is TDD? How it works: Simple Example" offers a simplified explanation of TDD and its practical implementation in Laravel, making it an essential resource for developers.