How to send HTML email using PHP

Last updated on November 7th, 2024 at 01:20 pm

A Beginner’s Guide to Sending HTML Emails with PHP: Tips and Best Practices. This PHP script is used to send an HTML email with custom headers and content. It sends an email to a recipient with the specified subject, message, and headers using the mail() function.

Here is the code,

$to = "[email protected]";
$subject = "My HTML email test.";
$headers = "From: [email protected];\r\n";
$headers .= "Reply-To: [email protected];\r\n";
$headers .= "Return-Path: [email protected];\r\n";
$headers .= "MIME-Version: 1.0;\r\n";
$headers .= "Content-Type: text/html; charset=ISO-8859-1\r\n";
$message .= "<h1> This is a test </h1>";
$message .= "";
 
if ( mail($to,$subject,$message,$headers) ) {
echo "The email has been sent!";
} else {
echo "The email has failed!";
}

Let’s break down the code step by step:

Step-by-Step Explanation:

1. Setting Up the Email Variables:

$to = "[email protected]";
$subject = "My HTML email test.";

• $to: This is the recipient’s email address where the email will be sent. In this case, it’s [email protected].
• $subject: This is the subject of the email. In this case, the subject is "My HTML email test.".

2. Setting Up the Email Headers:

$headers = "From: [email protected];\r\n";
$headers .= "Reply-To: [email protected];\r\n";
$headers .= "Return-Path: [email protected];\r\n";
$headers .= "MIME-Version: 1.0;\r\n";
$headers .= "Content-Type: text/html; charset=ISO-8859-1\r\n";

Here, we are setting up the headers that will be sent along with the email. The headers variable is a string that includes several components, concatenated using .=, which appends the new header lines to the existing string.

• From: [email protected];: Specifies the “From” email address. This is the email address that will appear in the “From” field of the recipient’s inbox.
• Reply-To: [email protected];: Specifies the email address where replies to this email should be sent. When the recipient replies to the email, the response will be directed to this email address instead of the one in the “From” field.
• Return-Path: [email protected];: Specifies the return path for bounced emails. If the email cannot be delivered, the bounce-back message will be sent to this address.
• MIME-Version: 1.0;: This header specifies that the message complies with MIME (Multipurpose Internet Mail Extensions) version 1.0. MIME is used for sending emails that may include text, images, files, and HTML content.
• Content-Type: text/html; charset=ISO-8859-1: This header indicates that the email body will contain HTML content (instead of plain text) and specifies the character encoding for the content (ISO-8859-1 is a commonly used character set).

3. Creating the Message Body:

$message .= "<h1> This is a test </h1>";
$message .= "";

• $message: This is the content of the email. The first line ($message .= "<h1> This is a test </h1>";) adds an HTML <h1> heading to the email body. The second line ($message .= "";) appears to be an empty line and doesn’t affect the content.
• Since the Content-Type header is set to text/html, the email body will be interpreted as HTML, and the <h1> tag will display as a large heading in the recipient’s email client.

4. Sending the Email:

if ( mail($to, $subject, $message, $headers) ) {
    echo "The email has been sent!";
} else {
    echo "The email has failed!";
}

• mail() Function: This function is used to send the email. It takes four parameters:
  • $to: The recipient’s email address.
  • $subject: The subject of the email.
  • $message: The body of the email (the HTML message in this case).
  • $headers: The headers that specify additional email details such as the sender’s address, MIME version, and content type.
• if ( mail(...) ): This checks whether the email was successfully sent. The mail() function returns true if the email was successfully sent, and false if it failed.
  • If the email is sent successfully, it will print "The email has been sent!".
  • If the email fails to send, it will print "The email has failed!".

Summary of Key Points:

• Sending HTML Emails: This script sends an HTML email (not plain text), which is indicated by the Content-Type: text/html header.
• Custom Headers: The script includes custom email headers such as From, Reply-To, and Return-Path to control how the email is sent and how replies or bounce-backs are handled.
• mail() Function: The mail() function is used to send the email, and the success or failure of sending is checked using an if statement.

Potential Issues and Notes:

• Email Delivery: PHP’s mail() function relies on the server’s mail configuration. If the server is not configured to send emails (e.g., missing SMTP configuration), the email may fail to send, even if the script itself is correct.
• HTML Email Rendering: Not all email clients render HTML emails the same way, so it’s essential to test the email across different email clients to ensure proper display.
• Security: The mail() function does not automatically sanitize email addresses, subject, or message content, which could make the script vulnerable to email injection attacks. It’s crucial to validate and sanitize user input to prevent abuse of the mail() function.
• MIME stands for Multipurpose Internet Mail Extensions. It is a set of instructions that allows emails to be sent in more than just plain text.
• Content-Type sets what type of data is goign to be sent. The default value would be “text/plain”.
• Charset is character set. Each language or set of characters has its own title or name. This value lets the recipient email know which one is used to display the body message.

Enhancements:

Using Libraries for Sending Emails: For more complex email functionality (e.g., adding attachments, better error handling, or using an SMTP server), you might want to use a library like PHPMailer or SwiftMailer.