本教程详细阐述了如何利用PHPMailer库，从PHP配置文件中读取并向多个电子邮件地址发送邮件。针对PHPMailer默认不支持直接解析多地址字符串的问题，文章提供了基于preg_split函数解析地址列表的解决方案，并进一步介绍了通过自定义函数进行邮件地址清洗、去重和有效性验证的最佳实践，确保邮件发送的健壮性和准确性，实现配置的灵活性和代码的简洁性。
在构建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}"); }
上述代码中：
- preg_split(‘#[s;,]+#’, $config[‘sendTo’], -1, PREG_SPLIT_NO_EMPTY)：
- #[s;,]+# 是正则表达式，匹配一个或多个空格（s）、逗号（,）或分号（;）。
- -1 表示返回所有匹配结果。
- PREG_SPLIT_NO_EMPTY 标志确保结果数组中不包含空字符串，这在处理连续分隔符时非常有用。
- 通过foreach循环遍历解析出的每个地址，并调用$mail->addAddress()将其逐一添加到收件人列表中。
- 对addCC和addBCC也做了类似的处理，以支持配置中包含多个抄送/密送地址。
增强与验证：优化收件人地址列表
直接解析字符串可能导致一些问题，例如包含空白字符、重复地址或格式不正确的地址。为了提高邮件发送的健壮性，建议对解析出的地址进行进一步的清洗和验证。可以封装一个辅助函数来完成这些任务：
<?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 值（即无效地址）
评论（已关闭）
评论已关闭