
在构建Web应用程序时,将邮件发送的配置信息(如SMTP服务器、发件人、收件人等)集中存储在一个独立的配置文件中是一种常见的最佳实践。这不仅提高了代码的可维护性,也方便了客户或非技术人员根据需求修改配置。然而,当需要向多个收件人发送邮件,并且这些收件人地址以逗号、分号或空格分隔的形式存储在配置文件中的单个字符串时,PHPMailer的addAddress()方法会遇到挑战,因为它期望每次只添加一个有效的电子邮件地址。
PHPMailer的addAddress()方法设计用于接收单个电子邮件地址作为参数。如果尝试将一个包含多个地址的字符串(例如"recipient1@example.com, recipient2@example.com")直接传递给它,PHPMailer会抛出“无效电子邮件地址”的错误。
为了解决这个问题,我们需要在将地址传递给addAddress()之前,将配置文件中的多地址字符串解析成独立的电子邮件地址数组。PHP的preg_split()函数是实现这一目标的理想工具,它允许我们使用正则表达式来拆分字符串。
假设您的config.php文件中的sendTo配置项如下:
立即学习“PHP免费学习笔记(深入)”;
<?php
$config = [
// ... 其他配置
"sendTo" => "recipient1@example.com, recipient2@example.com; recipient3@example.com",
"sendToCC" => "cc1@example.com", // 可选的抄送地址
"sendToBCC" => "bcc1@example.com", // 可选的密送地址
"from" => "sender@example.com",
"fromName" => "Contact Form"
// ...
];在邮件发送脚本中,您可以这样处理$config['sendTo']:
<?php
// 引入 PHPMailer 类和配置
use PHPMailerPHPMailerPHPMailer;
use PHPMailerPHPMailerException;
// 假设 config.php 已经被包含进来,并且 $config 数组可用
// require_once 'config.php';
// 实例化 PHPMailer
$mail = new PHPMailer(true); // 启用异常处理
try {
// 服务器配置 (根据您的 config.php 进行填充)
$mail->isSMTP(); // 使用SMTP
$mail->Host = $config['host']; // SMTP 服务器地址
$mail->SMTPAuth = true; // 启用SMTP认证
$mail->Username = $config['username']; // SMTP 用户名
$mail->Password = $config['password']; // SMTP 密码
$mail->SMTPSecure = $config['secure']; // 启用TLS或SSL加密
$mail->Port = $config['port']; // TCP 端口
// 设置发件人
$mail->setFrom($config['from'], $config['fromName']);
// 解析并添加多个主要收件人
// 使用正则表达式 '[\s;,]+' 来匹配一个或多个空格、逗号或分号作为分隔符
$recipientAddresses = preg_split('#[\s;,]+#', $config['sendTo'], -1, PREG_SPLIT_NO_EMPTY);
foreach ($recipientAddresses as $address) {
try {
$mail->addAddress($address);
} catch (Exception $e) {
// 捕获并处理无效地址的异常,例如记录日志
error_log("无效主要收件人地址: {$address} - " . $e->getMessage());
}
}
// 添加抄送地址 (如果存在)
if (!empty($config['sendToCC'])) {
$ccAddresses = preg_split('#[\s;,]+#', $config['sendToCC'], -1, PREG_SPLIT_NO_EMPTY);
foreach ($ccAddresses as $ccAddr) {
try {
$mail->addCC($ccAddr);
} catch (Exception $e) {
error_log("无效抄送地址: {$ccAddr} - " . $e->getMessage());
}
}
}
// 添加密送地址 (如果存在)
if (!empty($config['sendToBCC'])) {
$bccAddresses = preg_split('#[\s;,]+#', $config['sendToBCC'], -1, PREG_SPLIT_NO_EMPTY);
foreach ($bccAddresses as $bccAddr) {
try {
$mail->addBCC($bccAddr);
} catch (Exception $e) {
error_log("无效密送地址: {$bccAddr} - " . $e->getMessage());
}
}
}
// 如果表单有用户输入的邮箱,也添加进去(假设 $_POST['email'] 存在且已通过初步验证)
if (isset($_POST['email'])) {
$userEmail = filter_var($_POST['email'], FILTER_VALIDATE_EMAIL);
if ($userEmail) {
try {
$mail->addAddress($userEmail);
} catch (Exception $e) {
error_log("添加用户输入邮箱失败: {$userEmail} - " . $e->getMessage());
}
} else {
error_log("用户输入邮箱格式无效: {$_POST['email']}");
}
}
// 邮件内容
$mail->isHTML(true); // 设置邮件格式为HTML
$mail->Subject = '这是一封测试邮件';
$mail->Body = '<b>邮件内容</b>,可以包含HTML标签!';
$mail->AltBody = '这是一个纯文本的邮件内容,当HTML内容无法显示时使用。';
// 发送邮件
$mail->send();
echo '邮件已成功发送!';
} catch (Exception $e) {
echo "邮件发送失败。错误信息: {$mail->ErrorInfo}";
// 详细错误信息可用于调试
error_log("PHPMailer Error: {$mail->ErrorInfo}");
}上述代码中:
直接解析字符串可能导致一些问题,例如包含空白字符、重复地址或格式不正确的地址。为了提高邮件发送的健壮性,建议对解析出的地址进行进一步的清洗和验证。可以封装一个辅助函数来完成这些任务:
<?php
/**
* 清洗并验证电子邮件地址数组
*
* @param array|string $emails 待处理的电子邮件地址,可以是字符串或数组
* @return array 经过验证和清洗后的有效电子邮件地址数组
*/
function filterMail($emails) {
// 如果是字符串,先按常见分隔符进行初步分割
if (is_string($emails)) {
$emails = preg_split('#[\s;,]+#', $emails, -1, PREG_SPLIT_NO_EMPTY);
}
// 确保是数组
if (!is_array($emails)) {
return [];
}
// 1. 移除每个地址两端的空白字符
$emails = array_map('trim', $emails);
// 2. 移除空字符串(例如,trim后变为空的)
$emails = array_filter($emails);
// 3. 移除重复的电子邮件地址
$emails = array_unique($emails);
// 4. 使用 filter_var 验证每个地址的格式
$emails = array_map(
function ($email) {
// filter_var 返回有效的邮箱地址或 false
return filter_var($email, FILTER_VALIDATE_EMAIL) ? $email : null;
},
$emails
);
// 5. 再次移除所有 null 值(即无效地址)以上就是PHPMailer:从配置文件灵活管理并发送邮件至多个收件人的详细内容,更多请关注php中文网其它相关文章!
PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号