PHPMailer 调用远程 SMTP 服务器发送邮件的实现方法

Noah

发布时间：2026-10-13 | 4人浏览过

原创

详细讲述如何使用 PHPMailer 类库调用远程 SMTP 服务器发送邮件，涵盖基础配置要点、完整代码示例以及使用过程中的关键注意事项。

准备环境与依赖

在开始之前，需要获取并引入 PHPMailer 类库文件。通常只需下载核心的 class.phpmailer.php 文件（若需 SMTP 验证还可能需要 class.smtp.php），将其放置于项目的特定目录中。确保运行环境已安装必要的 PHP 扩展以支持网络请求和异常处理。

核心配置参数说明

要让 PHPMailer 能够通过远程 SMTP 服务器发信，必须正确初始化该类并进行多项属性赋值。以下是关键的配置逻辑：

启用 SMTP 模式：调用 $mail->IsSMTP(); 告诉类使用 SMTP 协议而非本地组件。
开启认证：设置 $mail->SMTPAuth = true;，大多数现代邮件服务商均要求身份验证。
指定服务器与端口：配置 Host 为远程 SMTP 地址（如 smtp.example.com），并通过 Port 指定端口（常用 25、465 或 587）。
填写账号信息：在 Username 和 Password 中填入合法的邮箱账户和密码。
发件人与收件人：分别使用 From/FromName 定义发件标识，使用 AddAddress() 添加目标接收者。

第1步：构建并测试发送脚本

以下为标准的实现代码结构，涵盖了 HTML 内容解析、异常捕获及核心发送流程。请将占位符替换为真实的服务器信息与账号凭据。

<?php
require 'class.phpmailer.php';
// 若有SMTP类未自动加载，建议显式引入：
// require 'class.smtp.php';
try {
  // 实例化对象，传入 true 启用异常捕获
  $mail = new PHPMailer(true);
  
  // --- 核心配置区域 ---
  $mail->IsSMTP();                          // 告知类使用 SMTP
  $mail->SMTPAuth  = true;                  // 启用 SMTP 身份验证
  $mail->Port = 25;                         // 设置 SMTP 服务器端口（根据服务商调整）
  $mail->Host = "mail.yourdomain.com";      // 远程 SMTP 服务器地址
  $mail->Username = "yourname@yourdomain.com"; // SMTP 服务器用户名
  $mail->Password  = "yourpassword";        // SMTP 服务器用户密码
  
  // --- 弃用 Sendmail 模式 ---
  // $mail->IsSendmail(); // 如果使用远程SMTP，务必注释掉此行，否则在无sendmail环境下会报错
  
  // --- 邮件元数据 ---
  $mail->AddReplyTo("yourname@yourdomain.com", "First Last");
  $mail->From    = "fromname@yourdomain.com";
  $mail->FromName  = "First Last";
  $to = "toname@domain.com";
  $mail->AddAddress($to);
  $mail->Subject = "First PHPMailer Message";
  
  // --- 内容设置 ---
  // 读取外部HTML模板作为邮件正文
  $body = file_get_contents('contents.html'); 
  $body = preg_replace('/\s+/', '', $body); // 去除多余空白字符
  $mail->MsgHTML($body);                   // 将HTML内容设为邮件主体
  $mail->IsHTML(true);                     // 声明正文为 HTML 格式
  
  // --- 执行发送 ---
  $mail->Send();
  echo 'Message has been sent successfully.';
} catch (Exception $e) {
  // 输出具体的错误信息以便排查
  echo 'Message could not be sent. Mailer Error: ' . $mail->ErrorInfo;
}
?>

完成状态判断

如果代码无语法错误且数据库/网络通畅，控制台将打印 Message has been sent successfully.。若目标邮箱收到该邮件，即表示配置完全正确。

常见问题与排错指南

1. 关于 IsSendmail 的冲突警告

在使用远程 SMTP 时，务必确认 $mail->IsSendmail(); 已被注释或删除。若不注释且在系统中不存在 Sendmail 组件，将会触发致命错误提示：
“Could not execute: /var/qmail/bin/sendmail”。因为该类会优先尝试本地进程通信而非网络 SMTP。