easyswoole / smtp
EasySwoole mailer component
Installs: 12 554
Dependents: 1
Suggesters: 0
Security: 0
Stars: 10
Watchers: 3
Forks: 7
Open Issues: 5
Requires
- php: >=7.1.0
- ext-mbstring: *
- ext-swoole: >=4.4.4
Requires (Dev)
README
介绍
电子邮件是—种用电子手段提供信息交换的通信方式,是互联网应用最广的服务。电子邮件几乎是每个web应用程序不可或缺的,无论是时事通讯还是订单确认。本库采用swoole协程客户端实现了电子邮件的发送
安装
composer require easyswoole/smtp
用法
基础配置
$mail = new \EasySwoole\Smtp\Mailer(false);
参数:
$enableException
是否启用异常 默认false
设置超时
/** @var \EasySwoole\Smtp\Mailer $mail **/ $mail->setTimeout(5);
设置最大数据包大小
/** @var \EasySwoole\Smtp\Mailer $mail **/ $mail->setMaxPackage(1024 * 1024 * 2);
设置Host
/** @var \EasySwoole\Smtp\Mailer $mail **/ $mail->setHost("smtp.qq.com");
设置Port
/** @var \EasySwoole\Smtp\Mailer $mail **/ $mail->setPort(465);
设置Ssl
/** @var \EasySwoole\Smtp\Mailer $mail **/ $mail->setSsl(true);
设置用户名及密码
/** @var \EasySwoole\Smtp\Mailer $mail **/ $mail->setUsername("xxx@qq.com"); $mail->setPassword("xxxxx");
设置发件人地址
可选方法 默认用户名
/** @var \EasySwoole\Smtp\Mailer $mail **/ $mail->setFrom("xxx@qq.com");
参数:
$address
发件人地址$name
设置昵称 可选参数
设置收件人地址
/** @var \EasySwoole\Smtp\Mailer $mail **/ $mail->addAddress("xxx@qq.com");
参数:
$address
收件人地址$name
设置昵称 可选参数
设置回复地址
可选方法 默认发件人地址
/** @var \EasySwoole\Smtp\Mailer $mail **/ $mail->setReplyTo("xxx@qq.com");
参数:
$address
收件人地址$name
设置昵称 可选参数
发送
发送文本
/** @var \EasySwoole\Smtp\Mailer $mail **/ $text = new \EasySwoole\Smtp\Request\Text(); $text->setSubject("Smtp Test Title"); $text->setBody("Smtp Test Body"); // 添加附件 可选 $text->addAttachment(__FILE__,'附件重命名'); // 发送 $mail->send($text);
发送Html
/** @var \EasySwoole\Smtp\Mailer $mail **/ $text = new \EasySwoole\Smtp\Request\Html(); $text->setSubject("Smtp Test Title"); $text->setBody("<h1>Smtp Test Body<h1>"); // 添加附件 可选 $text->addAttachment(__FILE__,'附件重命名'); // 发送 $mail->send($text);
注意事项
当开启异常的时候,发送过程中出现问题,将会抛出以下异常:
try { /** @var \EasySwoole\Smtp\Mailer $mail **/ $mail->send($text); }catch (\EasySwoole\Smtp\Exception\Exception $exception) { }
当未开启异常的时候,发送过程中出现问题,将会返回:
/** @var \EasySwoole\Smtp\Mailer $mail **/ /** @var \EasySwoole\Smtp\Protocol\Response $response **/ $response = $mail->send($text);
StatusCode
- 0 发送成功
- 101 客户端连接超时
- 102 对端不是smtp协议服务
- 103 客户端接收超时
- 201 向smtp服务标识发送者失败
- 202 smtp服务不支持此验证模式
- 203 用户名出现错误
- 204 密码验证失败
- 205 发件人邮箱地址有误
- 206 收件人邮箱地址有误
- 207 标识邮件数据开始错误
- 208 标识邮件数据结束错误
- 209 退出smtp会话失败