Mailable classes in Laravel - Step-by-Step Execution

Concept Flow - Mailable classes

Create Mailable Class

↓

Define Email Content & Data

↓

Call Mail::to()->send()

↓

Build Email with Mailable

↓

Send Email via Mailer

↓

Email Sent

This flow shows how Laravel creates a Mailable class, sets its content, and sends the email.

Execution Sample

Laravel

use App\Mail\WelcomeMail;
use Illuminate\Support\Facades\Mail;

Mail::to('[e-mail]')->send(new WelcomeMail($user));

This code sends a welcome email to a user using a Mailable class.

Execution Table

Step	Action	Input/State	Output/Result
1	Instantiate WelcomeMail	$user data passed	WelcomeMail object created with user data
2	Call Mail::to('[e-mail]')	Recipient email set	Mailer prepared for recipient
3	Call send() with WelcomeMail	Mailer and Mailable ready	Build email content from Mailable
4	Build email content	Mailable's build() method runs	Email subject, view, and data set
5	Send email	Email content ready	Email sent to [e-mail]
6	Finish	Email sent	Process ends

💡 Email is sent successfully, process ends.

Variable Tracker

Variable	Start	After Step 1	After Step 3	After Step 4	Final
$user	User data object	Passed into WelcomeMail	Used in build()	Used in email view	No change
$mailable	None	WelcomeMail instance created	Passed to send()	Build method sets content	Ready to send
$mailer	None	None	Mailer prepared with recipient	Mailer builds email	Email sent

Key Moments - 3 Insights

Why do we create a new Mailable class instance before sending?

Because the Mailable class holds the email content and data. Step 1 shows creating the instance with user data, which is then used to build the email.

What does Mail::to()->send() do exactly?

It sets the recipient (Step 2) and then sends the email by building the content from the Mailable (Steps 3-5). This is the main sending action.

Where is the email content defined?

Inside the Mailable's build() method (Step 4), which sets the subject, view template, and data for the email.

Visual Quiz - 3 Questions

Look at the execution table, what is the output after Step 1?

A Mailer prepared for recipient

B Email sent to [e-mail]

C WelcomeMail object created with user data

D Email subject set

💡 Hint

Check the Output/Result column for Step 1 in the execution table.

At which step is the recipient email set?

A Step 1

B Step 2

C Step 4

D Step 5

💡 Hint

Look at the Action and Input/State columns for when Mail::to() is called.

If the build() method is missing in the Mailable, what happens at Step 4?

A Email content is empty or default

B Email is sent normally

C Mailer throws an error at Step 2

D Recipient email is not set

💡 Hint

Step 4 is where build() runs to set content; missing it means no content is set.

Concept Snapshot

Mailable classes in Laravel:
- Create a Mailable class to define email content.
- Instantiate it with data.
- Use Mail::to()->send(new Mailable) to send.
- build() method sets subject, view, and data.
- Mailer sends the built email to recipient.

Full Transcript

In Laravel, Mailable classes help send emails easily. First, you create a Mailable class that defines the email's content and data. Then, you make an instance of this class, passing any needed data like user info. Next, you call Mail::to() with the recipient's email and then send() with the Mailable instance. Laravel runs the build() method inside the Mailable to set the email subject, view template, and data. Finally, the mailer sends the email to the recipient. This process ensures emails are organized and reusable.

Practice

1. What is the main purpose of a Mailable class in Laravel?

easy

A. To organize email content and settings in one place

B. To handle database migrations

C. To manage user authentication

D. To define API routes

Solution

1. Step 1: Understand the role of Mailable classes

   Mailable classes are designed to organize email content and settings such as subject, recipients, and views.

2. Step 2: Compare with other Laravel features

   Database migrations, authentication, and routing are handled by other parts of Laravel, not Mailable classes.

3. Final Answer:

   To organize email content and settings in one place -> Option A

4. Quick Check:

   Mailable class purpose = Organize email content [OK]

Hint: Mailable classes bundle email setup and content [OK]

Common Mistakes:

• Confusing Mailable with database or routing features
• Thinking Mailable handles user login
• Assuming Mailable manages API endpoints

2. Which method must you define inside a Laravel Mailable class to set the email's view and subject?

easy

A. send()

B. compose()

C. build()

D. render()

Solution

1. Step 1: Recall Mailable class structure

   The build() method is where you define the email's view and subject in Laravel Mailable classes.

2. Step 2: Eliminate incorrect methods

   Methods like send(), compose(), and render() are not used in Laravel Mailable classes for this purpose.

3. Final Answer:

   build() -> Option C

4. Quick Check:

   Set email view and subject = build() method [OK]

Hint: Use build() to configure email content and subject [OK]

Common Mistakes:

• Using send() instead of build()
• Confusing build() with render()
• Trying to use compose() which is not a Laravel Mailable method

3. Given this Mailable class snippet, what will be the subject of the sent email?

class OrderShipped extends Mailable {
  public function build() {
    return $this->subject('Your order has shipped')->view('emails.shipped');
  }
}

medium

A. Your order has shipped

B. emails.shipped

C. OrderShipped

D. No subject set

Solution

1. Step 1: Analyze the build() method

   The build() method sets the subject using subject('Your order has shipped').

2. Step 2: Understand what the subject() method does

   This method sets the email's subject line to the given string.

3. Final Answer:

   Your order has shipped -> Option A

4. Quick Check:

   Email subject = 'Your order has shipped' [OK]

Hint: Subject is set by subject() inside build() [OK]

Common Mistakes:

• Confusing view name with subject
• Assuming class name is subject
• Thinking no subject is set without explicit call

4. Identify the error in this Mailable class code:

class WelcomeUser extends Mailable {
  public $user;

  public function __construct($user) {
    $this->user = $user;
  }

  public function build() {
    return $this->view('emails.welcome')->with('user');
  }
}

medium

A. Wrong method name instead of build()

B. Incorrect property declaration

C. Missing return statement in constructor

D. Missing argument in with() method

Solution

1. Step 1: Check the with() method usage

   The with() method requires a key-value pair or an array to pass data to the view, but here it only has a key string without a value.

2. Step 2: Verify other parts of the class

   Property declaration and constructor are correct, and the method name build() is correct.

3. Final Answer:

   Missing argument in with() method -> Option D

4. Quick Check:

   with() needs key and value [OK]

Hint: with() needs key and value to pass data [OK]

Common Mistakes:

• Passing only key without value to with()
• Forgetting to return in build()
• Misnaming build() method

5. You want to send an email with a Mailable class that passes a user's name and order ID to the view. Which is the correct way to pass this data inside the build() method?

hard

A. return $this->view('emails.order')->with('name', $this->name, 'orderId', $this->orderId);

B. return $this->view('emails.order')->with(['name' => $this->name, 'orderId' => $this->orderId]);

C. return $this->view('emails.order')->with('name', $this->name)->with('orderId');

D. return $this->view('emails.order')->with(['name', $this->name, 'orderId', $this->orderId]);

Solution

1. Step 1: Understand how to pass multiple data items

   The with() method accepts an associative array to pass multiple variables to the view.

2. Step 2: Analyze each option's syntax

   return $this->view('emails.order')->with(['name' => $this->name, 'orderId' => $this->orderId]); correctly uses an array with keys and values. return $this->view('emails.order')->with('name', $this->name)->with('orderId'); misses value for 'orderId'. return $this->view('emails.order')->with('name', $this->name, 'orderId', $this->orderId); passes too many arguments. return $this->view('emails.order')->with(['name', $this->name, 'orderId', $this->orderId]); uses a numeric array instead of associative.

3. Final Answer:

   return $this->view('emails.order')->with(['name' => $this->name, 'orderId' => $this->orderId]); -> Option B

4. Quick Check:

   Pass multiple data as associative array in with() [OK]

Hint: Use associative array in with() for multiple data [OK]

Common Mistakes:

• Passing multiple arguments instead of one array
• Omitting values for keys in with()
• Using numeric array instead of associative