omnishield / disposable

1.x-dev 2026-10-09 15:30 UTC

Requires

• php: >=8.2
• glitchr/omnishield: ^1.0@dev

Requires (Dev)

• phpunit/phpunit: ^11.0

Suggests

• symfony/http-client: Refreshing the list through the application's HTTP client (bin/omnishield-disposable works without it)

MIT

• Marco Meyer

• email
• antispam
• blocklist
• disposable-email
• temporary-email
• omnishield

Published on Packagist.org on 2026-10-09 16:04 UTC

README

Disposable e-mail domains for glitchr/omnishield: is this e-mail's domain a throw-away one. The free list of the disposable-email-domains project (CC0, 9,205 domains on 2026-10-05) ships in the package; the site adds its own allow and deny lists. Nothing is called while a request runs: the list is a file, read once per process.

use Omnishield\Disposable\DisposableGatewayFactory;
use Omnishield\Model\Identity;

$emails = (new DisposableGatewayFactory())->create(['allow' => ['example-school.org']]);

$emails->lookup(new Identity(email: '[e-mail]'))->known;   // true: mailinator.com, subdomains included
$emails->isDisposable('[e-mail]');                                 // false

omnishield:
    gateways:
        emails:
            factory: disposable
            options: { list: '%kernel.project_dir%/var/disposable_domains.txt' }   # a refreshed copy; the shipped one otherwise

Refresh the list - from a cron job, into a file of the application's (one inside vendor/ is put back by the next composer install):

vendor/bin/omnishield-disposable refresh var/disposable_domains.txt
vendor/bin/omnishield-disposable check [e-mail] --list var/disposable_domains.txt

Documentation: the matching, the options, the refresh, the list's licence, what was verified.

License: MIT since 2026-10-09; earlier versions remain published under LGPL-3.0-or-later. The list itself (data/domains.txt): CC0 1.0, by its authors.

Formerly omniguard/disposable, renamed on 2026-10-10 with its family (glitchr/omnishield).