MailChecker

PyPI - Downloads

Crates.io

npm

Gem

Packagist

跨语言电子邮件验证。基于一个包含超过55,000个临时电子邮件域名的数据库。

验证电子邮件格式（底层使用 validator.js 的电子邮箱正则表达式，PHP 使用 FILTER_VALIDATE_EMAIL）
验证电子邮件是否为临时邮箱（类似 yopmail...，将您自己的数据集添加到 list.txt）

当您需要联系用户时，这将非常有用，可以避免因错误导致沟通不畅，或者屏蔽“垃圾邮箱”。

赞助商

有兴趣赞助吗？ 联系我们

升级

从 3.x 到 4.x

PHP```php

import using the fully qualified name.

use Fgribreau\MailChecker;

// ... echo MailChecker::isValid('[email protected]');

## 从 1.x 到 3.x
Mailchecker 公共 API 已经规范化，以下是更改：

- NodeJS/JavaScript: `MailChecker(email)` -> `MailChecker.isValid(email)`
- PHP: `MailChecker($email)` -> `MailChecker::isValid($email)`
- Python```python
import MailChecker
m = MailChecker.MailChecker()
if not m.is_valid('[email protected]'):
  # ...

成为:```python import MailChecker if not MailChecker.is_valid('[email protected]'):

...

MailChecker 目前支持：
* [NodeJS](https://github.com/FGRibreau/mailchecker/tree/master/platform/node) (CommonJS, [说明](#nodejs))
* [JavaScript](https://github.com/FGRibreau/mailchecker/tree/master/platform/javascript) (客户端, [说明](#javascript))
* [PHP](https://github.com/FGRibreau/mailchecker/tree/master/platform/php) ([说明](#php))
* [Python](https://github.com/FGRibreau/mailchecker/tree/master/platform/python) ([说明](#python))
* [Ruby](https://github.com/FGRibreau/mailchecker/tree/master/platform/ruby) ([说明](#ruby))
* [Rust](https://github.com/FGRibreau/mailchecker/tree/master/platform/rust) ([说明](#rust))
* [Elixir](https://github.com/FGRibreau/mailchecker/tree/master/platform/elixir) ([说明](#elixir))
* [Clojure](https://github.com/FGRibreau/mailchecker/tree/master/platform/clojure) ([说明](#clojure))
* [Go](https://github.com/FGRibreau/mailchecker/tree/master/platform/go) ([说明](#go))
* **使用 MailChecker 模板系统轻松为您自己的语言添加支持，并[给我们提交一个 pull request！](https://github.com/FGRibreau/mailchecker/fork_select)**

-------------------------
## 使用

### NodeJS```javascript
var MailChecker = require('mailchecker');

if(!MailChecker.isValid('[email protected]')){
  console.error('O RLY !');
  process.exit(1);
}

if(!MailChecker.isValid('myemail.com')){
  console.error('O RLY !');
  process.exit(1);
}

JavaScript```html

### PHP```php

use Fgribreau\MailChecker;

require __DIR__ . '/vendor/autoload.php';

if(!MailChecker::isValid('[email protected]')){
  die('O RLY !');
}

if(!MailChecker::isValid('myemail.com')){
  die('O RLY !');
}

Python```

pip install mailchecker

- [x] 为自定义LLM提供者端点（Ollama, vLLM）添加支持
    - [ ] 集成提示注入检测模块
    - [ ] 为自定义API端点添加支持
    - [ ] 实现Webhook通知```python
# no package yet; just drop in MailChecker.py where you want to use it.
from MailChecker import MailChecker

if not MailChecker.is_valid('[email protected]'):
    print("O RLY !")

Django validator: https://github.com/jonashaag/django-indisposable

Ruby```ruby

require 'mail_checker'

unless MailChecker.valid?('[email protected]') fail('O RLY!') end

### Rust```rust
 extern crate mailchecker;

assert_eq!(true, mailchecker::is_valid("[email protected]"));
assert_eq!(false, mailchecker::is_valid("\[email protected]\n"));
assert_eq!(false, mailchecker::is_valid("[email protected]"));

Elixir```elixir

Code.require_file("mail_checker.ex", "mailchecker/platform/elixir/")

unless MailChecker.valid?("[email protected]") do raise "O RLY !" end

unless MailChecker.valid?("myemail.com") do raise "O RLY !" end

### Clojure```clojure
; no package yet; just drop in mailchecker.clj where you want to use it.
(load-file "platform/clojure/mailchecker.clj")

(if (not (mailchecker/valid? "[email protected]"))
  (throw (Throwable. "O RLY!")))

(if (not (mailchecker/valid? "myemail.com"))
  (throw (Throwable. "O RLY!")))

Go```go

package main

import ( "log"

mail_checker "github.com/FGRibreau/mailchecker/v6/platform/go" )

if !mail_checker.IsValid("[email protected]") { log.Fatal("O RLY !"); }

if !mail_checker.IsValid("myemail.com") { log.Fatal("O RLY !") }

## 安装

Go```bash
go get github.com/FGRibreau/mailchecker/v6/platform/go

NodeJS/JavaScript```bash npm install mailchecker

Ruby```bash
gem install ruby-mailchecker

PHP```bash composer require fgribreau/mailchecker

__我们接受针对其他包管理器的拉取请求__。

## 数据来源

[TorVPN](http://torvpn.com/temporaryemail.html)```javascript
  $('td', 'table:last').map(function(){
    return this.innerText;
  }).toArray();

BloggingWV```javascript Array.prototype.slice.call(document.querySelectorAll('.entry > ul > li a')).map(function(el){return el.innerText});

... [请将你自己的数据集添加到 list.txt](https://github.com/fgribreau/mailchecker/blob/master/list.txt)。

从 list.txt 重新生成库
-------------------------------

只需运行（需要 NodeJS）：```
npm run build

开发

开发环境需要 docker。```sh

install and setup every language dependencies in parallel through docker

npm install

run every language setup in parallel through docker

npm run setup

run every language tests in parallel through docker

npm test

<!-- BACKERS/ -->

<h2>支持者</h2>

<h3>维护者</h3>

这些了不起的人正在维护这个项目：

<ul><li><a href="http://bit.ly/2c7uFJq">Francois-Guillaume Ribreau</a></li></ul>

<h3>赞助商</h3>

还没有赞助商！你会是第一个吗？

<span class="badge-patreon"><a href="https://patreon.com/fgribreau" title="通过 Patreon 捐赠本项目"><img src="https://img.shields.io/badge/patreon-donate-yellow.svg" alt="Patreon 捐赠按钮" /></a></span>
<span class="badge-gratipay"><a href="https://gratipay.com/fgribreau" title="通过 Gratipay 每周捐赠本项目"><img src="https://img.shields.io/badge/gratipay-donate-yellow.svg" alt="Gratipay 捐赠按钮" /></a></span>
<span class="badge-flattr"><a href="https://flattr.com/profile/fgribreau" title="通过 Flattr 捐赠本项目"><img src="https://img.shields.io/badge/flattr-donate-yellow.svg" alt="Flattr 捐赠按钮" /></a></span>
<span class="badge-paypal"><a href="https://fgribreau.me/paypal" title="通过 Paypal 捐赠本项目"><img src="https://img.shields.io/badge/paypal-donate-yellow.svg" alt="PayPal 捐赠按钮" /></a></span>
<span class="badge-bitcoin"><a href="https://www.coinbase.com/fgribreau" title="通过加密货币捐赠本项目"><img src="https://img.shields.io/badge/crypto-donate-yellow.svg" alt="加密货币捐赠按钮" /></a></span>

<h3>贡献者</h3>

这些了不起的人已为本项目贡献了代码：

<ul><li><a href="http://www.owenstephens.co.uk">Owen Stephens</a></li>
<li><a href="http://jacobburenstam.com">Jacob Burenstam Linder</a></li>
<li><a href="http://hermanslatman.nl">Herman Slatman</a></li>
<li><a href="https://github.com/trisix">trisix</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=trisix" title="查看 trisix 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="http://greenkeeper.io/">Greenkeeper</a></li>
<li><a href="http://wusty.io">Dustin Clark</a></li>
<li><a href="http://antonz.ru/">Anton Zhiyanov</a></li>
<li><a href="https://github.com/NBruel">Bruel Nicolas</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=NBruel" title="查看 Bruel Nicolas 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="https://github.com/R-J">Robin</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=R-J" title="查看 Robin 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="https://github.com/Spir">Spir</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=Spir" title="查看 Spir 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="http://flat.io">Vincent Giersch</a></li>
<li><a href="http://adriancarolli.surge.sh/">Adrian Carolli</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=watadarkstar" title="查看 Adrian Carolli 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="http://djpowers.github.io">Dave Powers</a></li>
<li><a href="https://github.com/frankydp">Frank Phillips</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=frankydp" title="查看 Frank Phillips 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="https://github.com/LuckyDino">LuckyDino</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=LuckyDino" title="查看 LuckyDino 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="https://github.com/vendethiel">ven</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=vendethiel" title="查看 ven 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="http://www.linkedin.com/in/romaingay">Romain Gay</a></li>
<li><a href="http://stormforger.com">Sebastian Cohnen</a></li>
<li><a href="https://github.com/dav1a1223">Dalai</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=dav1a1223" title="查看 Dalai 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="https://github.com/quaswex">quaswex</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=quaswex" title="查看 quaswex 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="https://github.com/sxyuan">sxyuan</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=sxyuan" title="查看 sxyuan 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="http://bit.ly/2c7uFJq">Francois-Guillaume Ribreau</a></li>
<li><a href="http://dusty.wtf">Dusty</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=dustywusty" title="查看 Dusty 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="http://synpro.io">larsvegas</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=larsvegas" title="查看 larsvegas 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="https://github.com/fgribreau/mailchecker/blob/master/zeeshanmuhammad.com">Zeeshan Muhammad</a></li>
<li><a href="https://github.com/kkleejoe">kkleejoe</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=kkleejoe" title="查看 kkleejoe 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="http://www.freneda.com.br">Luiz Freneda</a></li>
<li><a href="https://github.com/thorinisme">thorinisme</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=thorinisme" title="查看 thorinisme 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="https://github.com/Outsidaz">Liudas Šumskas</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=Outsidaz" title="查看 Liudas Šumskas 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="https://github.com/Wapweb">Alexander</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=Wapweb" title="查看 Alexander 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="http://gitlab.com/datio/">Alex Dom￸aki￸dis</a></li>
<li><a href="http://zanaca.com">Carlos Rios</a></li>
<li><a href="https://github.com/jbzdak">Jacek Bzdak</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=jbzdak" title="查看 Jacek Bzdak 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="https://github.com/dustywusty">D</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=dustywusty" title="查看 D 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="http://cashlink.io">Jonas Haag</a></li>
<li><a href="http://alex.domakidis.com/">￸A￸l￸e￸x D￸o￸m￸a￸k￸i￸d￸i￸s</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=datio" title="查看 ￸A￸l￸e￸x D￸o￸m￸a￸k￸i￸d￸i￸s 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="https://github.com/mcgregordan">Dan McGregor</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=mcgregordan" title="查看 Dan McGregor 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="https://github.com/fgribreau/mailchecker/blob/master/xthiago%29%20%28http%3A/xthiago.com">Thiago Rodrigues</a></li>
<li><a href="http://www.dillilabs.com">Dilli Labs LLC</a></li>
<li><a href="http://spokephone.com">Kieron Lawson</a></li>
<li><a href="http://kslr.org">Kslr</a></li>
<li><a href="http://C0derLint.github.io">Lint</a></li>
<li><a href="https://github.com/chadliu23">chadliu23</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=chadliu23" title="查看 chadliu23 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="http://t.me/milkyklim">milkyklim</a></li>
<li><a href="https://github.com/cosmosgenius">Sharat MR</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=cosmosgenius" title="查看 Sharat MR 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="https://github.com/nicolasPerraud">Nicolas Perraud</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=nicolasPerraud" title="查看 Nicolas Perraud 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="https://github.com/tbdmainrepo">tbdmainrepo</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=tbdmainrepo" title="查看 tbdmainrepo 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="https://github.com/kslr">Kslr</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=kslr" title="查看 Kslr 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="http://fabiocaccamo.com/">Fabio Caccamo</a></li>
<li><a href="https://github.com/nayluge">cyril souillard</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=nayluge" title="查看 cyril souillard 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="http://blog.lyrixx.info">Grégoire Pineau</a></li>
<li><a href="https://github.com/fgribreau/mailchecker/blob/master/meterian.io">Bruno Bossola</a></li>
<li><a href="https://github.com/florian-crtl">florian-crtl</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=florian-crtl" title="查看 florian-crtl 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="http://aneveningcalm.com">mikeyzm</a></li>
<li><a href="http://lyrixx.info/">Grégoire Pineau</a></li>
<li><a href="https://github.com/alongat">alonga</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=alongat" title="查看 alonga 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="https://github.com/fgribreau/mailchecker/blob/master/nitralabs.com">Vitalii Tverdokhlib</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=vitaliytv" title="查看 Vitalii Tverdokhlib 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="https://github.com/F21">Francis Chuang</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=F21" title="查看 Francis Chuang 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="http://mikeyzm.cn">mikeyzm</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=mikeyzm" title="查看 mikeyzm 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="http://www.syshack.ch">Pascal Vizeli</a></li>
<li><a href="https://github.com/carolineBda">Caroline</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=carolineBda" title="查看 Caroline 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="http://danielmihai.ro">Daniel Mihai</a></li>
<li><a href="https://github.com/hwvs">HWVS</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=hwvs" title="查看 HWVS 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="https://github.com/sydneyitguy">seb's</a> — <a href="https://github.com/FGRibreau/mailchecker/commits?author=sydneyitguy" title="查看 seb's 在仓库 FGRibreau/mailchecker 的 GitHub 贡献">查看贡献</a></li>
<li><a href="http://bug.is">Chigusa0w0</a></li>
<li><a href="http://cutelab.space">Maki</a></li></ul>

<a href="https://github.com/FGRibreau/mailchecker/blob/master/CONTRIBUTING.md#files">前往 <code>CONTRIBUTING.md</code> 文件，了解如何贡献。</a>

<!-- /BACKERS -->


## [变更日志](https://github.com/fgribreau/mailchecker/blob/master/CHANGELOG.md)

<!-- LICENSE/ -->

<h2>许可协议</h2>

除非另有说明，所有作品均为：

<ul><li>版权所有 &copy; <a href="http://fgribreau.com">Francois-Guillaume Ribreau</a></li></ul>

并基于以下许可协议授权：

<ul><li><a href="http://spdx.org/licenses/MIT.html">MIT 许可证</a></li></ul>

<!-- /LICENSE -->

France-Nuage _{法国主权云，适用于您的注册流程。无供应商锁定。}	Hook0 _{将注册事件作为签名 Webhook 发送。自托管，内置重试机制。}	Natalia _{捕获因错误电子邮件而注册的潜在客户——Natalia 会回电给他们。}	Netir _{通过指导性市场平台雇佣经过审核的法国自由职业后端开发者。}
NoBullshitConseil _{没有废话的技术咨询。创始人和 CTO 将获得直接的答案。}	Qualneo _{适用于法国培训师的 Qualiopi LMS。32 项指标已接入，随时可审计。}	Recapro _{转录会议和起草报告的私人 AI。主权托管。}

mailchecker

最受欢迎