使用PEAR库发送SMTP邮件报错，请求问题排查

看起来你在用PEAR的Mail和Mail_mime库发送带附件的HTML邮件时卡壳了，而且代码还没写完——先帮你梳理下常见的坑，再给个完整的可运行方案吧！

首先看你给出的代码片段，有几个明显的缺失和需要注意的点：

• 代码截断在了$mime->，缺少添加附件的关键逻辑
• 完全没有初始化SMTP连接的代码，这是发送邮件的核心环节
• 变量$filepath和$filename需要确保路径正确，否则附件会找不到

下面分情况说下常见报错原因和解决办法：

1. PEAR库安装或路径问题 #

• 先确认include的路径是否正确，你写的../include/pear/要确保对应目录下确实有Mail.php和Mail/mime.php
• 建议用require_once替代include，这样如果文件找不到会直接抛出错误，方便排查
• 执行命令确认库已安装：

  pear list
  # 如果没安装，执行：
  pear install Mail Mail_Mime
  

2. 缺失SMTP配置（最常见的问题） #

你的代码里完全没写SMTP连接的部分，这是必须的！要指定SMTP服务器、端口、认证信息（如果需要）。比如用企业邮箱或第三方SMTP服务，都需要配置这些参数。

3. 附件处理错误 #

添加附件必须调用$mime->addAttachment()方法，还要确保文件路径正确、PHP有读取权限。

完整的可运行示例代码 #

把下面的代码替换你的片段，记得修改配置参数：

<?php
// 确保PEAR库路径正确，也可以在php.ini里设置include_path
require_once '../include/pear/Mail.php';
require_once '../include/pear/Mail/mime.php';

// 配置邮件基本信息
$from = "myemailaddress@domail.com";
$to = "myfriendemailaddress@domail.com";
$subject = 'Weekly Summary';
$filepath = '/path/to/your/attachments/'; // 替换成实际附件目录
$filename = 'weekly_report.pdf'; // 替换成实际附件文件名

// 原始邮件头
$headers = array(
    'From' => $from,
    'To' => $to,
    'Subject' => $subject
);

// 邮件内容：同时准备HTML和纯文本版本（兼容不同邮箱客户端）
$html_body = '<html><body>Hello,<br/>Please find the weekly summary attached.</body></html>';
$text_body = 'Hello, Please find the weekly summary attached.';

$crlf = "\n"; // 换行符，保持跨平台兼容
$mime = new Mail_mime($crlf);

// 设置邮件内容
$mime->setHTMLBody($html_body);
$mime->setTXTBody($text_body);

// 添加附件（关键步骤）
$full_file_path = $filepath . $filename;
if (file_exists($full_file_path)) {
    // 参数说明：文件路径、MIME类型、显示文件名、是否内联、编码方式
    $mime->addAttachment($full_file_path, 'application/pdf', $filename, false, 'base64');
} else {
    die("Error: 附件文件不存在 -> $full_file_path");
}

// 生成最终的邮件头和邮件体（合并MIME自动生成的头信息）
$final_headers = $mime->headers($headers);
$final_body = $mime->get();

// 初始化SMTP客户端（这里是核心！一定要配置正确）
$smtp_config = array(
    'host' => 'smtp.yourdomain.com', // 替换成你的SMTP服务器，比如smtp.gmail.com
    'port' => 587, // 常用端口：25（无加密）、587（TLS）、465（SSL）
    'auth' => true, // 如果SMTP需要账号密码认证，设为true
    'username' => 'your_smtp_username', // SMTP登录账号
    'password' => 'your_smtp_password', // SMTP登录密码
    'debug' => false // 开启后会输出SMTP交互日志，方便排查错误
);

// 创建SMTP邮件实例
$mailer =& Mail::factory('smtp', $smtp_config);

// 发送邮件并检查结果
$send_status = $mailer->send($to, $final_headers, $final_body);

if (PEAR::isError($send_status)) {
    echo "邮件发送失败：" . $send_status->getMessage();
} else {
    echo "邮件发送成功！";
}
?>

额外排查技巧 #

• 开启debug模式：把$smtp_config里的debug设为true，可以看到详细的SMTP交互过程，快速定位是认证失败、服务器连接不上还是内容格式问题
• 检查PHP错误日志：看看有没有文件权限不足、端口被防火墙拦截的报错
• 确保PHP的openssl扩展已开启（如果用TLS/SSL连接SMTP）

内容的提问来源于stack exchange，提问作者hetal gohel