Documentation

Send Mail with PHP

If you’re a PHP application developer, you might need to send email notifications through your custom PHP applications. With XAMPP, there are two ways to do this: you can use a simple SMTP client like msmtp, or you can use the third-party PHPMailer class. This guide walks you through both options.

This guide assumes that you have an existing Gmail account, and that you will use Gmail’s SMTP server to transmit email. You can also use your organization or ISP’s mail server, although you’ll need to replace key details, such as the SMTP server name and port, with appropriate values for your environment. Your network administrator or ISP support desk will typically be able to provide this information. The example code provided in this tutorial is illustrative only and should not be used in production environments.

To configure XAMPP to use msmtp for email notifications, follow these steps:

  1. Ensure that you are logged in as root. Install the msmtp package.

    apt-get install msmtp
  2. Create a new file at /etc/msmtprc and fill it with the following configuration directives:

    defaults
    tls on
    tls_starttls on
    tls_trust_file /etc/ssl/certs/ca-certificates.crt
    account default
    host smtp.gmail.com
    port 587
    auth on
    user [email protected]
    password your-gmail-password
    from [email protected]
    logfile /var/log/msmtp.log

    Remember to replace the dummy values shown with your actual Gmail address and account password.

  3. Restart the Apache server using the XAMPP control panel.

For more information on configuring msmtp to work with Gmail, refer to this source thread or the msmtp documentation.

You can now use PHP’s mail() function to send email from your application. To illustrate how it can be used with your Gmail account, use your text editor to create an example script named sendmail.php in the htdocs/ subdirectory and fill it with the following code. Once done, save your changes.

<?php
$to = '[email protected]';
$subject = 'Hello from XAMPP!';
$message = 'This is a test';
$headers = "From: [email protected]\r\n";
if (mail($to, $subject, $message, $headers)) {
   echo "SUCCESS";
} else {
   echo "ERROR";
}

Remember to replace the dummy values shown with valid email addresses. For this simple test, use your own email address as the recipient address.

Now, browse to the URL http://localhost/sendmail.php to execute the script and send the email message. If all goes well, you should see a success notification in your browser. If you used your own email address for the recipient address, you should also receive the email message.

image1

To configure XAMPP to use PHPMailer for email notifications, follow these steps:

  1. Download PHPMailer from its Github repository using the "Download Zip" button.

    image2
  2. Create a directory for your new application within the htdocs/ subdirectory of your XAMPP installation directory. In this tutorial, the application directory is named example/.

  3. Extract the contents of the PHPMailer ZIP archive to the application directory.

You can now use PHPMailer to send email from your application. To illustrate how it can be used with your Gmail account, use your text editor to create an example script named phpmailer.php in the application directory, and fill it with the following code. Once done, save your changes.

<?php
require 'PHPMailer-master/PHPMailerAutoload.php';
$mail = new PHPMailer;
$mail->isSMTP();
$mail->SMTPSecure = 'tls';
$mail->SMTPAuth = true;
$mail->Host = 'smtp.gmail.com';
$mail->Port = 587;
$mail->Username = '[email protected]';
$mail->Password = 'your-gmail-password';
$mail->setFrom('[email protected]');
$mail->addAddress('[email protected]');
$mail->Subject = 'Hello from PHPMailer!';
$mail->Body = 'This is a test.';
//send the message, check for errors
if (!$mail->send()) {
    echo "ERROR: " . $mail->ErrorInfo;
} else {
    echo "SUCCESS";
}

Remember to replace the dummy values shown with your actual Gmail address and account password. You should also use a valid sender and recipient address. For this simple test, use your own email address as the recipient address.

Now, browse to the URL http://localhost/example/phpmailer.php. This should execute the script and send the email message. If all goes well, you should see a success notification in your browser. If you used your own email address for the recipient address, you should also receive the email message.

image3
As a security precaution, Gmail will automatically rewrite the From: and Reply-to: headers in your email message to reflect your Gmail address. If you want to avoid this, you must add and validate your custom email address in your Gmail account as a sender. Refer to Gmail’s documentation for more information and important restrictions.