luchavez / aws-ses-bounce
在 AWS 简单电子邮件服务 (SES) 中对 Laravel 8|9|10 的弹回电子邮件地址进行黑名单处理
Requires
- php: ^8.0
- aws/aws-sdk-php: ^3.231
- illuminate/support: ~8|~9|~10
- luchavez/api-sdk-kit: ^1.0
Requires (Dev)
- orchestra/testbench: ~6|~7|~8
- phpunit/phpunit: ~9.0
- roave/security-advisories: dev-latest
This package is auto-updated.
Last update: 2024-09-23 17:52:40 UTC
README
现在,在 Laravel 应用程序中,使用 AWS 简单电子邮件服务 (SES) 发送电子邮件和新闻通讯非常普遍。Laravel 的 AWS SES 配置 也很容易遵循。
现在的问题是发送这些电子邮件的维护部分。向未验证的地址发送电子邮件可能会造成 弹回
,而发送过多的电子邮件可能会造成 投诉
。如果这些 弹回
和 投诉
未进行检查,可能会损害发送者的声誉。
根据此 文档,如果弹回或投诉率过高,AWS 可能会将账户置于审查中或暂停账户发送电子邮件的能力。
此包 luchavez/aws-ses-bounce
的目标是监视电子邮件的 弹回
、投诉
和 成功投递
。此包记录接收者电子邮件地址及其 弹回
、投诉
和 投递
。
此包的一个酷特性是 自动阻止
。当达到一定数量的 弹回
或 投诉
时,导致该情况的电子邮件地址将立即被阻止。另一个酷特性是在发送电子邮件时自动从 收件人
、抄送
和 密送
收件人中删除已阻止的电子邮件地址。
这是此包的实体关系图 (ERD)
想要贡献?访问 contributing.md 查看待办事项列表。
安装
通过 Composer
$ composer require luchavez/aws-ses-bounce:^1.0.0
设置
-
运行
php artisan migrate
以创建表。 -
如果您想覆盖包的 配置 的默认值,请将这些变量添加到
.env
文件中。
使用方法
AWS SES Bounce 服务
该包提供了一个名为 AwsSesBounce 的服务,您可以通过调用其 辅助函数 来使用它
awsSesBounce()
aws_ses_bounce()
以下是其可用方法的列表。
生成AwsSesBounceSignedURL Artisan 命令
为了能够通过 AWS SNS 主题接收 AWS SES 反馈,您必须首先运行以下命令以生成端点
php artisan asb:generate
您将得到类似以下内容
将这些端点提交给指定的 DevOps 人员,以便他们可以在 AWS 控制台上设置。
路由
注意:如果 APP_ENV
等于 production
,则禁用 api/aws-ses/test
和 api/aws-ses/dump
路由。
资源
更改日志
有关最近更改的更多信息,请参阅 changelog。
测试
要发送测试电子邮件,您可以使用 /api/aws-ses/test
路由。添加 to
、cc
和 bcc
收件人 - 可以是数组或单个值。
贡献
请参阅 contributing.md 了解详情和待办事项列表。
安全
如果您发现任何与安全相关的问题,请通过电子邮件jamescarloluchavez@gmail.com联系,而不是使用问题跟踪器。
致谢
许可证
有关更多信息,请参阅许可证文件。