提问人：Synchro 提问时间：8/29/2017 更新时间：11/18/2023 访问量：17938
我应该如何从 PHPMailer 5.2 升级到 6.0？
How should I upgrade from PHPMailer 5.2 to 6.0?
问：
我有一个脚本，目前使用最新版本的 PHPMailer 5.2.x。 PHPMailer 6.0 已经发布，但说它会破坏向后兼容性 - 我需要做什么才能升级？
<?php
require 'PHPMailerAutoload.php';
$mail = new PHPMailer;
//$mail->SMTPDebug = 3; // Enable verbose debug output
$mail->isSMTP(); // Set mailer to use SMTP
$mail->Host = 'smtp1.example.com;smtp2.example.com'; // Specify main and backup SMTP servers
$mail->SMTPAuth = true; // Enable SMTP authentication
$mail->Username = '[email protected]'; // SMTP username
$mail->Password = 'secret'; // SMTP password
$mail->SMTPSecure = 'tls'; // Enable TLS encryption, `ssl` also accepted
$mail->Port = 587; // TCP port to connect to
$mail->setFrom('[email protected]', 'Mailer');
$mail->addAddress('[email protected]', 'Joe User'); // Add a recipient
$mail->addAddress('[email protected]'); // Name is optional
$mail->addReplyTo('[email protected]', 'Information');
$mail->addCC('[email protected]');
$mail->addBCC('[email protected]');
$mail->addAttachment('/var/tmp/file.tar.gz'); // Add attachments
$mail->addAttachment('/tmp/image.jpg', 'new.jpg'); // Optional name
$mail->isHTML(true); // Set email format to HTML
$mail->Subject = 'Here is the subject';
$mail->Body = 'This is the HTML message body <b>in bold!</b>';
$mail->AltBody = 'This is the body in plain text for non-HTML mail clients';
if(!$mail->send()) {
echo 'Message could not be sent.';
echo 'Mailer Error: ' . $mail->ErrorInfo;
} else {
echo 'Message has been sent';
}
答：
18赞
Synchro
8/29/2017
#1
PHPMailer 6.0 中的主要变化：
- 需要 PHP 5.5 或更高版本（高于 5.0）
- 使用命名空间
- 类文件名和位置已更改
- 其他不相关的“额外”类已被删除
您可以在更新日志以及官方升级指南中阅读许多其他较小的更改，但这些更改最有可能影响您。
通过 composer 升级
要通过 composer 升级，请更改文件部分中的条目，然后运行：requirecomposer.jsoncomposer update phpmailer/phpmailer
"phpmailer/phpmailer": "~6.0"
这将只更新 PHPMailer，不会触及任何其他依赖项。
PHPMailer 使用 semver 版本编号策略，该模式将匹配 6.x 系列中的所有未来版本。这是对以前建议的模式的更改。~5.2
加载类文件
对于给出的示例脚本，我们主要需要更改类的加载方式。自动加载器不再存在，因此您要么需要使用 composer（在这种情况下，您不需要更改任何内容 - 标准 composer 自动加载器会自动完成），要么您需要自己加载类。
使用作曲家：
require 'vendor/autoload.php';
没有作曲家：
require 'src/PHPMailer.php';
require 'src/SMTP.php';
require 'src/Exception.php';
命名空间
PHPMailer 类位于命名空间中，因此您需要在该命名空间中工作，或者将它们导入到您自己的命名空间或全局命名空间中，例如：PHPMailer\PHPMailer
//Import PHPMailer classes into the global namespace
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\SMTP;
use PHPMailer\PHPMailer\Exception;
请注意，这些必须放在行之前。之后，您可以使用您习惯的原始类名：require
$mail = new PHPMailer;
或者，您可以直接引用其完全限定名称，而不使用语句，例如：use
$mail = new PHPMailer\PHPMailer\PHPMailer;
这个类最终以这个“三重名称”结束的原因是因为它是 PHPMailer 类，位于 PHPMailer 项目中，由 PHPMailer 组织拥有。这使得它与 PHPMailer 的其他分支、PHPMailer 组织的其他项目以及项目中的其他类区分开来。
异常
除了名称更改之外，异常的工作方式与以前的版本相同，但是在捕获时需要注意命名空间：phpmailerException
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\SMTP;
use PHPMailer\PHPMailer\Exception;
$mail = new PHPMailer(true);
try {
...
} catch Exception($e) {
//$e is an instance of PHPMailer\PHPMailer\Exception
} catch \Exception ($e) {
//$e is an instance of the PHP built-in Exception class
}
文档
所有文档和示例代码也已针对 6.0 进行了更新。最好的起点是自述文件或项目 wiki，您可以在其中找到指向广受欢迎的故障排除指南、大量教程和生成的 API 文档的链接。如果刚刚开始，请根据 examples 文件夹中提供的示例编写代码。
获取帮助
如果您在使用 PHPMailer 时遇到问题，首先在 Stack Overflow 上搜索您的特定错误消息，并在 PHPMailer 标签下搜索。如果您认为自己在 PHPMailer 中发现了一个错误，请在 github 项目上报告（提示 - 无法从 GoDaddy 服务器连接到邮件服务器不是 PHPMailer 错误！
评论