PHP 8 升级后 PEAR Mail SMTP 发送失败的修复指南

2次阅读

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 安装在 /home/user/pear/share/pear/，请编辑以下文件：

立即学习 “PHP 免费学习笔记（深入）”；

// ❌ 原始（PHP 8 下失效）require_once 'PEAR.php'; require_once 'Net/SMTP.php';  // ✅ 替换为（使用 __DIR__ 构建绝对路径）require_once __DIR__ . '/../PEAR.php'; require_once __DIR__ . '/../Net/SMTP.php';

// ❌ 原始 require_once 'PEAR.php'; require_once 'Socket.php';  // ✅ 替换为 require_once __DIR__ . '/../PEAR.php'; require_once __DIR__ . '/Socket.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、采用活跃维护的邮件库，才是保障安全与兼容性的根本之道。

发表于：后端

近一天内