本文旨在解决使用pear mail库通过smtp发送邮件时，抄送（cc）和密送（bcc）收件人无法收到邮件的问题。核心解决方案在于，除了在邮件头部（headers）中正确设置cc/bcc字段外，所有预期的收件人（包括主收件人、抄送和密送）都必须作为第一个参数传递给`mail::send()`方法，以确保smtp服务器能够正确处理所有收件地址。
在使用PHP的PEAR Mail库通过SMTP发送电子邮件时，开发者可能会遇到一个常见的问题：即使在邮件头部（headers）中正确设置了抄送（CC）或密送（BCC）地址，这些收件人却无法收到邮件，而主收件人（To）却能正常接收。这通常不是库的bug，而是对SMTP协议和PEAR Mail send() 方法工作原理的误解。
问题根源分析
PEAR Mail库的Mail::send()方法在通过SMTP发送邮件时，其第一个参数并不仅仅是“主收件人”，而是SMTP服务器实际需要处理的所有收件人列表（即SMTP信封上的收件人）。邮件头部中的To、Cc、Bcc字段是邮件客户端用于显示给用户的信息，它们是邮件内容的一部分，而不是SMTP传输过程中直接用于路由的指令。
当您只将主收件人（$to）传递给send()方法时，SMTP服务器只会尝试将邮件投递给$to中列出的地址。即使邮件头部包含Cc或Bcc字段，SMTP服务器在接收到邮件数据后，并不会主动解析这些头部信息来决定额外的投递目标。因此，要确保CC和BCC收件人收到邮件，它们必须在SMTP事务的初始阶段就被告知给服务器。
解决方案
解决此问题的关键在于，将所有预期的收件人（包括主收件人、抄送和密送）合并成一个字符串，并将其作为Mail::send()方法的第一个参数传递。同时，邮件头部中的To、Cc和Bcc字段也应正确设置，以确保邮件客户端能够正确显示这些信息。
核心原则：
需要创建、读取、编辑或处理 Word 文档（.docx / .dotx）时使用。触发词：'Word'、'word 文档'、'.docx'、'生成报告'、'制作合同/简历/方案/说明书'、'提取 word 内容'、'在文档里查找替换'、'给文档加页眉页脚/目录/表格'。也用于把任意内容排版成一份正式的 Word 文件。不要用它处理 PDF、Excel 或无关编程任务。中文创作场景尤其适合：小说大纲稿、投稿文档、合同、简历、工作总结。
- SMTP信封收件人（send()方法的第一个参数）：必须包含所有实际需要接收邮件的邮箱地址，无论是主收件人、抄送还是密送。
- 邮件头部（$headers数组）：To、Cc、Bcc字段应根据邮件的语义正确设置，它们是邮件内容的组成部分。
示例代码
以下是一个完整的PEAR Mail SMTP发送邮件示例，演示了如何正确处理CC和BCC收件人：
<?php
require_once 'Mail.php'; // 确保PEAR Mail库已安装并可访问
// 邮件配置
$host = 'smtp.your-email-provider.com'; // SMTP服务器地址
$port = 587; // SMTP端口，通常是587或465（SSL）
$username = 'your_smtp_username@example.com'; // SMTP认证用户名
$password = 'your_smtp_password'; // SMTP认证密码
// 邮件内容
$from = 'sender@example.com'; // 发件人邮箱
$to = 'primary_recipient@example.com'; // 主收件人邮箱
$cc = 'cc_recipient@example.com'; // 抄送收件人邮箱
$bcc = 'bcc_recipient@example.com'; // 密送收件人邮箱 (注意：BCC地址不会出现在邮件头部)
$subject = '测试PEAR Mail CC/BCC功能';
$message = '<html><body><h1>你好！</h1><p>这是一封测试邮件，用于验证PEAR Mail的CC和BCC功能。</p></body></html>';
// 1. 构建所有实际需要接收邮件的收件人列表
// 这些地址将作为SMTP信封的收件人，确保所有人都收到邮件。
// 多个地址应使用逗号分隔。
$recipients = $to;
if (!empty($cc)) {
$recipients .= ', ' . $cc;
}
if (!empty($bcc)) {
$recipients .= ', ' . $bcc;
}
// 2. 构建邮件头部
$headers = array (
'From' => $from,
'To' => $to, // 邮件头部To字段
'Cc' => $cc, // 邮件头部Cc字段
'Subject' => $subject,
'Reply-To' => $from,
'X-Mailer' => 'PHP/' . phpversion(),
'MIME-Version' => '1.0',
'Content-Type' => 'text/html; charset=UTF-8' // 建议使用UTF-8编码
);
// 3. 创建SMTP对象
$smtp = Mail::factory('smtp', array (
'host' => $host,
'port' => $port,
'auth' => true,
'username' => $username,
'password' => $password
));
// 4. 发送邮件
// 注意：第一个参数是合并后的所有收件人列表 $recipients
$result = $smtp->send($recipients, $headers, $message);
// 5. 检查发送结果
if (PEAR::isError($result)) {
echo "邮件发送失败：" . $result->getMessage() . "\n";
} else {
echo "邮件已成功发送。\n";
}
?>在上述代码中，$recipients变量包含了$to、$cc和$bcc的所有邮箱地址。这个合并后的字符串被传递给$smtp->send()方法的第一个参数。这样，SMTP服务器就会知道需要将邮件投递给所有这些地址。同时，$headers数组中的To和Cc字段也正确设置，确保邮件客户端在显示邮件时能够展示正确的收件人信息。Bcc地址不会出现在$headers中，因为这是密送的特性。
注意事项
- 收件人格式：$recipients字符串中的多个邮箱地址必须使用逗号（,）分隔。
- 字符编码：建议在Content-Type头部中使用charset=UTF-8，以避免中文乱码问题。
- 错误处理：始终检查send()方法的返回值。如果返回PEAR_Error对象，表示发送过程中出现了问题，应打印错误信息进行调试。
- BCC的特殊性：密送（BCC）地址不会出现在邮件头部中。这意味着收件人无法看到其他BCC收件人的信息。但在$recipients中包含BCC地址是必要的，以便SMTP服务器能够将其投递给这些密送收件人。
- SMTP服务器要求：某些SMTP服务器可能对单个邮件的收件人数量有限制。如果需要发送给大量收件人，可能需要分批发送或考虑使用专业的邮件发送服务。
- 安全性：在实际应用中，避免在代码中硬编码敏感信息（如SMTP用户名和密码），应从配置文件或环境变量中读取。
总结
通过理解PEAR Mail send()方法与SMTP协议的交互方式，我们可以明确，要确保抄送（CC）和密送（BCC）收件人能够收到邮件，就必须将所有目标邮箱地址（包括主收件人、CC和BCC）合并成一个字符串，并作为Mail::send()方法的第一个参数传递。同时，邮件头部也应正确设置To和Cc字段。遵循这一原则，将能有效解决PEAR Mail发送CC/BCC邮件不生效的问题。
