How to Sendmail in PHP? [Complete Guide]

 In All Tutorials
Last Updated On November 04, 2019

PHP comes with a default function mail() that allows you to sendmail directly from a PHP script. Here in this tutorial, we will be talking about the prerequisites to sending a mail directly from a PHP script, the syntax, and its parameters.

Prerequisites

  • PHP4, PHP 5 or PHP 7
  • PHP configured to sendmail. In case your PHP setup is not configured for sending email to the outside world, then please refer the steps mentioned at the end of this article.

Syntax

mail (to,subject,message,headers,parameters);

 

Parameters

to
String | Required
The email address of the recipient.
Note: The must comply with RFC 2822. You can pass one email address or multiple using comma-separated.
Few sample examples of how the values will look like:

  • user1@example.com
  • user2@example.com, user3@example.com
  • Receiver Name <user1@gmail.com>
  • Receiver Name <user1@gmail.com>, Receiver Name 2 <user2@gmail.com>

 


subject
String | Required
The subject line of the email to be sent.
Note, the subject must comply with RFC 2047.

 


message
String | Required
The content of the mail that you want to send. Each line of the email should be separated with a CRLF (\r\n) and each line should not exceed 70 characters.
In case of Windows machine, when PHP is connecting to an SMTP server to sendmail, it removes a full stop which is found at the start of a line. To resolve this, replace the dot with a double dot, using the below code:

<?php $text = str_replace("\n.", "\n..", $text); ?>

 


additional_headers
mixed (String or Array) | Optional
This parameter is used to pass any additional email headers like From, Cc and Bcc. Each additional headers should be separated with a CRLF (\r\n).
Note: While sending the email, make sure there is a From header. You can set the From header, either by using the additional_headers parameter or, you can also set a default value in php.ini.

 


additional_parameters
String | Optional
This additional_parameter can be used to pass additional flags to the Sendmail program as configured in the sendmail_path configuration setting. For example; you can use this parameter to set the envelope sender address when using Sendmail with -f option. PHP by default internally escape the values coming in this parameter with escapeshellcmd() to prevent any potential command execution.

 

Return Value

mail() function returns TRUE if the SMTP server successfully accepted the mail for delivery, else FALSE.

Getting TRUE doesn't necessarily mean that the email is delivered to the recipient's server. TRUE is just an indication that your mail has successfully submitted to the SMTP server's queue for sending.
Returns TRUE if the mail was successfully accepted for delivery, FALSE otherwise.
It is important to note that just because the mail was accepted for delivery, it does NOT mean the mail will reach the intended destination.

 

Note: mail() function will not work in Local server. A server connected to the internet and SMTP ports opened will be required to send mail.

Few Use Cases and Working Examples

  1. How to send an HTML mail
<?php
$to = "user1@example.com, user2@example.com";
$subject = "This is a test HTML email";

$message = "
<html>
<head>
<title>This is a test HTML email</title>
</head>
<body>
<p>Test email. Please ignore.</p>
</body>
</html>
";

// It is mandatory to set the content-type when sending HTML email
$headers = "MIME-Version: 1.0" . "\r\n";
$headers .= "Content-type:text/html;charset=UTF-8" . "\r\n";

// More headers. From is required, rest other headers are optional
$headers .= 'From: <info@example.com>' . "\r\n";
$headers .= 'Cc: sales@example.com' . "\r\n";

mail($to,$subject,$message,$headers);
?>

 

  1. How to sendmail with an additional command line parameter.
    As described above, for this use case, you need to use the additional_parameters parameter to pass an additional parameter to the program configured to used when sending mail using the sendmail_path.
<?php
mail('user1@example.com', 'This is a test subject line', 'The complete body of the message', null, '-fsender@example.com'); ?>

Common Errors/Exceptions with PHP sendmail function

  1. Unable to send a large volume of emails using mail() function
    Using a mail() function is not recommended for sending large volume emails, because it opens and closes an SMTP socket connection for each email. This is really not very efficient.
    If you want to send a large amount of emails in PHP, then it is recommended to refer PEAR::Mail, and PEAR::Mail_Queue packages or use some good Email Service Provider which can help you scale your email volume.
  2. Not receiving emails sent through PHP mail() function
    While there can be N number of reason for the failure, but one the wried problem which many encounters is with the Unix mail transfer agents, which replace LF by CRLF automatically, which leads to doubling CR if CRLF is already used in your code. In such a case, try using an LF (\n) only. Read more about message format on RFC 2822.
  3. Warning: mail(): "sendmail_from" not set in php.ini or custom "From:" header missing.
    This error occurs mostly because while sending mail, you have not mentioned the From header using the additional_headers parameters.

Configuring PHP for sending mail

In order to configure anything related to PHP you need to change `php.ini` file. So, we will be editing php.ini file in order to configure Sendmail.

You can easily locate or search your php.ini file in Linux using below command:


locate php.ini

 

The default location is `/etc/php.ini` 

You can find the same in windows where XAMPP or LAMPP is installed:

`C:\xampp\php\php.ini`

Clarification:

  • Xampp (X (for "some OS"), Apache, MySQL, Perl, PHP)
  • Lampp (Linux, Apache, MySQL, Perl, PHP)

Changing  php.ini file to add mail configuration.

  1. Open your php.ini file using below:

    For Linux/Mac OS:

    vim /etc/php.in


    For Windows:
    using notepad

     

  2. Search [mail function] in the file. It will be as shown below:
    [mail function]
    ; For Win32 only.
    ; http://php.net/smtp
    SMTP = localhost
    ; http://php.net/smtp-port
    smtp_port = 25
    ; For Win32 only.
    ; http://php.net/sendmail-from
    ;sendmail_from = me@example.com
    ; For Unix only.  You may supply arguments as well (default: "sendmail -t -i").
    ; http://php.net/sendmail-path
    sendmail_path = /usr/sbin/sendmail -t -i
    ; Force the addition of the specified parameters to be passed as extra parameters
    ; to the sendmail binary. These parameters will always replace the value of
    ; the 5th parameter to mail(), even in safe mode.
    ;mail.force_extra_parameters =
    ; Add X-PHP-Originating-Script: that will include uid of the script followed by the filename
    mail.add_x_header = On
    ; The path to a log file that will log all mail() calls. Log entries include
    ; the full path of the script, line number, To address and headers.
    ;mail.log =
    
  3. Add your mail server details to the file or incase you have one you can change it (mail server can be your own ie. local mail server or you can use any ESP as a mail server).
    For Linux/Mac OS:
    - Check for `sendmail_path` and ensure; is not (semicolon is used to show the line is commented).
    - By default it will use `/usr/bin/sendmail -t -i` you can change it if you are using any custom path.
    For Window:
    - Check for `SMTP = localhost` and change it to your desired mail server (any ESP or localhost) no changes are required if you are using your own local server.
    - Or you can also use the smtp server of any Email Service Provider like Pepipost, Sendgrid, Mailgun, Sparkpost.
  4. Save/close the php.ini file
  5. The final step, don’t forget to restart your webserver/php-fpm.

Pro tip: You can host a simple “info.php” on your webserver to check each and every configuration of your PHP using below 2 liner code:

vim php_info.php
<?php
phpinfo();
?>

Save and exit the file.
4. Reload you webserver and php-fpm.
5. Hit http://localhost/php_info.php on your web browser.

Conclusion

Hope, this tutorial is able to help you send mail using PHP.

In case you are facing some issues which are not listed above in the tutorial, or you have some suggestions, then please feel free to contribute below in comments.

Recent Posts
Comments
  • mm
    Reply

    how about configuring php to sned mail in windows server 2016 using IIS

Leave a Comment

We are always looking for fresh talent to contribute to our blog. If you have a knack for writing and a passion for email marketing, we would love to have your post on our Guest Blog .

Submit a Guest Post
Pepi thinking

Start typing and press Enter to search

Thank you for your details!

Fill out your information below, and we will send you a PepiAlert, that will describe your domain’s email deliverability situation. Please note that your email address must match the domain, or the domain must be owned by the company matching the email address. We have the right to refuse the request, if we can’t verify the information.

*All fields are required