在PHP项目开发中,邮件发送是常见需求,比如用户注册验证、密码重置、系统通知等场景都需要用到。目前主流的实现方式有两种,一种是PHP原生的mail函数,另一种是第三方库PHPMailer,两种方式各有适用场景。
PHP原生mail函数实现邮件发送
mail函数是PHP内置的函数,不需要额外安装依赖,适合简单的邮件发送场景,不过它的功能比较基础,且依赖服务器的邮件配置。
基本语法
mail函数的语法格式如下:
<?php // mail函数参数说明: // 第一个参数:收件人邮箱地址 // 第二个参数:邮件主题 // 第三个参数:邮件正文内容 // 第四个参数:可选,邮件头信息 // 第五个参数:可选,额外参数 bool mail ( string $to , string $subject , string $message [, string $additional_headers = "" [, string $additional_parameters = "" ]] ) ?>
简单示例
发送纯文本邮件的基础代码如下:
<?php
$to = "test@ipipp.com"; // 收件人邮箱
$subject = "测试邮件"; // 邮件主题
$message = "这是一封通过PHP mail函数发送的测试邮件"; // 邮件正文
// 设置邮件头,指定发件人和内容类型
$headers = "From: sender@ipipp.comrn";
$headers .= "Content-type: text/plain; charset=utf-8rn";
// 发送邮件
if(mail($to, $subject, $message, $headers)){
echo "邮件发送成功";
} else {
echo "邮件发送失败";
}
?>
注意事项
- mail函数依赖服务器上的sendmail程序或者SMTP配置,部分虚拟主机可能没有开启相关权限,会导致发送失败。
- 如果需要发送HTML格式的邮件,需要在邮件头中设置Content-type为text/html,并且正文内容要符合HTML格式规范。
- 原生mail函数没有身份验证机制,发送的邮件很容易被收件方判定为垃圾邮件。
PHPMailer实现邮件发送
PHPMailer是一个功能强大的第三方PHP邮件发送类库,支持SMTP验证、附件发送、HTML邮件、抄送密送等多种特性,是实际项目中使用最多的邮件发送方案。
安装PHPMailer
可以通过Composer安装PHPMailer,执行以下命令:
composer require phpmailer/phpmailer
如果没有使用Composer,也可以从PHPMailer的官方仓库下载源码,手动引入项目。
使用SMTP发送邮件示例
以下是通过SMTP协议使用QQ邮箱发送邮件的示例代码:
<?php
use PHPMailerPHPMailerPHPMailer;
use PHPMailerPHPMailerException;
// 引入PHPMailer的自动加载文件,手动引入的话需要调整路径
require 'vendor/autoload.php';
$mail = new PHPMailer(true); // 参数true开启异常抛出
try {
// 服务器配置
$mail->SMTPDebug = 0; // 调试模式,0为关闭,1为输出客户端信息,2为输出服务端和客户端信息
$mail->isSMTP(); // 使用SMTP协议发送
$mail->Host = 'smtp.qq.com'; // SMTP服务器地址,QQ邮箱的SMTP地址是这个
$mail->SMTPAuth = true; // 开启SMTP身份验证
$mail->Username = '你的QQ邮箱@ipipp.com'; // SMTP用户名,也就是发件邮箱
$mail->Password = 'QQ邮箱授权码'; // SMTP密码,不是邮箱登录密码,是邮箱的SMTP授权码
$mail->SMTPSecure = 'ssl'; // 加密方式,QQ邮箱SMTP用ssl,端口465
$mail->Port = 465; // SMTP端口
// 收件人配置
$mail->setFrom('你的QQ邮箱@ipipp.com', '发件人名称'); // 发件人邮箱和名称
$mail->addAddress('test@ipipp.com', '收件人名称'); // 添加收件人,可多次调用添加多个
//$mail->addReplyTo('reply@ipipp.com', '回复地址'); // 可选,设置回复地址
//$mail->addCC('cc@ipipp.com'); // 可选,添加抄送人
//$mail->addBCC('bcc@ipipp.com'); // 可选,添加密送人
// 附件配置,可选
//$mail->addAttachment('/path/to/file.pdf', '附件名称.pdf'); // 添加附件
// 邮件内容配置
$mail->isHTML(true); // 设置邮件格式为HTML
$mail->Subject = 'PHPMailer测试邮件'; // 邮件主题
$mail->Body = '<h1>这是一封HTML格式的测试邮件</h1><p>通过PHPMailer发送</p>'; // HTML格式的正文
$mail->AltBody = '这是一封测试邮件,通过PHPMailer发送'; // 纯文本格式的备用正文,给不支持HTML的邮件客户端用
$mail->send();
echo '邮件发送成功';
} catch (Exception $e) {
echo '邮件发送失败,错误信息:', $mail->ErrorInfo;
}
?>
PHPMailer常用技巧
- 如果需要发送多个收件人,可以多次调用
addAddress方法,不需要拼接字符串。 - 发送附件时,
addAttachment方法的第一个参数是服务器上的文件路径,第二个可选参数是附件在邮件中显示的名称。 - 如果SMTP服务器要求tls加密,把
SMTPSecure设置为tls,端口改为587即可。 - 生产环境建议把
SMTPDebug设置为0,避免泄露服务器配置信息。
两种方案对比
| 对比项 | mail函数 | PHPMailer |
|---|---|---|
| 依赖 | 无需额外依赖,PHP内置 | 需要引入第三方库 |
| 功能 | 仅支持基础邮件发送,无身份验证 | 支持SMTP验证、附件、HTML、抄送密送等 |
| 兼容性 | 依赖服务器环境配置,容易失败 | 跨环境兼容性好,只要能联网就能用 |
| 垃圾邮件判定 | 概率高 | 配置正确的情况下概率低 |
| 适用场景 | 简单的本地测试场景 | 生产环境、对功能有要求的场景 |
开发注意事项
不要在代码中硬编码邮箱密码和授权码,建议放到环境变量或者配置文件里,避免敏感信息泄露。如果发送频率较高,建议对接专业的邮件推送服务,避免被邮箱服务商限制发送额度。
实际开发中,除了PHPMailer之外,还有SwiftMailer等第三方库也可以选择,不过PHPMailer的文档更完善,使用也更广泛,新手更容易上手。根据项目的实际需求选择合适的方案即可,大部分生产场景都推荐使用PHPMailer来实现邮件发送功能。