在使用PHPMailer实现表单邮件发送功能时,如果前端传入的邮箱为空或者不符合格式规范,很容易导致PHPMailer在初始化或者发送阶段触发致命错误,影响整个功能的可用性。要解决这个问题,需要从前端到后端建立完整的校验链路,同时在调用PHPMailer相关方法前做好参数检查。
常见错误触发场景
当表单提交的邮箱为空或者格式非法时,PHPMailer可能会出现以下几类错误:
- 未设置收件人邮箱直接调用
addAddress方法,触发参数缺失错误 - 邮箱格式不符合规范,PHPMailer内部校验失败抛出致命异常
- 邮箱包含特殊非法字符,SMTP服务器拒绝请求导致发送失败
前端基础校验
前端校验可以提前拦截大部分非法输入,减少后端不必要的请求处理压力,这里使用HTML5原生校验和JavaScript补充校验结合的方式:
<form id="mailForm" action="send_mail.php" method="post">
<label for="email">收件人邮箱:</label>
<input type="email" id="email" name="email" required
pattern="^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+.[a-zA-Z]{2,}$">
<button type="submit">发送邮件</button>
</form>
<script>
document.getElementById('mailForm').addEventListener('submit', function(e) {
const emailInput = document.getElementById('email');
const email = emailInput.value.trim();
// 再次校验空值和格式
if (!email) {
alert('请输入邮箱地址');
e.preventDefault();
return;
}
const emailReg = /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+.[a-zA-Z]{2,}$/;
if (!emailReg.test(email)) {
alert('请输入合法的邮箱地址');
e.preventDefault();
}
});
</script>
后端严格校验
前端校验可以被绕过,因此后端必须做严格的校验,这里使用PHP的过滤函数完成校验:
<?php
// 接收表单提交的邮箱
$email = isset($_POST['email']) ? trim($_POST['email']) : '';
// 第一步:检查是否为空
if (empty($email)) {
die('邮箱地址不能为空');
}
// 第二步:使用PHP内置函数校验邮箱格式
if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
die('请输入合法的邮箱地址');
}
// 第三步:可选,自定义更严格的格式校验
$emailReg = '/^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+.[a-zA-Z]{2,}$/';
if (!preg_match($emailReg, $email)) {
die('邮箱格式不符合要求');
}
?>
PHPMailer调用前预检查
在完成基础校验后,调用PHPMailer相关方法前还需要做参数检查,避免触发致命错误:
<?php
use PHPMailerPHPMailerPHPMailer;
use PHPMailerPHPMailerException;
require 'vendor/autoload.php';
// 假设已经通过上面的校验拿到合法的邮箱$email
$mail = new PHPMailer(true);
try {
// 服务器配置
$mail->isSMTP();
$mail->Host = 'smtp.ipipp.com';
$mail->SMTPAuth = true;
$mail->Username = 'your_email@ipipp.com';
$mail->Password = 'your_password';
$mail->SMTPSecure = 'tls';
$mail->Port = 587;
// 发件人
$mail->setFrom('your_email@ipipp.com', 'Mailer');
// 添加收件人前再次检查邮箱合法性
if (!empty($email) && filter_var($email, FILTER_VALIDATE_EMAIL)) {
$mail->addAddress($email);
} else {
throw new Exception('收件人邮箱不合法,无法添加');
}
// 邮件内容
$mail->isHTML(true);
$mail->Subject = '测试邮件';
$mail->Body = '这是一封测试邮件';
$mail->send();
echo '邮件发送成功';
} catch (Exception $e) {
echo '邮件发送失败,错误信息:' . $mail->ErrorInfo;
}
?>
完整校验流程总结
整个校验流程可以分为三个层级:
- 前端基础校验:拦截大部分非法输入,提升用户体验
- 后端参数校验:使用PHP内置函数和正则校验,确保输入合法
- PHPMailer调用前校验:避免空值或非法值传入PHPMailer方法,触发致命错误
按照这个流程处理,就可以完全避免空邮箱或者非法邮箱导致的PHPMailer致命错误,保障邮件发送功能的稳定性。