PHP 8.0/8.1 升级后，PEAR Mail 因路径解析失效导致 send() 报 500 错误；根本原因是 PHP 8+ 废弃了相对路径自动查找机制，需将 'Net/SMTP.php' 等动态 include 替换为基于 __DIR__ 的显式绝对路径。
php 8.0/8.1 升级后，pear mail 因路径解析失效导致 `send()` 报 500 错误；根本原因是 php 8+ 废弃了相对路径自动查找机制，需将 `'net/smtp.php'` 等动态 include 替换为基于 `__dir__` 的显式绝对路径。
PEAR Mail 是一个经典的 PHP 邮件发送组件，依赖 Net_SMTP 和 PEAR 核心类库。但在 PHP 8.0 及更高版本中，其原有设计存在严重兼容性问题：PHP 8+ 移除了对 include_path 中相对路径（如 'Net/SMTP.php'）的隐式解析支持，且默认禁用 allow_url_include，导致 include_once 'Net/SMTP.php' 类语句直接失败，并抛出 Failed to open stream: No such file or directory —— 这正是你日志中看到的错误根源。
值得注意的是，该问题并非因 Net_SMTP 未安装（pear install Net_SMTP 显示已存在），而是 PEAR 自身的内部引用逻辑失效。关键文件位于 PEAR 安装目录下的 Mail/smtp.php、Net/SMTP.php、PEAR.php 等，它们仍使用过时的字符串路径写法，无法适配 PHP 8 的严格加载策略。
✅ 正确修复方式：批量替换为 __DIR__ 绝对路径
请按以下步骤修改 PEAR 的核心文件（路径通常为 /usr/share/php/ 或 /home/youruser/pear/share/pear/，可通过 pear config-show | grep php_dir 确认）：
-
修改 Mail/smtp.php（核心入口）
将：include_once 'Net/SMTP.php'; require_once 'PEAR.php';
替换为：
立即学习“PHP免费学习笔记（深入）”；
include_once __DIR__ . '/../Net/SMTP.php'; require_once __DIR__ . '/../PEAR.php';
-
修改 Net/SMTP.php（SMTP 实现层）
查找所有类似 require_once 'PEAR.php'; 或 include_once 'Socket.php';，统一改为：require_once __DIR__ . '/PEAR.php'; include_once __DIR__ . '/Socket.php';
-
检查 Mail.php 和 PEAR.php（如有 require 同级依赖）
同样应用 __DIR__ 前缀，例如：require_once __DIR__ . '/PEAR/Exception.php';
⚠️ 重要注意事项
- 修改前务必备份原始文件（如 cp smtp.php smtp.php.bak）；
- 若使用 cPanel/WHM 或共享主机，请确认是否有权限写入 PEAR 目录；若无权限，建议迁移到现代替代方案（见下文）；
- 不要尝试通过 set_include_path() 临时修复 —— PHP 8 已不推荐且不可靠；
- 所有路径必须使用正斜杠 /（Windows 环境下 PHP 也兼容），避免反斜杠引发转义问题。
? 验证修复效果
修改完成后，执行最小化测试脚本：
<?php
require_once '/path/to/your/pear/Mail.php';
$smtp = Mail::factory('smtp', [
'host' => 'smtp.example.com',
'port' => 587,
'auth' => true,
'username' => 'user@example.com',
'password' => 'app_password'
]);
$headers = ['From' => 'test@example.com', 'To' => 'you@example.com', 'Subject' => 'Test'];
$body = 'This is a PHP 8-compatible PEAR Mail test.';
$result = $smtp->send('you@example.com', $headers, $body);
if (PEAR::isError($result)) {
echo "Error: " . $result->getMessage();
} else {
echo "Email sent successfully.";
}若返回 "Email sent successfully." 且 HTTP 状态码为 200，则修复成功。
? 替代建议：面向未来的迁移方案
PEAR 已于 2017 年正式停止维护，PHP 8+ 下持续打补丁存在长期风险。我们强烈建议在生产环境中逐步迁移到更活跃、原生支持 PSR-4 和 Composer 的现代方案：
- ✅ PHPMailer：轻量、文档完善、支持 SMTP/SMTPS/POP-before-SMTP；
- ✅ Symfony Mailer：企业级、可扩展、内置重试与队列集成；
- ✅ [Swift Mailer（已归档）→ 推荐改用 Symfony Mailer：Swift Mailer 已停止维护，Symfony Mailer 是其官方继任者。
使用 Composer 安装 PHPMailer 示例：
composer require phpmailer/phpmailer
use PHPMailer\PHPMailer\PHPMailer;
$mail = new PHPMailer(true);
$mail->isSMTP();
$mail->Host = 'smtp.example.com';
$mail->SMTPAuth = true;
$mail->Username = 'user@example.com';
$mail->Password = 'app_pass';
$mail->setFrom('from@example.com');
$mail->addAddress('to@example.com');
$mail->Subject = 'Hello from PHP 8!';
$mail->Body = 'This works out of the box.';
$mail->send();综上，__DIR__ 路径重写是 PHP 8 下 PEAR Mail 的快速止血方案，但长远来看，拥抱 Composer 生态与现代邮件库，才是保障稳定性与安全性的正确路径。
