PHP 8.1环境下最新PHPMailer无法发送邮件求助

PHP 8.1环境下使用新版PHPMailer实现联系表单，邮件无法发送，点击发送按钮后停留在contact.php页面不跳转；旧版PHPMailer在PHP 7.4环境可正常运行，服务器已开启全量错误日志但无报错，仅能使用sendmail发送邮件。以下是可能的错误点及调试方向：

1. PHPMailer发送模式未显式配置 #

新版PHPMailer默认不会自动启用sendmail模式，需在初始化时显式设置：

function __construct()
{
    // 原有初始化代码...
    $this->mailer = new PHPMailer\PHPMailer\PHPMailer();
    $this->mailer->CharSet = 'utf-8';
    // 添加以下配置
    $this->mailer->isSendmail(); // 指定使用sendmail发送
    // 若服务器sendmail路径非默认，需手动指定
    // $this->mailer->Sendmail = '/usr/sbin/sendmail';
}

2. 验证码验证逻辑失效 #

当前FG_CaptchaHandler的Validate()方法直接返回false，会导致表单验证不通过，ProcessForm()返回false，进而无法触发跳转。需补充实际的验证码验证逻辑：

class FG_CaptchaHandler
{
    function Validate() {
        // 示例：对比session中存储的验证码与提交的scaptcha值
        return isset($_SESSION['captcha'], $_POST['scaptcha']) && $_SESSION['captcha'] === $_POST['scaptcha'];
    }
    function GetError(){ return '验证码输入错误';}
}

3. 收件人未正确添加 #

SendFormSubmission()中调用了CollectConditionalReceipients()，但未明确看到向PHPMailer添加收件人的逻辑。需确保在发送前通过AddAddress()添加合法收件人：

function SendFormSubmission()
{
    $this->CollectConditionalReceipients();
    // 添加收件人（示例）
    foreach($this->receipients as $email) {
        $this->mailer->AddAddress($email);
    }
    // 原有发送代码...
}

4. PHP 8.1兼容性问题 #

• 邮箱格式验证严格性提升：检查GetFromAddress()方法返回的邮箱地址是否合法，非法地址会导致PHPMailer发送失败。
• 空附件处理：表单提交了两个空文件字段（upload1、upload2），需在AttachFiles()中添加判断，跳过空文件上传：

  function AttachFiles() {
      foreach($this->fileupload_fields as $field) {
          if(!empty($_FILES[$field]['tmp_name']) && is_uploaded_file($_FILES[$field]['tmp_name'])) {
              $this->mailer->AddAttachment($_FILES[$field]['tmp_name'], $_FILES[$field]['name']);
          }
      }
  }
  

• 错误屏蔽隐患：移除@html_entity_decode的@符号，明确编码参数，避免隐性错误：

  $this->mailer->AltBody = html_entity_decode($textMsg, ENT_QUOTES, 'UTF-8');
  

5. 跳转逻辑存在输出或缺失终止符 #

检查RedirectToURL()方法，确保跳转前无任何输出（如空格、echo），且包含exit终止后续代码执行：

function RedirectToURL($url) {
    // 确保无输出
    ob_clean();
    header("Location: $url");
    exit;
}

6. 捕获PHPMailer具体错误信息 #

在SendFormSubmission()中添加PHPMailer错误信息记录，便于排查发送失败原因：

if(!$this->mailer->Send())
{
    $error_msg = "Fehler beim Senden der Nachricht! " . $this->mailer->ErrorInfo;
    $this->add_error($error_msg);
    error_log($error_msg); // 写入服务器错误日志
    return false;
}

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