我有一个脚本当前使用最新版本的 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 = 'user@example.com';                 // 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('from@example.com', 'Mailer');
$mail->addAddress('joe@example.net', 'Joe User');     // Add a recipient
$mail->addAddress('ellen@example.com');               // Name is optional
$mail->addReplyTo('info@example.com', 'Information');
$mail->addCC('cc@example.com');
$mail->addBCC('bcc@example.com');

$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';
}

最佳答案

PHPMailer 中发生的主要变化6.0:

• 需要 PHP 5.5 或更高版本(从 5.0 开始)
• 使用命名空间
• 类文件名和位置已更改
• 已删除其他不相关的“extras”类

您可以在 the changelog 中阅读许多其他较小的更改, 还有 the official upgrade guide ，但这些是最有可能影响您的。

通过 Composer 升级

要通过 composer 升级，请更改 composer.json 文件的 require 部分中的条目，然后运行 ​​composer update phpmailer/phpmailer:

"phpmailer/phpmailer": "~6.0"

这将仅更新 PHPMailer，不会触及任何其他依赖项。

PHPMailer 使用 semver版本编号策略，并且该模式将匹配 6.x 系列中的所有 future 版本。这是对之前推荐的 ~5.2 模式的更改。

加载类文件

对于给出的示例脚本，我们主要需要改变类的加载方式。自动加载器不再存在，因此您要么需要使用 composer(在这种情况下您不需要更改任何内容 - 标准的 composer 自动加载器会自动完成)，要么您需要自己加载类。

Composer :

require 'vendor/autoload.php';

没有 Composer :

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 组织的其他项目以及项目中的其他类区分开来。

异常(exception)情况

除了 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 进行了更新。最好的起点是 the readme file或 the project wiki ，您可以在其中找到广受欢迎的 troubleshooting guide 的链接、大量教程和 generated API documentation .如果您刚刚起步，请将您的代码基于 the examples folder 中提供的示例。 .

获得帮助

如果您在使用 PHPMailer 时遇到问题，请首先在 Stack Overflow 上搜索您的特定错误消息，然后在 the PHPMailer tag 下搜索.如果您认为您在 PHPMailer 中发现了错误，请在 the github project 上报告它(提示 - 无法从您的 GoDaddy 服务器连接到邮件服务器不是 PHPMailer 错误!)

关于php - 我应该如何从 PHPMailer 5.2 升级到 6.0？，我们在Stack Overflow上找到一个类似的问题： https://stackoverflow.com/questions/45940509/