PHP 8.0+ 升级后，PEAR Mail 扩展因路径解析失效导致 send() 报 500 错误；根本原因是 include_once 'Net/SMTP.php' 等相对路径在新版 PHP 的严格文件加载机制下无法定位依赖，需统一改为基于 __DIR__ 的绝对路径引用。
php 8.0+ 升级后，pear mail 扩展因路径解析失效导致 `send()` 报 500 错误；根本原因是 `include_once 'net/smtp.php'` 等相对路径在新版 php 的严格文件加载机制下无法定位依赖，需统一改为基于 `__dir__` 的绝对路径引用。
当网站从 PHP 7.x 升级至 PHP 8.0 或 8.1 后，使用 PEAR Mail（配合 Net_SMTP）发送邮件时频繁出现 HTTP 500 内部服务器错误，且错误日志明确提示：
include_once(Net/SMTP.php): Failed to open stream: No such file or directory in /home/.../pear/share/pear/Mail/smtp.php
尽管 pear list 显示 pear/Net_SMTP 已安装（如 v1.10.0），但 PHP 8 引擎不再自动解析 'Net/SMTP.php' 这类无上下文的相对路径——它不再隐式依赖 include_path 查找子目录，尤其在 CGI/FPM 模式下，get_include_path() 可能未正确包含 PEAR 的安装根目录，导致 require_once 'Net/SMTP.php' 失败。
核心修复方案：手动修正 PEAR 包内硬编码的 include_once/require_once 路径，将其替换为基于 __DIR__ 的显式相对路径，确保加载位置与当前文件物理结构一致。
✅ 需修改的关键文件及内容（以典型 PEAR 安装路径为例）
假设 PEAR 安装在 /home/user/pear/share/pear/，请编辑以下文件：
立即学习“PHP免费学习笔记（深入）”；
1. Mail/smtp.php
// ❌ 原始（PHP 8 下失效） require_once 'PEAR.php'; require_once 'Net/SMTP.php'; // ✅ 替换为（使用 __DIR__ 构建绝对路径） require_once __DIR__ . '/../PEAR.php'; require_once __DIR__ . '/../Net/SMTP.php';
2. Net/SMTP.php（若存在同类问题）
// ❌ 原始 require_once 'PEAR.php'; require_once 'Socket.php'; // ✅ 替换为 require_once __DIR__ . '/../PEAR.php'; require_once __DIR__ . '/Socket.php';
3. Mail.php（主入口，检查依赖引入）
// 确保类似语句已修正 require_once __DIR__ . '/Mail/smtp.php'; // 而非 require_once 'Mail/smtp.php';
⚠️ 重要注意事项：
- 修改前务必备份原始文件（如 cp Mail/smtp.php Mail/smtp.php.bak）；
- 使用 find /path/to/pear -name "*.php" -exec grep -l "'Net/.*\.php\|'PEAR\.php" {} \; 快速定位所有含问题路径的文件；
- 若使用 Composer 管理依赖，强烈建议迁移到现代替代方案（如 phpmailer/phpmailer 或 symfony/mailer），PEAR 已于 2017 年停止维护，PHP 8 兼容性无官方保障；
- 修改后清除 OPCache（opcache_reset() 或重启 PHP-FPM），避免缓存旧字节码；
- 在 CLI 下运行 php -l /path/to/pear/Mail/smtp.php 验证语法正确性。
? 验证修复效果
修改完成后，执行简易测试脚本：
<?php
require_once '/home/user/pear/share/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' => 'me@example.com', 'Subject' => 'Test'];
$body = "Hello from PHP 8 + patched PEAR Mail!";
$result = $smtp->send('me@example.com', $headers, $body);
if (PEAR::isError($result)) {
echo "Send failed: " . $result->getMessage();
} else {
echo "Email sent successfully.";
}若输出 Email sent successfully.，则修复成功。
总结：PHP 8 对文件加载路径的语义更严格，PEAR 的历史写法已不适用。通过将 'Net/SMTP.php' 类路径替换为 __DIR__ . '/../Net/SMTP.php'，可精准锚定依赖位置，快速恢复邮件功能。但长期来看，淘汰 PEAR、采用活跃维护的邮件库，才是保障安全与兼容性的根本之道。
