README

用于验证电子邮件地址的小型PHP库，使用多种方法。

特性

验证电子邮件地址
检查示例域名（例如 example.com）
检查一次性电子邮件域名（例如 mailinator.com）
检查基于角色的地址（例如 abuse@）
检查MX记录（即可以接收电子邮件）

安装（使用Composer）

composer require nojacko/email-validator:~1.0

用法

通用函数

isValid($email) 运行此库中的所有测试。返回true或false。
isSendable($email) 检查isEmail、isExample和hasMx。返回true或false。

特定函数

如果您需要更多控制，请单独使用以下函数。

isEmail($email) 注意：仅返回true或false。
isExample($email)
isDisposable($email)
isRole($email)
hasMx($email)

这些函数接受单个参数（电子邮件地址）并返回

当函数名满足时返回true。
当函数名不满足时返回false。
当检查不可行时返回null，即提供无效电子邮件。

示例

$validator = new \EmailValidator\Validator();

$validator->isValid('example@google.com');              // true
$validator->isValid('abuse@google.com');                // false
$validator->isValid('example@example.com');             // false

$validator->isSendable('example@google.com');           // true
$validator->isSendable('abuse@google.com');             // true
$validator->isSendable('example@example.com');          // false

$validator->isEmail('example@example.com');             // true
$validator->isEmail('example@example');                 // false

$validator->isExample('example@example.com');           // true
$validator->isExample('example@google.com');            // false
$validator->isExample('example.com');                   // null

$validator->isDisposable('example@example.com');        // false
$validator->isDisposable('example@mailinater.com');     // true
$validator->isDisposable('example.com');                // null

$validator->isRole('example@example.com');              // false
$validator->isRole('abuse@example.com');                // true
$validator->isRole('example.com');                      // null

$validator->hasMx('example@example.com');               // false
$validator->hasMx('example@google.com');                // true
$validator->hasMx('example.com');                       // null

贡献

欢迎贡献！

要求

测试驱动开发
遵循 PSR-2 编码风格指南
每次提交请求只做一项更改

添加/删除一次性域名

请参阅 email-data-disposable 项目。

新特性

如果您计划添加新特性，请首先提出一个问题以确保它符合范围。目标是保持此库小巧且具有一个特定的目的。

其他贡献

对于任何不是新特性（错误修复、测试等）的内容，只需创建一个拉取请求。

测试

测试位于 tests 文件夹中。

使用phpunit运行测试。在根目录中，通过CLI执行 phpunit。

版本管理

语义版本化 2.0.0

许可证

MIT许可证（MIT）。见LICENCE文件。

nojacko / email-validator

维护者

详细信息