XAMPP环境下PHP mail()无法发送邮件及HTML表单邮件功能问题

Hey there, let's fix that XAMPP mail() function issue once and for all! I've dealt with this a bunch of times, so here's a step-by-step breakdown to get your contact form sending emails to your personal inbox.

XAMPP doesn't come with a built-in mail server out of the box. The native mail() function relies on an external SMTP server to actually deliver emails, so we need to configure it to use one (like Gmail, Outlook, or your domain's SMTP service).

First, locate your XAMPP installation folder (usually C:\xampp on Windows, /Applications/XAMPP on Mac).

Step 2.1: Edit php.ini #

Find php.ini in the xampp/php/ directory. Open it with a text editor (Notepad++, VS Code, etc.) and search for the [mail function] section. Update these lines to match your email provider:

SMTP=smtp.gmail.com  # Swap with smtp.office365.com for Outlook, or your domain's SMTP
smtp_port=587
sendmail_from=your-email-address@gmail.com
sendmail_path="C:\xampp\sendmail\sendmail.exe -t"  # For Mac/Linux: "/Applications/XAMPP/sendmail/sendmail -t"

Note: For Gmail, you’ll need to use an App Password if you have 2FA enabled (less secure app access is no longer supported). Outlook works with your regular email password.

Step 2.2: Edit sendmail.ini #

Head to xampp/sendmail/ and open sendmail.ini. Update these core settings:

smtp_server=smtp.gmail.com
smtp_port=587
smtp_ssl=tls
auth_username=your-email-address@gmail.com
auth_password=your-app-password-or-email-password
force_sender=your-email-address@gmail.com

Don’t skip this! Changes to php.ini won’t take effect until you restart the Apache module in the XAMPP Control Panel.

Create a simple test file test-mail.php in your xampp/htdocs/ folder to verify setup:

<?php
$to = "your-personal-inbox@example.com";
$subject = "XAMPP Test Email";
$message = "Success! This email was sent using XAMPP's mail() function.";
$headers = "From: your-email-address@gmail.com";

if(mail($to, $subject, $message, $headers)){
    echo "Email sent successfully! Check your inbox (and spam folder!)";
} else {
    echo "Failed to send email. Check your settings or logs.";
}
?>

Run it in your browser (e.g., http://localhost/test-mail.php) to confirm it works.

The native mail() function is finicky and lacks robust error handling. PHPMailer is a far more reliable option for form emails. Here’s how to set it up:

1. Download PHPMailer, extract the files, and place the PHPMailer folder in your project directory.
2. Update your form-to-email.php to use PHPMailer:

<?php
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;

require 'PHPMailer/src/Exception.php';
require 'PHPMailer/src/PHPMailer.php';
require 'PHPMailer/src/SMTP.php';

$mail = new PHPMailer(true);

try {
    // Server config
    $mail->SMTPDebug = 0; // Set to 2 for troubleshooting output
    $mail->isSMTP();                                           
    $mail->Host       = 'smtp.gmail.com';                     
    $mail->SMTPAuth   = true;                                  
    $mail->Username   = 'your-email-address@gmail.com';         
    $mail->Password   = 'your-app-password';                   
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;         
    $mail->Port       = 587;                                   

    // Recipients
    $mail->setFrom('your-email-address@gmail.com', 'Website Contact');
    $mail->addAddress('your-personal-inbox@example.com'); // Your personal inbox

    // Content
    $mail->isHTML(true);                                  
    $mail->Subject = 'New Message from Contact Form';
    $mail->Body    = "Name: " . $_POST['name'] . "<br>Email: " . $_POST['email'] . "<br>Message: " . $_POST['message'];

    $mail->send();
    echo 'Your message has been sent successfully!';
} catch (Exception $e) {
    echo "Oops, something went wrong. Error: {$mail->ErrorInfo}";
}
?>

• Check your spam folder: Test emails often land here first.
• Verify file paths: Ensure sendmail_path in php.ini points to the correct location of sendmail.exe.
• Check logs: XAMPP’s Apache error logs are in xampp/apache/logs/error.log — they’ll show you if there’s a configuration issue.
• For Gmail: Double-check that you’re using an App Password (if 2FA is enabled) — regular passwords won’t work.

内容的提问来源于stack exchange，提问作者Daniel Lau