PHPackages                             kristijandraca/is-burner-email - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Mail &amp; Notifications](/categories/mail)
4. /
5. kristijandraca/is-burner-email

ActiveLibrary[Mail &amp; Notifications](/categories/mail)

kristijandraca/is-burner-email
==============================

Fast, offline burner / disposable email detection. Three lists (blacklist, whitelist, graylist), two modes (normal, strict), zero runtime deps. PHP port of is-burner-email.

v1.3.5(1w ago)04MITTypeScriptPHP &gt;=8.1CI passing

Since Apr 22Pushed 1w agoCompare

[ Source](https://github.com/kristijandraca/is-burner-email)[ Packagist](https://packagist.org/packages/kristijandraca/is-burner-email)[ Docs](https://github.com/kristijandraca/is-burner-email)[ RSS](/packages/kristijandraca-is-burner-email/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (1)Versions (10)Used By (0)

is-burner-email
===============

[](#is-burner-email)

Fast, offline burner / disposable email detection. Same three-list model (`blacklist` / `whitelist` / `graylist`) and two modes (`normal` / `strict`) across six languages.

Packages
--------

[](#packages)

LanguageRegistryInstallDocs**JavaScript / TypeScript**[npm](https://www.npmjs.com/package/is-burner-email)`npm install is-burner-email`[`packages/js/`](./packages/js)**Python**[PyPI](https://pypi.org/project/is-burner-email/)`pip install is-burner-email`[`packages/py/`](./packages/py)**Go**go.dev`go get github.com/kristijandraca/is-burner-email/packages/go`[`packages/go/`](./packages/go)**PHP**[Packagist](https://packagist.org/packages/kristijandraca/is-burner-email)`composer require kristijandraca/is-burner-email`[`packages/php/`](./packages/php)**C# / .NET**[NuGet](https://www.nuget.org/packages/Kristijandraca.IsBurnerEmail)`dotnet add package Kristijandraca.IsBurnerEmail`[`packages/csharp/`](./packages/csharp)**Kotlin / JVM**[Maven Central](https://central.sonatype.com/artifact/io.github.kristijandraca/is-burner-email)`implementation("io.github.kristijandraca:is-burner-email:1.3.6")`[`packages/kotlin/`](./packages/kotlin)Every package ships the same bundled domain data and exposes the same API shape.

Shared features
---------------

[](#shared-features)

- **Offline.** Domain lists are bundled at package-build time. No network calls at runtime.
- **Zero runtime dependencies** in every language.
- **Three lists.**
    - `blacklist` — burners (always blocked)
    - `whitelist` — always allowed; overrides everything else
    - `graylist` — email alias / forwarding services (SimpleLogin, DuckDuckGo, Firefox Relay); blocked only in strict mode
- **Two modes.** `normal` (blacklist only) or `strict` (blacklist + graylist)
- **CLI in every language** — `burner ` with the same flags and exit codes
- **Refreshed weekly, reviewed before release** — a cron rebuilds the aggregated blacklist from upstream sources and opens a PR with the diff; a maintainer reviews and merges it, then cuts a patch release. No upstream change reaches a published package unattended.

Data model
----------

[](#data-model)

All four packages read the same canonical files in [`data/`](./data):

FileContentsEdited by`blacklist.txt`Aggregated from 5 upstream sources + `extra-blacklist.txt`, minus `whitelist` and `graylist`auto-generated`whitelist.txt`Curated "always allow" list (major providers, companies, IANA test domains)humans`graylist.txt`Curated alias / forwarding serviceshumans`extra-blacklist.txt`Manually-curated additions to the blacklisthumans`scripts/build-lists.ts` fetches, merges, and syncs these files into the language packages that need local copies (Go for `go:embed`, PHP for runtime reads, Python for editable installs, C# for `EmbeddedResource`, Kotlin for JVM classpath resources). The JS package reads root `data/` directly via tsup's text loader.

Monorepo layout
---------------

[](#monorepo-layout)

```
/
├── data/                               # Canonical data (single source of truth)
├── packages/
│   ├── js/                             # npm package
│   ├── py/                             # PyPI package
│   ├── go/                             # Go module
│   ├── php/                            # Composer package
│   ├── csharp/                         # NuGet package
│   └── kotlin/                         # Maven Central package
├── scripts/
│   └── build-lists.ts                  # Fetches sources, rebuilds blacklist, syncs copies
└── .github/workflows/                  # CI + release pipelines

```

Sources
-------

[](#sources)

The blacklist aggregates and deduplicates domains from:

- [disposable-email-domains/disposable-email-domains](https://github.com/disposable-email-domains/disposable-email-domains)
- [tompec/disposable-email-domains](https://github.com/tompec/disposable-email-domains)
- [FGRibreau/mailchecker](https://github.com/FGRibreau/mailchecker)
- [7c/fakefilter](https://github.com/7c/fakefilter)
- [martenson/disposable-email-domains](https://github.com/martenson/disposable-email-domains)

Community
---------

[](#community)

- [`CONTRIBUTING.md`](./CONTRIBUTING.md) — dev setup, adding domains, PR process
- [`SECURITY.md`](./SECURITY.md) — reporting vulnerabilities
- [`ACKNOWLEDGMENTS.md`](./ACKNOWLEDGMENTS.md) — upstream list credits

License
-------

[](#license)

MIT

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance98

Actively maintained with recent releases

Popularity3

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 71.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~5 days

Total

8

Last Release

13d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b1006959083268b2d06b26432cb07e27f5b4814a8e265cadbfb19a9c048856c3?d=identicon)[kristijandraca](/maintainers/kristijandraca)

---

Top Contributors

[![kristijandraca](https://avatars.githubusercontent.com/u/53337160?v=4)](https://github.com/kristijandraca "kristijandraca (28 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (11 commits)")

---

Tags

disposable-emailtemporary-emailvalidatoremailtemporaryofflinedisposableburner

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/kristijandraca-is-burner-email/health.svg)

```
[![Health](https://phpackages.com/badges/kristijandraca-is-burner-email/health.svg)](https://phpackages.com/packages/kristijandraca-is-burner-email)
```

###  Alternatives

[egulias/email-validator

A library for validating emails against several RFCs

11.6k719.7M399](/packages/egulias-email-validator)[propaganistas/laravel-disposable-email

Disposable email validator

6012.9M7](/packages/propaganistas-laravel-disposable-email)[zytzagoo/smtp-validate-email

Perform email address verification via SMTP

455945.5k3](/packages/zytzagoo-smtp-validate-email)[mattketmo/email-checker

Throwaway email detection library

2742.1M5](/packages/mattketmo-email-checker)[erag/laravel-disposable-email

A Laravel package to detect and block disposable email addresses.

249143.0k](/packages/erag-laravel-disposable-email)[stymiee/email-validator

A robust PHP 7.4+ email validation library that extends beyond basic validation with MX record checks, disposable email detection, and free email provider validation. Features include strict typing, custom validator support, internationalization (i18n), and an extensible architecture. Perfect for applications requiring thorough email verification with customizable validation rules.

33465.3k1](/packages/stymiee-email-validator)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
