Admin

Software Developer

Add your Tutorial

21st June, 2026

186

PHP Send Email with SMTP PHPMailer Complete Tutorial

Introduction
A reliable email system is essential for any web application — whether it's sending welcome emails, password resets, order confirmations, or newsletters. The native PHP mail() function is basic and often unreliable. For professional email delivery with authentication, encryption, and better deliverability, PHPMailer with SMTP is the industry standard. This tutorial walks you through building a complete email system step by step.

Prerequisites

PHP 7.4+ installed
An email account (Gmail, Outlook, or any SMTP-enabled account)
Composer installed (or manual PHPMailer download)
Basic understanding of PHP

Step 1: Install PHPMailer

First, install PHPMailer in your project. Using Composer:

composer require phpmailer/phpmailer

Your project structure should look like this:

project/
├── vendor/              # Composer dependencies
├── composer.json
├── send-email.php       # Basic email script
└── email-service.php    # Advanced email class

Step 2: Basic Email Sending Script (send-email.php)

<?php

use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\SMTP;
use PHPMailer\PHPMailer\Exception;

require 'vendor/autoload.php';

function sendEmail($to_email, $to_name, $subject, $body, $is_html = false) {
    $mail = new PHPMailer(true);

    try {
        // Server settings
        $mail->isSMTP();
        $mail->Host       = 'smtp.gmail.com';
        $mail->SMTPAuth   = true;
        $mail->Username   = '[email protected]';
        $mail->Password   = 'your-app-password';
        $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
        $mail->Port       = 587;

        // Sender
        $mail->setFrom('[email protected]', 'Your Name');
        
        // Recipient
        $mail->addAddress($to_email, $to_name);

        // Content
        $mail->isHTML($is_html);
        $mail->Subject = $subject;
        $mail->Body    = $body;
        
        if ($is_html) {
            $mail->AltBody = strip_tags($body);
        }

        $mail->send();
        return ['success' => true, 'message' => 'Email sent successfully!'];
        
    } catch (Exception $e) {
        return ['success' => false, 'message' => "Email could not be sent. Error: {$mail->ErrorInfo}"];
    }
}

// Usage example
$result = sendEmail(
    '[email protected]',
    'John Doe',
    'Test Subject',
    '<h1>Hello</h1><p>This is a test email with <b>HTML</b> content.</p>',
    true
);

print_r($result);

?>

Important: Never use your regular Gmail password. You need an App Password (explained in the next step).

Step 3: Generate Gmail App Password

Gmail no longer accepts regular passwords for third-party apps. Follow these steps:

Go to your Google Account → Security
Enable 2-Step Verification if not already enabled
Find and click App Passwords
Select app: "Mail", device: "Other", name it "My PHP App"
Copy the 16-character generated password
Use this password in your script (without spaces)

Username: [email protected]
Password: xxxxxxxxxxxxxxxx (16 characters, no spaces)

Step 4: Different SMTP Providers Configuration

Here are configurations for popular email providers:

// Gmail Configuration
$gmail_config = [
    'host' => 'smtp.gmail.com',
    'port' => 587,
    'encryption' => 'tls'
];

// Outlook / Hotmail Configuration
$outlook_config = [
    'host' => 'smtp-mail.outlook.com',
    'port' => 587,
    'encryption' => 'tls'
];

// Yahoo Mail Configuration
$yahoo_config = [
    'host' => 'smtp.mail.yahoo.com',
    'port' => 587,
    'encryption' => 'tls'
];

// Custom cPanel Hosting Configuration
$cpanel_config = [
    'host' => 'mail.yourdomain.com',
    'port' => 465,
    'encryption' => 'ssl'
];

// SendGrid Configuration
$sendgrid_config = [
    'host' => 'smtp.sendgrid.net',
    'port' => 587,
    'encryption' => 'tls',
    'username' => 'apikey',
    'password' => 'your-sendgrid-api-key'
];

Step 5: Sending Email with Attachments

Here's how to attach files to your emails (email-with-attachment.php):

<?php

use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;

require 'vendor/autoload.php';

function sendEmailWithAttachment($to_email, $subject, $body, $attachment_path, $attachment_name = '') {
    $mail = new PHPMailer(true);

    try {
        // Server settings
        $mail->isSMTP();
        $mail->Host       = 'smtp.gmail.com';
        $mail->SMTPAuth   = true;
        $mail->Username   = '[email protected]';
        $mail->Password   = 'your-app-password';
        $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
        $mail->Port       = 587;

        $mail->setFrom('[email protected]', 'Your Company');
        $mail->addAddress($to_email);
        $mail->isHTML(true);
        $mail->Subject = $subject;
        $mail->Body    = $body;

        // Attach file with validation
        if (file_exists($attachment_path)) {
            $attachment_name = $attachment_name ?: basename($attachment_path);
            $mail->addAttachment($attachment_path, $attachment_name);
        } else {
            return ['success' => false, 'message' => 'Attachment file not found.'];
        }

        // Multiple attachments example:
        // $mail->addAttachment('path/to/file2.pdf', 'Document.pdf');
        // $mail->addAttachment('path/to/image.jpg', 'Photo.jpg');

        $mail->send();
        return ['success' => true, 'message' => 'Email with attachment sent!'];
        
    } catch (Exception $e) {
        return ['success' => false, 'message' => "Error: {$mail->ErrorInfo}"];
    }
}

// Usage
$result = sendEmailWithAttachment(
    '[email protected]',
    'Your Invoice #12345',
    '<h2>Invoice Attached</h2><p>Please find your invoice attached to this email.</p>',
    'uploads/invoices/invoice_12345.pdf',
    'Invoice_12345.pdf'
);

print_r($result);

?>

Step 6: Multiple Recipients with CC and BCC

Here's how to send emails to multiple people (email-multiple.php):

<?php

use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;

require 'vendor/autoload.php';

function sendEmailToMultiple($to_list, $subject, $body, $cc_list = [], $bcc_list = []) {
    $mail = new PHPMailer(true);

    try {
        $mail->isSMTP();
        $mail->Host       = 'smtp.gmail.com';
        $mail->SMTPAuth   = true;
        $mail->Username   = '[email protected]';
        $mail->Password   = 'your-app-password';
        $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
        $mail->Port       = 587;

        $mail->setFrom('[email protected]', 'Your Company');

        // Add primary recipients
        foreach ($to_list as $email => $name) {
            if (is_numeric($email)) {
                $mail->addAddress($name);
            } else {
                $mail->addAddress($email, $name);
            }
        }

        // Add CC recipients
        foreach ($cc_list as $email => $name) {
            if (is_numeric($email)) {
                $mail->addCC($name);
            } else {
                $mail->addCC($email, $name);
            }
        }

        // Add BCC recipients
        foreach ($bcc_list as $email => $name) {
            if (is_numeric($email)) {
                $mail->addBCC($name);
            } else {
                $mail->addBCC($email, $name);
            }
        }

        $mail->isHTML(true);
        $mail->Subject = $subject;
        $mail->Body    = $body;

        $mail->send();
        return ['success' => true, 'message' => 'Email sent to all recipients!'];
        
    } catch (Exception $e) {
        return ['success' => false, 'message' => "Error: {$mail->ErrorInfo}"];
    }
}

// Usage
$to_recipients = [
    '[email protected]' => 'John Doe',
    '[email protected]' => 'Jane Smith'
];

$cc_recipients = [
    '[email protected]' => 'Team Manager'
];

$bcc_recipients = ['[email protected]'];

$result = sendEmailToMultiple(
    $to_recipients,
    'Team Meeting Reminder',
    '<h2>Meeting Tomorrow</h2><p>Don\'t forget about the team meeting at 10 AM.</p>',
    $cc_recipients,
    $bcc_recipients
);

print_r($result);

?>

Key Difference between CC and BCC: CC recipients are visible to everyone who receives the email. BCC recipients receive the email but their addresses remain hidden. Always use BCC when sending to large mailing lists to protect privacy.

Step 7: Complete Reusable Email Class

Building a dedicated email service class makes your code organized and reusable (EmailService.php):

<?php

use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;

class EmailService {
    private $mail;
    private $config;

    public function __construct($config = []) {
        $this->mail = new PHPMailer(true);
        
        $this->config = array_merge([
            'host' => 'smtp.gmail.com',
            'port' => 587,
            'encryption' => 'tls',
            'username' => '[email protected]',
            'password' => 'your-app-password',
            'from_email' => '[email protected]',
            'from_name' => 'Your Company'
        ], $config);

        $this->setupSMTP();
    }

    private function setupSMTP() {
        $this->mail->isSMTP();
        $this->mail->Host       = $this->config['host'];
        $this->mail->SMTPAuth   = true;
        $this->mail->Username   = $this->config['username'];
        $this->mail->Password   = $this->config['password'];
        $this->mail->SMTPSecure = $this->config['encryption'];
        $this->mail->Port       = $this->config['port'];
        $this->mail->setFrom($this->config['from_email'], $this->config['from_name']);
    }

    public function sendWelcomeEmail($user_email, $user_name) {
        $subject = "Welcome to " . $this->config['from_name'] . "!";
        
        $body = "
        <!DOCTYPE html>
        <html>
        <head>
            <style>
                body { font-family: Arial, sans-serif; line-height: 1.6; }
                .container { max-width: 600px; margin: 0 auto; padding: 20px; }
                .header { background: #4CAF50; color: white; padding: 30px; text-align: center; border-radius: 5px 5px 0 0; }
                .content { padding: 30px; background: #ffffff; border: 1px solid #e0e0e0; }
                .button { 
                    display: inline-block; padding: 14px 28px; 
                    background: #4CAF50; color: white; text-decoration: none; 
                    border-radius: 5px; font-weight: bold; margin: 20px 0;
                }
                .footer { text-align: center; padding: 20px; color: #888; font-size: 12px; }
            </style>
        </head>
        <body>
            <div class='container'>
                <div class='header'>
                    <h1>Welcome, {$user_name}!</h1>
                </div>
                <div class='content'>
                    <p>Thank you for creating an account with us. We are excited to have you on board!</p>
                    <p>Here are a few things you can do to get started:</p>
                    <ul>
                        <li>Complete your profile information</li>
                        <li>Explore our features and services</li>
                        <li>Check out our getting started guide</li>
                    </ul>
                    <p style='text-align: center;'>
                        <a href='https://yourwebsite.com/getting-started' class='button'>Get Started Now</a>
                    </p>
                    <p>If you have any questions, simply reply to this email.</p>
                    <p>Best regards,<br>The " . $this->config['from_name'] . " Team</p>
                </div>
                <div class='footer'>
                    <p>&copy; " . date('Y') . " " . $this->config['from_name'] . ". All rights reserved.</p>
                </div>
            </div>
        </body>
        </html>";

        return $this->send($user_email, $user_name, $subject, $body);
    }

    public function sendPasswordReset($user_email, $reset_token) {
        $reset_link = "https://yourwebsite.com/reset-password?token=" . $reset_token;
        $subject = "Password Reset Request";
        
        $body = "
        <div style='max-width:600px;margin:0 auto;font-family:Arial,sans-serif;'>
            <div style='background:#2196F3;color:white;padding:30px;text-align:center;'>
                <h1>Password Reset</h1>
            </div>
            <div style='padding:30px;background:#fff;border:1px solid #e0e0e0;'>
                <p>We received a request to reset the password for your account.</p>
                <p>Click the button below to create a new password:</p>
                <p style='text-align:center;'>
                    <a href='{$reset_link}' 
                       style='display:inline-block;padding:14px 28px;background:#2196F3;color:white;text-decoration:none;border-radius:5px;font-weight:bold;'>
                       Reset Your Password
                    </a>
                </p>
                <p style='color:#ff6600;'><strong>This link will expire in 1 hour.</strong></p>
                <p>If you did not request a password reset, please ignore this email. Your account is safe.</p>
            </div>
        </div>";

        return $this->send($user_email, '', $subject, $body);
    }

    private function send($to_email, $to_name, $subject, $body) {
        try {
            $this->mail->clearAddresses();
            $this->mail->clearAttachments();
            $this->mail->addAddress($to_email, $to_name);
            $this->mail->isHTML(true);
            $this->mail->Subject = $subject;
            $this->mail->Body    = $body;
            $this->mail->AltBody = strip_tags(str_replace(['<br>', '</p>'], ["\n", "\n\n"], $body));

            $this->mail->send();
            return ['success' => true, 'message' => 'Email sent successfully'];
        } catch (Exception $e) {
            error_log("Email Error: " . $this->mail->ErrorInfo);
            return ['success' => false, 'message' => 'Failed to send email'];
        }
    }
}

// Usage example
$email_service = new EmailService([
    'username' => '[email protected]',
    'password' => 'your-app-password',
    'from_name' => 'Your Company Name'
]);

// Send welcome email to new user
$result = $email_service->sendWelcomeEmail('[email protected]', 'Sarah Johnson');
print_r($result);

// Send password reset email
$reset_token = bin2hex(random_bytes(32));
$result = $email_service->sendPasswordReset('[email protected]', $reset_token);
print_r($result);

?>

Conclusion
You now have a complete PHP email system using PHPMailer with SMTP that includes:

Basic email sending with Gmail SMTP
App Password configuration for security
Multiple email provider support
File attachment handling
CC and BCC functionality
A reusable EmailService class with HTML templates
Error handling and troubleshooting knowledge

This system can be extended with email queuing for large volumes, email tracking, scheduled emails, and integration with third-party services like SendGrid or Mailgun.

Popular Tools for Developers

Free Sample Files (Image,Video,Audio,Documents) For Testing CSS Minifier Js Minifier JSON Viewer and Formatter

Popular Tools for Project Manager

SSL Checker

Popular Tools for Youtubers

BIC Code(Swift Code) for Adsense Generate YouTube Subscribe Button

Other Tools for Daily Life

Google drive sharelink to download link.

Admin

Related Tutorial

PHP Session Management – Complete Guide.

PHP MySQLi vs PDO – Which Database Extension to Use?.

PHP REST API Tutorial: Build RESTful APIs from Scratch.

PHP File Upload Tutorial: Secure Upload System with Validation.

PHP Login and Registration System – Complete Tutorial.

PHP CRUD Operations with MySQL: Complete Step-by-Step Guide.

Mastering DataTables: Implementing Column Filtering and Server-Side Processing with PHP.

Download XAMPP with Multiple PHP Versions: Easy Installation Guide.

A Guide to Types of Arrays in PHP.

How to Use Session Variables in PHP.

Popular Tools for Developers

Popular Tools for Project Manager

Popular Tools for Youtubers

Other Tools for Daily Life

About us

Find Online Tools

Quick links

Social links

Other