Send Email With Attachments In PHP (Simple Examples)

Welcome to a tutorial on how to send email attachments in PHP. Looking to send an email with a file attachment in PHP? Well, the native PHP mail function is not the friendliest out of the box.

That covers the basics, but read on if you need more examples!

 

 

TLDR – QUICK SLIDES

Fullscreen Mode – Click Here

 

TABLE OF CONTENTS

 

 

 

PART 1) ATTACH A SINGLE FILE

<?php
// (A) EMAIL SETTINGS
$mailTo = "jon@doe.com";
$mailSubject = "Test Attachment";
$mailMessage = "<strong>Test Message</strong>";
$mailAttach = "attach-a.png";

// (B) GENERATE RANDOM BOUNDARY TO SEPARATE MESSAGE & ATTACHMENTS
// https://www.w3.org/Protocols/rfc1341/7_2_Multipart.html
$mailBoundary = md5(time());
$mailHead = implode("\r\n", [
  "MIME-Version: 1.0",
  "Content-Type: multipart/mixed; boundary=\"$mailBoundary\""
]);

// (C) DEFINE THE EMAIL MESSAGE
$mailBody = implode("\r\n", [
  "--$mailBoundary",
  "Content-type: text/html; charset=utf-8",
  "",
  $mailMessage
]);

// (D) MANUALLY ENCODE & ATTACH THE FILE
$mailBody .= implode("\r\n", [
  "",
  "--$mailBoundary",
  "Content-Type: application/octet-stream; name=\"". basename($mailAttach) . "\"",
  "Content-Transfer-Encoding: base64",
  "Content-Disposition: attachment",
  "",
  chunk_split(base64_encode(file_get_contents($mailAttach))),
  "--$mailBoundary--"
]);

// (E) SEND
echo mail($mailTo, $mailSubject, $mailBody, $mailHead)
  ? "OK" : "ERROR" ;

Look no further, this is pretty much just a “polished version” of the introduction snippet. We are just using implode("\r\n") to quickly build the email header/body here, instead of manually typing out "\r\n" a dozen times.

 

 

EXTRA) MANUAL FORMATTING

For you guys who want more technical information – We are formatting the email according to RFC1341 multipart.

• As in the introduction, we have to define a BOUNDARY string and set it in the email header Content-Type: multipart/mixed; boundary="BOUNDARY".
• For each section of the email body:
  • Start with --BOUNDARY.
  • Followed by the Content-type headings.
  • An empty line break, then the content itself.
• Lastly, the email must be closed with --BOUNDARY--.

That’s all. So if you want to add more attachments, it is only a manner of adding more --BOUNDARY segments.

 

PART 2) ATTACH MULTIPLE FILES

<?php
// (A) EMAIL SETTINGS
$mailTo = "jon@doe.com";
$mailSubject = "Test Attachment";
$mailMessage = "<strong>Test Message</strong>";
$mailAttach = ["attach-a.png", "attach-b.png"];

// (B) GENERATE RANDOM BOUNDARY TO SEPARATE MESSAGE & ATTACHMENTS
// https://www.w3.org/Protocols/rfc1341/7_2_Multipart.html
$mailBoundary = md5(time());
$mailHead = implode("\r\n", [
  "MIME-Version: 1.0",
  "Content-Type: multipart/mixed; boundary=\"$mailBoundary\""
]);

// (C) DEFINE THE EMAIL MESSAGE
$mailBody = implode("\r\n", [
  "--$mailBoundary",
  "Content-type: text/html; charset=utf-8",
  "",
  $mailMessage
]);

// (D) MANUALLY ENCODE & ATTACH THE FILES
foreach ($mailAttach as $attach) {
  $mailBody .= implode("\r\n", [
    "",
    "--$mailBoundary",
    "Content-Type: application/octet-stream; name=\"". basename($attach) . "\"",
    "Content-Transfer-Encoding: base64",
    "Content-Disposition: attachment",
    "",
    chunk_split(base64_encode(file_get_contents($attach))),
    "--$mailBoundary"
  ]);
}
$mailBody .= "--";

// (E) SEND
echo mail($mailTo, $mailSubject, $mailBody, $mailHead)
  ? "OK" : "ERROR" ;

Want to attach many files? Yes, it’s as simple as that – Loop through all the files, add as many --BOUNDARY sections as required.

 

 

PART 3) PHPMAILER LIBRARY

<?php
// (A) LOAD PHPMAILER
// https://github.com/PHPMailer/PHPMailer
// composer require phpmailer/phpmailer
require "vendor/autoload.php";
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;
$mail = new PHPMailer(true);

// (B) SET EMAIL
$mail->From = "you@site.com";
$mail->addAddress("jon@doe.com");
$mail->isHTML(true);
$mail->Subject = "Test Attachment";
$mail->Body = "<strong>Test Message</strong>";
$mail->addAttachment("attach-a.png");
$mail->addAttachment("attach-b.png");

// (C) SEND MAIL
try {
  $mail->send();
  echo "OK";
} catch (Exception $ex) { echo $mail->ErrorInfo; }

Lastly, if the manual formatting is too much of a hassle, try out the PHPMailer library. This is a popular alternative, and it should not be difficult to see why… The above example should be self-explanatory.

 

 

 

SUPPORT

600+ free tutorials & projects on Code Boxx and still growing. I insist on not turning Code Boxx into a "paid scripts and courses" business, so every little bit of support helps.

Buy Me A Meal Code Boxx eBooks

 

EXAMPLE CODE DOWNLOAD

Click here for the source code on GitHub gist, just click on “download zip” or do a git clone. I have released it under the MIT license, so feel free to build on top of it or use it in your own project.

 

 

LINKS & REFERENCES

• Mail – PHP
• Send Email with Attachment in PHP – Codex World
• PHP: Sending Email (Text/HTML/Attachments) – WebCheatSheet
• Mail Not Sending Not Working – Code Boxx

 

INFOGRAPHIC CHEAT SHEET