luchavez/aws-ses-bounce

在 AWS 简单电子邮件服务 (SES) 中对 Laravel 8|9|10 的弹回电子邮件地址进行黑名单处理

1.0.3 2023-10-23 15:31 UTC

This package is auto-updated.

Last update: 2024-09-23 17:52:40 UTC


README

Latest Version on Packagist Total Downloads GitHub Repo stars Discord Twitter Follow

现在,在 Laravel 应用程序中,使用 AWS 简单电子邮件服务 (SES) 发送电子邮件和新闻通讯非常普遍。Laravel 的 AWS SES 配置 也很容易遵循。

现在的问题是发送这些电子邮件的维护部分。向未验证的地址发送电子邮件可能会造成 弹回,而发送过多的电子邮件可能会造成 投诉。如果这些 弹回投诉 未进行检查,可能会损害发送者的声誉。

根据此 文档,如果弹回或投诉率过高,AWS 可能会将账户置于审查中或暂停账户发送电子邮件的能力。

此包 luchavez/aws-ses-bounce 的目标是监视电子邮件的 弹回投诉成功投递。此包记录接收者电子邮件地址及其 弹回投诉投递

此包的一个酷特性是 自动阻止。当达到一定数量的 弹回投诉 时,导致该情况的电子邮件地址将立即被阻止。另一个酷特性是在发送电子邮件时自动从 收件人抄送密送 收件人中删除已阻止的电子邮件地址。

这是此包的实体关系图 (ERD)

AWS SES Bounce ERD

想要贡献?访问 contributing.md 查看待办事项列表。

安装

通过 Composer

$ composer require luchavez/aws-ses-bounce:^1.0.0

设置

  1. 运行 php artisan migrate 以创建表。

  2. 如果您想覆盖包的 配置 的默认值,请将这些变量添加到 .env 文件中。

使用方法

AWS SES Bounce 服务

该包提供了一个名为 AwsSesBounce 的服务,您可以通过调用其 辅助函数 来使用它

  1. awsSesBounce()
  2. aws_ses_bounce()

以下是其可用方法的列表。

生成AwsSesBounceSignedURL Artisan 命令

为了能够通过 AWS SNS 主题接收 AWS SES 反馈,您必须首先运行以下命令以生成端点

php artisan asb:generate

您将得到类似以下内容

AWS SES Bounce HTTP Endpoints

将这些端点提交给指定的 DevOps 人员,以便他们可以在 AWS 控制台上设置。

路由

AWS SES Bounce Route List

注意:如果 APP_ENV 等于 production,则禁用 api/aws-ses/testapi/aws-ses/dump 路由。

资源

更改日志

有关最近更改的更多信息,请参阅 changelog

测试

要发送测试电子邮件,您可以使用 /api/aws-ses/test 路由。添加 toccbcc 收件人 - 可以是数组或单个值。

AWS SES Bounce Send Test Email

贡献

请参阅 contributing.md 了解详情和待办事项列表。

安全

如果您发现任何与安全相关的问题,请通过电子邮件jamescarloluchavez@gmail.com联系,而不是使用问题跟踪器。

致谢

许可证

有关更多信息,请参阅许可证文件