如何调试PHP联系表单发送程序？排查邮件发送失败问题

Hey there, let's walk through some systematic troubleshooting steps to figure out why your email form isn't working. I've glanced over your code and while it looks logically sound, PHP's built-in mail() function has a lot of moving parts that can fail silently. Here's what you can check next:

1. Test the mail() Function in Isolation #

First, rule out issues with your form logic by creating a minimal test script. This will tell you if the problem is with your server's mail configuration rather than your form code.

Create a file called test-mail.php with this code:

<?php
$to = "severinyeboue@gmail.com";
$subject = "Quick Server Mail Test";
$message = "If you get this, your server's mail function is working!";
$headers = "From: test@your-domain.com"; // Replace with your actual domain

if(mail($to, $subject, $message, $headers)) {
    echo "Email sent successfully! Check your inbox (and spam folder).";
} else {
    echo "Email failed to send. Problem is likely server-side.";
}
?>

Run this script directly in your browser. If it fails, skip to step 3—your server's mail setup is the issue. If it works, your form has a subtle data handling problem.

2. Debug Form Data Handling #

Make sure the form data is actually reaching your PHP script correctly. Add this line right at the start of your POST handler:

var_dump($_POST); exit;

Submit your form and check the output. Verify that all fields (name, email, subject, number, message) are present and have the values you entered. If any are missing, check your form's HTML:

• Ensure all input fields have matching name attributes (e.g., <input name="number"> matches $_POST["number"]).
• Confirm your form uses method="POST" and the correct action URL.

3. Check Server Error Logs #

This is the most important step—error logs will tell you exactly what's breaking. Depending on your server setup:

• Apache: Logs are usually at /var/log/apache2/error.log (Linux) or C:\xampp\apache\logs\error.log (Windows/XAMPP).
• Nginx: Check /var/log/nginx/error.log.
• PHP: Find the error_log path in your php.ini file (look for the line starting with error_log =).

Look for entries mentioning mail() or sendmail—common errors include:

• "Failed to execute /usr/sbin/sendmail" (sendmail isn't installed or configured)
• "Invalid address" (headers are malformed)
• "Permission denied" (server doesn't allow PHP to send mail)

4. Fix Email Headers Formatting #

Your current headers are missing required line breaks and standard fields, which can trigger spam filters or be rejected by mail servers. Update your $email_headers to:

$email_headers = "From: $name <$email>\r\n";
$email_headers .= "Reply-To: $email\r\n";
$email_headers .= "X-Mailer: PHP/" . phpversion();

Email standards require \r\n (carriage return + line feed) for line breaks, not just \n. Adding Reply-To makes it easier to respond to messages, and X-Mailer helps servers identify the sender.

5. Check for Spam Filtering #

Even if the mail sends successfully, it might be getting trapped in your spam folder. Check your Gmail spam folder first—many default mail() messages are flagged because they lack SPF/DKIM authentication.

For production use, consider adding SPF and DKIM records to your domain's DNS. These tell mail servers your messages are legitimate and reduce the chance of them being marked as spam.

6. Switch to a Dedicated Mail Library #

PHP's native mail() function is notoriously unreliable for production use—it's thin, doesn't handle errors well, and relies heavily on server configuration. Libraries like PHPMailer or SwiftMailer are far more robust, support SMTP authentication (which is trusted by mail servers), and provide detailed error messages.

Here's a quick PHPMailer example using Gmail SMTP (note: you'll need to enable 2FA on your Gmail account and create an app password):

<?php
require 'PHPMailer/PHPMailer.php';
require 'PHPMailer/SMTP.php';

use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\SMTP;

// Initialize PHPMailer
$mail = new PHPMailer(true);

try {
    // Server settings
    $mail->isSMTP();
    $mail->Host = 'smtp.gmail.com';
    $mail->SMTPAuth = true;
    $mail->Username = 'your-gmail-account@gmail.com';
    $mail->Password = 'your-gmail-app-password';
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
    $mail->Port = 587;

    // Recipients
    $mail->setFrom($email, $name);
    $mail->addAddress('severinyeboue@gmail.com');

    // Content
    $mail->Subject = "Nouveau message de $name";
    $mail->Body = $email_content;

    $mail->send();
    http_response_code(200);
    echo "Merci! Votre message nous est bien parvenu !";
} catch (Exception $e) {
    http_response_code(500);
    echo "L'envoi du mail a échoué, veuillez réessayer SVP. Erreur: {$mail->ErrorInfo}";
}
?>

7. Verify Server Mail Configuration #

If you're on a VPS or dedicated server, check your PHP php.ini file for mail settings:

• sendmail_path: For Linux, this should point to the sendmail executable (e.g., /usr/sbin/sendmail -t -i).
• SMTP and smtp_port: For Windows, set these to your mail server's address (e.g., smtp.your-domain.com and 587).

If you're on shared hosting, contact your host to confirm:

• Is PHP mail enabled for your account?
• Are there any send limits or restrictions?
• Do they require using their SMTP server instead of sendmail?

内容的提问来源于stack exchange，提问作者Don Yeboue