PHPMailer 的 mail、sendmail 与 SMTP 三种发送方式怎么选【免费下载链接】PHPMailerThe classic email sending library for PHP项目地址: https://gitcode.com/GitHub_Trending/ph/PHPMailerPHPMailer 支持三种邮件传输方式调用 PHP 内置的mail()函数、直接执行本机的 sendmail 程序、以及通过内置 SMTP 客户端连接 SMTP 服务器。三种方式写邮件内容的代码几乎一样差别只在“如何把消息交给传输系统”。如果你正在 PHP 项目里集成 PHPMailer需要在动手前确定用哪一种这篇文章基于仓库内的examples/示例和 README给出三种方式各自的前提条件、官方示例代码和验证方式帮你按运行环境做出选择。适用前提PHP 5.5 及以上README 说明兼容至 PHP 8.2推荐通过 Composer 安装。当前仓库版本号为 6.9.3见 VERSION。先安装 PHPMailer无论选哪种传输方式加载方式相同。README 推荐用 Composer 安装composer require phpmailer/phpmailer或把phpmailer/phpmailer: ^6.9.2加入composer.json。注意vendor目录和vendor/autoload.php由 Composer 生成不属于 PHPMailer 仓库本身。如果你不用 Composer 而是手动引入类文件按 README 的“Minimal installation”一节至少需要 src/PHPMailer.php使用 SMTP 时还需要 src/SMTP.php只有用 POP-before-SMTP 时才需要 src/POP3.php不向用户展示错误信息时可省略 language 目录。另外注意通过 Composer 或 zip 包安装时不包含 examples 目录本文引用的示例代码需要 git clone 仓库后在 examples 目录查看。三种方式的前提条件与差异选择依据都来自仓库文档按运行环境对照1.mail()函数examples/mail.phps使用 PHP 内置的mail()函数是三者中最简单的用法依赖本机存在本地邮件服务器。PHP 的mail()函数通常经由本地邮件服务器发送在 Linux、BSD、macOS 上通常有 sendmail 二进制程序顶在前面而Windows 上一般没有本地邮件服务器见 examples/README.md 对mail.phps的说明README 的“Why you might need it”一节给出明确态度mail()应尽量避免使用连 localhost 的 SMTP 都比它更快、更安全mail.phps没有调用任何is*()切换方法直接按默认传输方式发送。2. sendmail 程序examples/sendmail.phpssendmail 是一个程序通常出现在 Linux/BSD、OS X 及其他类 UNIX 系统上可以不用经历完整的 SMTP 会话就把消息提交给本地邮件服务器文档评价是“可能是最快的发送机制但错误报告功能较弱”lacks some error reporting features通过$mail-isSendmail()切换。从 src/PHPMailer.php#L981-L991 可以看到它的行为读取 php.ini 的sendmail_path如果该值中不含sendmail字样则使用/usr/sbin/sendmail否则使用sendmail_path配置的值。3. SMTPexamples/smtp.phps、examples/smtp_no_auth.phps通过 PHPMailer 内置的 SMTP 客户端直接连接 SMTP 服务器所有平台都不需要本地邮件服务器Windows 环境的唯一可行路径支持认证LOGIN、PLAIN、CRAM-MD5、XOAUTH2以及 SMTPS 和 SMTPSTARTTLS 传输README Features 一节通过$mail-isSMTP()切换。可以这样归纳判断路径没有本地邮件服务器典型为 Windows→ 只能选 SMTP有本地邮件服务器、要最简单 →mail()有 sendmail 类程序、追求提交速度且能接受弱错误报告 → sendmail而 README 的官方立场是把 SMTP哪怕是 localhost作为首选。配置示例三种示例的邮件内容部分完全相同读取contents.html、设置纯文本AltBody、附加图片差异只在传输方式那几行。以下代码摘自仓库示例文件域名沿用了示例中的example.com——examples/README.md 说明这是 IANA 为文档示例保留的域名RFC 2606运行时需替换为你自己的真实邮箱地址。方式一mail()摘自 examples/mail.phps//Import the PHPMailer class into the global namespace use PHPMailer\PHPMailer\PHPMailer; require ../vendor/autoload.php; //Create a new PHPMailer instance $mail new PHPMailer(); //Set who the message is to be sent from $mail-setFrom(fromexample.com, First Last); //Set an alternative reply-to address $mail-addReplyTo(replytoexample.com, First Last); //Set who the message is to be sent to $mail-addAddress(whotoexample.com, John Doe); //Set the subject line $mail-Subject PHPMailer mail() test; //Read an HTML message body from an external file, convert referenced images to embedded, //convert HTML into a basic plain-text alternative body $mail-msgHTML(file_get_contents(contents.html), __DIR__); //Replace the plain text body with one created manually $mail-AltBody This is a plain-text message body; //Attach an image file $mail-addAttachment(images/phpmailer_mini.png); //send the message, check for errors if (!$mail-send()) { echo Mailer Error: . $mail-ErrorInfo; } else { echo Message sent!; }方式二sendmail摘自 examples/sendmail.phps与上面相比只多一行//Set PHPMailer to use the sendmail transport $mail-isSendmail();方式三SMTP带认证摘自 examples/smtp.phps 的传输配置部分//SMTP needs accurate times, and the PHP time zone MUST be set //This should be done in your php.ini, but this is how to do it if you dont have access to that date_default_timezone_set(Etc/UTC); require ../vendor/autoload.php; $mail new PHPMailer(); //Tell PHPMailer to use SMTP $mail-isSMTP(); //Enable SMTP debugging //SMTP::DEBUG_OFF off (for production use) //SMTP::DEBUG_CLIENT client messages //SMTP::DEBUG_SERVER client and server messages $mail-SMTPDebug SMTP::DEBUG_SERVER; //Set the hostname of the mail server $mail-Host mail.example.com; //Set the SMTP port number - likely to be 25, 465 or 587 $mail-Port 25; //Whether to use SMTP authentication $mail-SMTPAuth true; //Username to use for SMTP authentication $mail-Username yournameexample.com; //Password to use for SMTP authentication $mail-Password yourpassword;Host、Port、Username、Password替换为你的 SMTP 服务器实际值。若服务器不接受匿名发信参考 examples/smtp_no_auth.phps它去掉认证配置并注明SMTPAuth false是默认值无需显式设置。需要 TLS 加密和认证的服务商如 Gmail有现成配置examples/gmail.phps 连接smtp.gmail.com的 587 提交端口启用 TLS 和认证README 也把 Gmail 示例列为入门推荐起点。README 主示例中则展示了SMTPSecure的两种取值PHPMailer::ENCRYPTION_SMTPS对应 465 端口PHPMailer::ENCRYPTION_STARTTLS对应 587 端口。调试时SMTPDebug用SMTP::DEBUG_SERVER输出客户端和服务器双方的消息生产环境应改回SMTP::DEBUG_OFF示例注释里明确标注 DEBUG_OFF 是 for production use。验证发送结果与本地测试三种示例用同一种方式判断结果$mail-send()返回布尔值失败时读取$mail-ErrorInfoif (!$mail-send()) { echo Mailer Error: . $mail-ErrorInfo; } else { echo Message sent!; }也可以改用异常模式new PHPMailer(true)构造时传入true即启用异常send()失败会抛出Exception在 catch 中读取$mail-ErrorInfoREADME 的“Simple Example”和 examples/exceptions.phps 都采用这种写法。反复调试时不要往真实收件人发测试邮件仓库提供了不真正外发的验证手段见 examples/README.md 的“About testing email sending”一节测mail/sendmail方式用测试套件里的 test/fakesendmail.sh这是一个模拟 sendmail 的 shell 脚本专用于测试 PHPMailer 的 mail 或 sendmail 方法测 SMTP 方式用假 SMTP 服务器如 FakeEmailPython带 Web 界面、Postfix 自带的 smtp-sinkPHPMailer 的 CI 测试就用它、smtp4dev、MailHog 等它们像真实服务器一样响应但不外发邮件可用于验证认证和错误处理用 msglintIETF 的 MIME 结构分析器检查消息格式是否符合规范若要真实检查邮件配置SPF、DKIM、DMARC 等文档列出了 aboutmy.email 这类在线服务。运行示例文件前注意 examples/README.md 的安全说明示例以.phps后缀提供通常会被 PHP 以语法高亮方式显示而不是执行如果要放到 Web 服务器运行必须先改名为.php并且不要把真实密码写进这些文件里。限制与选择结论mail()与 sendmail 都要求本机有可用的本地邮件服务器或 sendmail 程序Windows 一般不具备这一条件此时只有 SMTP 可选文档同时建议遇到这种情况“安装本地邮件服务器或使用远程服务器走 SMTP”。sendmail 方式错误报告能力弱于 SMTP出问题时可用信息有限。README 对mail()的立场明确应尽量避免使用它SMTP哪怕是 localhost更快也更安全。因此默认主路径是有 SMTP 账号就用isSMTP()确认本机有 sendmail 类程序且需要最快提交时才考虑isSendmail()mail()仅在已有本地邮件服务器、且希望最简配置时使用。若发送量较大如群发SMTP 方式可参考 examples/mailing_list.phps它利用 SMTP keepalive 避免每条消息都重新连接和认证。【免费下载链接】PHPMailerThe classic email sending library for PHP项目地址: https://gitcode.com/GitHub_Trending/ph/PHPMailer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/14 18:29:59 · 阅读 1.2k PHPMailer 的 mail、sendmail 与 SMTP 三种发送方式怎么选？
PHPMailer 的 mail、sendmail 与 SMTP 三种发送方式怎么选【免费下载链接】PHPMailerThe classic email sending library for PHP项目地址: https://gitcode.com/GitHub_Trending/ph/PHPMailerPHPMailer 支持三种邮件传输方式调用 PHP 内置的mail()函数、直接执行本机的 sendmail 程序、以及通过内置 SMTP 客户端连接 SMTP 服务器。三种方式写邮件内容的代码几乎一样差别只在“如何把消息交给传输系统”。如果你正在 PHP 项目里集成 PHPMailer需要在动手前确定用哪一种这篇文章基于仓库内的examples/示例和 README给出三种方式各自的前提条件、官方示例代码和验证方式帮你按运行环境做出选择。适用前提PHP 5.5 及以上README 说明兼容至 PHP 8.2推荐通过 Composer 安装。当前仓库版本号为 6.9.3见 VERSION。先安装 PHPMailer无论选哪种传输方式加载方式相同。README 推荐用 Composer 安装composer require phpmailer/phpmailer或把phpmailer/phpmailer: ^6.9.2加入composer.json。注意vendor目录和vendor/autoload.php由 Composer 生成不属于 PHPMailer 仓库本身。如果你不用 Composer 而是手动引入类文件按 README 的“Minimal installation”一节至少需要 src/PHPMailer.php使用 SMTP 时还需要 src/SMTP.php只有用 POP-before-SMTP 时才需要 src/POP3.php不向用户展示错误信息时可省略 language 目录。另外注意通过 Composer 或 zip 包安装时不包含 examples 目录本文引用的示例代码需要 git clone 仓库后在 examples 目录查看。三种方式的前提条件与差异选择依据都来自仓库文档按运行环境对照1.mail()函数examples/mail.phps使用 PHP 内置的mail()函数是三者中最简单的用法依赖本机存在本地邮件服务器。PHP 的mail()函数通常经由本地邮件服务器发送在 Linux、BSD、macOS 上通常有 sendmail 二进制程序顶在前面而Windows 上一般没有本地邮件服务器见 examples/README.md 对mail.phps的说明README 的“Why you might need it”一节给出明确态度mail()应尽量避免使用连 localhost 的 SMTP 都比它更快、更安全mail.phps没有调用任何is*()切换方法直接按默认传输方式发送。2. sendmail 程序examples/sendmail.phpssendmail 是一个程序通常出现在 Linux/BSD、OS X 及其他类 UNIX 系统上可以不用经历完整的 SMTP 会话就把消息提交给本地邮件服务器文档评价是“可能是最快的发送机制但错误报告功能较弱”lacks some error reporting features通过$mail-isSendmail()切换。从 src/PHPMailer.php#L981-L991 可以看到它的行为读取 php.ini 的sendmail_path如果该值中不含sendmail字样则使用/usr/sbin/sendmail否则使用sendmail_path配置的值。3. SMTPexamples/smtp.phps、examples/smtp_no_auth.phps通过 PHPMailer 内置的 SMTP 客户端直接连接 SMTP 服务器所有平台都不需要本地邮件服务器Windows 环境的唯一可行路径支持认证LOGIN、PLAIN、CRAM-MD5、XOAUTH2以及 SMTPS 和 SMTPSTARTTLS 传输README Features 一节通过$mail-isSMTP()切换。可以这样归纳判断路径没有本地邮件服务器典型为 Windows→ 只能选 SMTP有本地邮件服务器、要最简单 →mail()有 sendmail 类程序、追求提交速度且能接受弱错误报告 → sendmail而 README 的官方立场是把 SMTP哪怕是 localhost作为首选。配置示例三种示例的邮件内容部分完全相同读取contents.html、设置纯文本AltBody、附加图片差异只在传输方式那几行。以下代码摘自仓库示例文件域名沿用了示例中的example.com——examples/README.md 说明这是 IANA 为文档示例保留的域名RFC 2606运行时需替换为你自己的真实邮箱地址。方式一mail()摘自 examples/mail.phps//Import the PHPMailer class into the global namespace use PHPMailer\PHPMailer\PHPMailer; require ../vendor/autoload.php; //Create a new PHPMailer instance $mail new PHPMailer(); //Set who the message is to be sent from $mail-setFrom(fromexample.com, First Last); //Set an alternative reply-to address $mail-addReplyTo(replytoexample.com, First Last); //Set who the message is to be sent to $mail-addAddress(whotoexample.com, John Doe); //Set the subject line $mail-Subject PHPMailer mail() test; //Read an HTML message body from an external file, convert referenced images to embedded, //convert HTML into a basic plain-text alternative body $mail-msgHTML(file_get_contents(contents.html), __DIR__); //Replace the plain text body with one created manually $mail-AltBody This is a plain-text message body; //Attach an image file $mail-addAttachment(images/phpmailer_mini.png); //send the message, check for errors if (!$mail-send()) { echo Mailer Error: . $mail-ErrorInfo; } else { echo Message sent!; }方式二sendmail摘自 examples/sendmail.phps与上面相比只多一行//Set PHPMailer to use the sendmail transport $mail-isSendmail();方式三SMTP带认证摘自 examples/smtp.phps 的传输配置部分//SMTP needs accurate times, and the PHP time zone MUST be set //This should be done in your php.ini, but this is how to do it if you dont have access to that date_default_timezone_set(Etc/UTC); require ../vendor/autoload.php; $mail new PHPMailer(); //Tell PHPMailer to use SMTP $mail-isSMTP(); //Enable SMTP debugging //SMTP::DEBUG_OFF off (for production use) //SMTP::DEBUG_CLIENT client messages //SMTP::DEBUG_SERVER client and server messages $mail-SMTPDebug SMTP::DEBUG_SERVER; //Set the hostname of the mail server $mail-Host mail.example.com; //Set the SMTP port number - likely to be 25, 465 or 587 $mail-Port 25; //Whether to use SMTP authentication $mail-SMTPAuth true; //Username to use for SMTP authentication $mail-Username yournameexample.com; //Password to use for SMTP authentication $mail-Password yourpassword;Host、Port、Username、Password替换为你的 SMTP 服务器实际值。若服务器不接受匿名发信参考 examples/smtp_no_auth.phps它去掉认证配置并注明SMTPAuth false是默认值无需显式设置。需要 TLS 加密和认证的服务商如 Gmail有现成配置examples/gmail.phps 连接smtp.gmail.com的 587 提交端口启用 TLS 和认证README 也把 Gmail 示例列为入门推荐起点。README 主示例中则展示了SMTPSecure的两种取值PHPMailer::ENCRYPTION_SMTPS对应 465 端口PHPMailer::ENCRYPTION_STARTTLS对应 587 端口。调试时SMTPDebug用SMTP::DEBUG_SERVER输出客户端和服务器双方的消息生产环境应改回SMTP::DEBUG_OFF示例注释里明确标注 DEBUG_OFF 是 for production use。验证发送结果与本地测试三种示例用同一种方式判断结果$mail-send()返回布尔值失败时读取$mail-ErrorInfoif (!$mail-send()) { echo Mailer Error: . $mail-ErrorInfo; } else { echo Message sent!; }也可以改用异常模式new PHPMailer(true)构造时传入true即启用异常send()失败会抛出Exception在 catch 中读取$mail-ErrorInfoREADME 的“Simple Example”和 examples/exceptions.phps 都采用这种写法。反复调试时不要往真实收件人发测试邮件仓库提供了不真正外发的验证手段见 examples/README.md 的“About testing email sending”一节测mail/sendmail方式用测试套件里的 test/fakesendmail.sh这是一个模拟 sendmail 的 shell 脚本专用于测试 PHPMailer 的 mail 或 sendmail 方法测 SMTP 方式用假 SMTP 服务器如 FakeEmailPython带 Web 界面、Postfix 自带的 smtp-sinkPHPMailer 的 CI 测试就用它、smtp4dev、MailHog 等它们像真实服务器一样响应但不外发邮件可用于验证认证和错误处理用 msglintIETF 的 MIME 结构分析器检查消息格式是否符合规范若要真实检查邮件配置SPF、DKIM、DMARC 等文档列出了 aboutmy.email 这类在线服务。运行示例文件前注意 examples/README.md 的安全说明示例以.phps后缀提供通常会被 PHP 以语法高亮方式显示而不是执行如果要放到 Web 服务器运行必须先改名为.php并且不要把真实密码写进这些文件里。限制与选择结论mail()与 sendmail 都要求本机有可用的本地邮件服务器或 sendmail 程序Windows 一般不具备这一条件此时只有 SMTP 可选文档同时建议遇到这种情况“安装本地邮件服务器或使用远程服务器走 SMTP”。sendmail 方式错误报告能力弱于 SMTP出问题时可用信息有限。README 对mail()的立场明确应尽量避免使用它SMTP哪怕是 localhost更快也更安全。因此默认主路径是有 SMTP 账号就用isSMTP()确认本机有 sendmail 类程序且需要最快提交时才考虑isSendmail()mail()仅在已有本地邮件服务器、且希望最简配置时使用。若发送量较大如群发SMTP 方式可参考 examples/mailing_list.phps它利用 SMTP keepalive 避免每条消息都重新连接和认证。【免费下载链接】PHPMailerThe classic email sending library for PHP项目地址: https://gitcode.com/GitHub_Trending/ph/PHPMailer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考