个人网站PHPMailer发信问题：本地正常线上发送失败

Hey there, let’s tackle this SMTP issue you’re facing with PHPMailer and Gmail on your deployed server. I’ve run into similar headaches before, so here are the most common fixes to get your emails sending again:

1. Fix Gmail’s Security Restrictions #

This is the #1 culprit for this exact problem. Gmail blocks "less secure apps" by default now, which means your server’s PHPMailer setup can’t use your regular password to authenticate. You have two solid options here:

• Use an App Password: Enable 2-Step Verification on your Google account, then generate a 16-character App Password (under "Security" > "App passwords"). Replace your regular Gmail password in $mail->Password with this app password—it’s designed specifically for apps like PHPMailer.
• Switch to OAuth2: If you don’t want 2-Step Verification, you can set up PHPMailer’s OAuth2 support. This requires creating a project in the Google Cloud Console to get client IDs and secrets, but it’s more secure long-term.

2. Check for Server Firewall/Port Blocking #

Many shared hosting providers block outgoing SMTP ports like 587 (TLS) or 465 (SSL) to prevent spam. To test this:

• Log into your server via SSH and run: telnet smtp.gmail.com 587
• If the connection times out or fails, your port is blocked. Reach out to your hosting provider to unblock it, or switch to using their native SMTP server instead of Gmail’s.

3. Enable PHPMailer Debugging #

Right now you’re only getting a generic error message—we need to see what’s actually going wrong. Add these lines to your PHPMailer setup to get detailed debug output:

$mail->SMTPDebug = 2; // Turn on verbose debug mode
$mail->Debugoutput = 'html'; // Output errors in readable HTML

This will show you exactly where the process fails (e.g., authentication errors, connection timeouts) so you can target the fix.

4. Verify Server PHP Configurations #

PHPMailer needs specific PHP extensions to work with Gmail’s SSL/TLS connections:

• Make sure the openssl extension is enabled on your server. You can check this by creating a phpinfo.php file with <?php phpinfo(); ?> and searching for the "openssl" section.
• Ensure allow_url_fopen is enabled in your php.ini file (this is required for some PHPMailer functions).

5. Set Up DNS Records (SPF) #

Gmail might reject your emails if your domain doesn’t have a valid SPF record. Add an SPF record to your domain’s DNS that includes your server’s IP address. A basic example looks like:
v=spf1 ip4:your_server_ip_address include:_spf.google.com ~all
This tells Gmail that your server is authorized to send emails on behalf of your domain.

Example Modified Code #

Here’s how your code might look with debugging enabled and using an App Password:

<?php
if(isset($_POST['sendmail'])) {
    require 'PHPMailer/PHPMailerAutoload.php';
    $mail = new PHPMailer;
    
    // Enable debugging to see errors
    $mail->SMTPDebug = 2;
    $mail->Debugoutput = 'html';
    
    $mail->isSMTP();
    $mail->Host = 'smtp.gmail.com';
    $mail->SMTPAuth = true;
    $mail->Username = 'your-gmail@gmail.com';
    $mail->Password = 'your-16-character-app-password'; // Use App Password here
    $mail->SMTPSecure = 'tls';
    $mail->Port = 587;
    
    $mail->setFrom('your-gmail@gmail.com', 'Your Name');
    $mail->addAddress('recipient@example.com');
    
    $mail->isHTML(true);
    $mail->Subject = 'Test Deployment Email';
    $mail->Body    = 'If you see this, the fix worked!';
    $mail->AltBody = 'Plain text fallback for non-HTML clients';
    
    if(!$mail->send()) {
        echo 'Message failed to send.';
        echo '<br>Error Details: ' . $mail->ErrorInfo;
    } else {
        echo 'Message sent successfully!';
    }
}
?>

Start with enabling debugging first—it’ll give you the exact error message to work with. Most of the time, it’s either a Gmail security setting or a blocked port.

内容的提问来源于stack exchange，提问作者Wajahat Anjum