Swiftmailer是一个类似PHPMailer邮件发送组件,它也支持HTML格式、附件发送,但它发送效率相当高,成功率也非常高,很多PHP框架都集成了Swiftmailer。

Swiftmailer需要PHP 7.0或更高版本,(proc_*函数可用。)

安装

我们使用Composer来安装Swiftmailer:

composer require "swiftmailer/swiftmailer:^6.0"

基本使用

只需填写邮箱服务器相关配置,然后填写邮件标题、发送对象和邮件内容,运行即可完成发送邮件任务:

require_once '/path/to/vendor/autoload.php';

$transport = (new Swift_SmtpTransport('smtp.163.com', 25)) // 邮箱服务器
  ->setUsername('your username')  // 邮箱用户名
  ->setPassword('your password')   // 邮箱密码,有的邮件服务器是授权码
;

$mailer = new Swift_Mailer($transport);

$message = (new Swift_Message('Wonderful Subject')) // 邮件标题
  ->setFrom(['john@doe.com' => 'John Doe']) // 发送者
  ->setTo(['receiver@domain.org', 'other@domain.org' => 'A name']) //发送对象,数组形式支持多个
  ->setBody('Here is the message itself') //邮件内容
  ;

$result = $mailer->send($message);

如果发送成功,会返回$result的值为1,即true。

高级应用

发送邮件时最关键的是创建消息体,在Swift Mailer中创建消息是通过使用库提供的各种MIME实体完成的,因此我们不需要花太多时间去了解如何处理MIME实体,只需拿来使用即可。

Swift Mailer提供了创建邮件消息的一系列方法,下面列举我们常用到的一些方法:

setSubject():邮件主题

setFrom():发件人地址,数组形式,可以是多个发件人

setTo():收件人地址,数组形式,可以是多个收件人

setBody():邮件内容

addPart():邮件内容指定输出类型,支持html内容输出

attach():添加附件

setCc():抄送,支持多个邮箱地址

setBcc():密送,支持多个邮箱地址

常见问题

1. 报错信息:Fatal error: Uncaught Swift_TransportException: Failed to authenticate on SMTP server with username xxx…

很显然是邮件服务的账号密码不正确导致验证不能通过。目前163免费邮和QQ邮箱等提供给第三方客户端使用的SMTP/POP等服务需要设置一个授权码,具体可以到邮箱里设置。然后将正确的邮箱账号和授权码配置到Swift Mailer中即可。

2. 报错信息:PHP Fatal error: Uncaught Swift_TransportException: Connection could not be established with host smtp.163.com

不能连接上邮件服务器。如果出现这个情况,建议尝试改成ssl协议。笔者在本地使用官方的25端口发送邮件一切正常,到放到公网服务器上就提示如上错误信息了,折腾了好久,改下协议和端口,成功了:

$transport = (new Swift_SmtpTransport('ssl://smtp.163.com', 465))

更多有关Swift Mailer的使用请参考官网:https://swiftmailer.symfony.com/