开发者/disposable_email_checker

用于检测一次性电子邮件地址的库

3.1.0 2018-11-04 18:33 UTC

This package is not auto-updated.

Last update: 2024-09-14 20:09:43 UTC


README

Build Status

这是什么?

Disposable Email Checker 是一个库,允许应用程序检查用户是否使用 一次性电子邮件地址 注册。这对于基于电子邮件地址提供试用期的服务非常重要。因此,如果用户使用一次性地址,则他们可能绕过时间限制。其他应用程序可能使用它来确保他们拥有可以用于未来通信的有效电子邮件地址。

该库目前包含 > 1,900 个域名,并持续增长。

目标

该项目最初提供 PHP 库,但在 v2 版本中,它已重构为将域名列表与代码分离。这使以下情况成为可能

  • 提供多种语言的实现,这些语言消耗此类数据文件。
  • 使应用程序能够轻松嵌入这些数据文件并直接使用它们。
  • 简化更新列表以添加更多域的过程。

如何检测一次性地址?

该库包含一系列规则,用于确定地址是否为一次性地址。该库不连接到互联网来确定地址的类型或有效性。将来,该库可能增强以提供应用程序显式要求在线检查的方法。

贡献

此库作为开源软件,采用 MIT 许可,因此您可以在开源和商业应用程序中使用它。向此库贡献的最佳方式包括

  1. 报告该库应检测但未检测到的服务提供商。请参阅以下部分以验证可处置域名。
  2. 在问题跟踪器中报告错误和功能请求。
  3. 为库提供除 PHP 之外的语言端口。

使用关联的 github 问题跟踪器来报告错误和功能请求。

验证一次性域名

在提交包含新一次性电子邮件域名的 PR 之前,请通过 Kickbox 服务验证这些域名是否确实是一次性的。

在以下 URL 中,将 {domain} 替换为您的域名(例如 example.com),并确保它返回 disposable: true

https://open.kickbox.com/v1/disposable/{domain}

运行单元测试

以下是运行单元测试的方法

composer install
vendor/phpunit/phpunit/phpunit php/tests/disposable_email_checker_tests.php

版本控制方案

此库的版本格式如下 "1.2.3"。

(1) 这是主要版本,当发生重大更改或重新实现时将更改。

(2) 这是次要版本,当 API 发生更改时将更改。大多数时候这些不会是破坏性更改,但有时它们可能是。

(3) 这是数据版本,仅在仅更新用于确定电子邮件地址是否为一次性地址的规则的发布中更改。

致谢