PHPMailer是PHP开发中常用的邮件发送扩展库，很多开发者在初次集成使用时，经常会遇到文件未找到的异常，这类问题本质上大多和文件路径的引入方式有关，只要掌握正确的路径写法就能快速解决。
常见的文件未找到异常原因
出现文件未找到异常时，首先要排查几个常见的问题点：
- 引入PHPMailer时的路径和实际文件存放位置不匹配
- 使用了相对路径但当前脚本的工作目录和预期不一致
- 文件名大小写错误，Linux系统下文件名大小写敏感
- 没有正确下载PHPMailer库文件，缺少核心文件
PHP文件路径的两种常用写法
相对路径
相对路径是相对于当前执行脚本所在目录的路径，比如当前脚本在/var/www/project/目录下，引入同目录下的文件可以直接写文件名，引入子目录下的文件用./子目录/文件名的写法。
绝对路径
绝对路径是从服务器根目录开始的完整路径，也可以使用__DIR__魔术常量获取当前脚本所在目录，这是更推荐的做法，因为不受脚本执行位置的影响。
PHPMailer正确的引入方式
首先确保已经从官方渠道下载了PHPMailer的完整库文件，解压后放到项目目录中，比如放到项目的vendor/PHPMailer/目录下。
使用绝对路径引入的示例代码如下：
<?php
// 使用__DIR__获取当前脚本所在目录，拼接PHPMailer的文件路径
require_once __DIR__ . '/vendor/PHPMailer/src/PHPMailer.php';
require_once __DIR__ . '/vendor/PHPMailer/src/SMTP.php';
require_once __DIR__ . '/vendor/PHPMailer/src/Exception.php';
// 引入命名空间
use PHPMailerPHPMailerPHPMailer;
use PHPMailerPHPMailerSMTP;
use PHPMailerPHPMailerException;
// 初始化PHPMailer实例
$mail = new PHPMailer(true);
try {
// 服务器配置
$mail->SMTPDebug = SMTP::DEBUG_SERVER;
$mail->isSMTP();
$mail->Host = 'smtp.ipipp.com';
$mail->SMTPAuth = true;
$mail->Username = 'test@ipipp.com';
$mail->Password = 'password';
$mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS;
$mail->Port = 465;
// 收件人配置
$mail->setFrom('test@ipipp.com', 'Mailer');
$mail->addAddress('user@ipipp.com', 'User');
// 邮件内容
$mail->isHTML(true);
$mail->Subject = '测试邮件';
$mail->Body = '这是一封测试邮件';
$mail->send();
echo '邮件发送成功';
} catch (Exception $e) {
echo "邮件发送失败，错误信息: {$mail->ErrorInfo}";
}
?>
路径问题排查方法
如果还是出现文件未找到的异常，可以用以下方法排查：
- 用
echo __DIR__;输出当前脚本所在目录，确认路径拼接是否正确 - 用
file_exists(路径)函数检查文件是否存在，返回true说明路径正确 - 检查PHPMailer的文件名是否正确，比如是否是
PHPMailer.php而不是phpmailer.php - 确认引入语句的路径分隔符使用斜杠
/，Windows和Linux系统都兼容这个写法
注意事项
如果使用Composer安装PHPMailer，只需要引入Composer生成的自动加载文件即可，不需要手动引入各个类文件，示例如下：
<?php require_once __DIR__ . '/vendor/autoload.php'; use PHPMailerPHPMailerPHPMailer; use PHPMailerPHPMailerException; // 后续初始化和使用逻辑和前面一致 ?>
这种方式的路径管理更规范，也能避免手动引入带来的路径错误问题。