Send Emails Using Gmail SMTP in Laravel

Sending emails is an essential feature in most web applications. Whether it is user registration, password reset, notifications, or order confirmations, email functionality plays a critical role. Laravel provides a powerful and simple mailing system that allows developers to send emails using different mail drivers.

One of the most common ways to send emails in Laravel is by using Gmail SMTP. Gmail’s SMTP server is reliable, secure, and easy to configure. By integrating Gmail SMTP with your Laravel application, you can quickly enable email functionality without setting up a complex mail server.

In this article, we will explain how to configure Gmail SMTP in Laravel step-by-step and send emails from your application.

Understanding Gmail SMTP in Laravel

Laravel includes a built-in mail system that supports multiple mail drivers such as SMTP, Mailgun, Sendmail, and others. SMTP is the most commonly used method because it allows applications to send emails through a mail server.

When using Gmail SMTP, Laravel connects to Google's mail servers to deliver emails. This means your Laravel application acts as a client that sends email requests through Gmail’s secure SMTP service.

Using Gmail SMTP is especially helpful for small to medium applications because it is easy to configure and does not require a dedicated email server.

Another advantage of Gmail SMTP is its security features. Gmail supports encryption, authentication, and app-specific passwords, which protect your account and ensure safe communication between your Laravel application and the email server.

Once configured properly, Laravel can send emails directly from controllers, notifications, or queues.

Step 1: Obtain Gmail SMTP Credentials

The first step is to create or use an existing Gmail account. If the email system is for a production application, it is recommended to create a separate Gmail account dedicated to your application.

After creating the account, you need to generate an app password instead of using your normal Gmail password. Google recommends this method for security reasons.

Follow these steps to generate an app password:

1. Go to your Google Account Settings.
2. Open the Security section.
3. Enable 2-Step Verification if it is not already enabled.
4. After enabling it, locate the App Passwords option.
5. Select the app and device, then generate a password.

Google will generate a 16-character password. This password will be used in your Laravel application instead of your Gmail password.

This method improves security and prevents exposing your real Gmail password in configuration files.

Step 2: Configure Laravel Environment (.env File)

The next step is to configure your Laravel environment file. Laravel stores most configuration settings inside the .env file, including database credentials and email settings.

Open the .env file in your Laravel project and update the mail configuration with Gmail SMTP credentials.

Example configuration:

MAIL_MAILER=smtp

MAIL_HOST=smtp.gmail.com

MAIL_PORT=587

MAIL_USERNAME=your_gmail@gmail.com

MAIL_PASSWORD=your_app_password

MAIL_ENCRYPTION=tls

MAIL_FROM_ADDRESS=your_gmail@gmail.com

MAIL_FROM_NAME="${APP_NAME}"

Make sure to replace the following values:

MAIL_USERNAME → Your Gmail address

MAIL_PASSWORD → The generated app password

This configuration tells Laravel to send emails through Gmail’s SMTP server using secure TLS encryption.

Step 3: Update config/mail.php

Laravel automatically loads mail configuration values from the .env file. However, it is good practice to verify that the config/mail.php file is correctly referencing these values.

Open the file:

config/mail.php

Ensure the SMTP configuration uses the env() function like this:

'smtp' => [

    'transport' => 'smtp',

    'host' => env('MAIL_HOST', 'smtp.gmail.com'),

    'port' => env('MAIL_PORT', 587),

    'encryption' => env('MAIL_ENCRYPTION', 'tls'),

    'username' => env('MAIL_USERNAME'),

    'password' => env('MAIL_PASSWORD'),

],

This setup ensures Laravel always reads email settings from the .env file.

If you update configuration values, remember to clear the config cache using:

php artisan config:clear

This ensures the new settings are applied.

Step 4: Sending Email in a Laravel Controller

Once Gmail SMTP is configured, you can start sending emails directly from your Laravel application.

Laravel provides the Mail facade to send emails easily.

Example controller code:

Use Mail.

public function sendMail()

{

    $to_email = "example@gmail.com";

    Mail::raw("This is a test email from Laravel using Gmail SMTP.", function ($message) use ($to_email) {

        $message->to($to_email)

                ->subject("Laravel Gmail SMTP Test Email");

    });

    return "Email sent successfully."

}

In this example:

$to_email contains the email address where the message will be sent.

Mail::raw() sends a simple text email.

The subject() method defines the email subject.

When the function is executed, Laravel will send the email through Gmail’s SMTP server.

You can also create custom email templates using Laravel Mailables, which is the recommended approach for real applications.

Common Issues and Tips

While configuring Gmail SMTP in Laravel, developers sometimes face common issues.

1. Authentication Failed Error

This usually happens when the Gmail password is used instead of an app password. Always use the generated app password.

2. Port or Encryption Issues

Make sure you are using:

Port 587 with TLS, or

Port 465 with SSL.

3. Configuration Not Updating

If Laravel still uses old settings, run:

php artisan config:clear

php artisan cache:clear

This refreshes the configuration.

Conclusion

Integrating Gmail SMTP with Laravel is a simple and effective way to enable email functionality in your application. Laravel’s powerful mailing system makes it easy to configure SMTP settings and send emails with minimal effort.

By generating a Gmail app password and properly updating the .env configuration file, you can securely connect your Laravel application to Gmail’s mail servers. This approach ensures both security and reliability.

Additionally, Laravel provides flexible email features such as mailables, queues, and notifications, which allow developers to build advanced email systems for modern applications.

With the correct setup, your Laravel application will be able to send registration emails, password reset links, notifications, and other automated messages seamlessly using Gmail SMTP.