11.6K ·GitHub
What is this?
A PHP library that validates email addresses against several RFCs — 5321, 5322, 6530, 6531, 6532 and 1035.
A PHP library that validates email addresses against several RFCs — 5321, 5322, 6530, 6531, 6532 and 1035.Is this a standalone app or a piece of code I pull into my project?It's a library, not an app: you require it in your PHP project and call its validation classes from your own code.
It's a library, not an app: you require it in your PHP project and call its validation classes from your own code.How do I add it to my PHP project?Install it with Composer (the README gives the require command), then pick which validation strategy — or combination of them — to follow for each check.
Install it with Composer (the README gives the require command), then pick which validation strategy — or combination of them — to follow for each check.What does my environment need for all of its checks to work?PHP 8.1 or newer plus Composer. Spoof checking and DNSCheckValidation additionally require the PHP Internationalization Libraries (PHP Intl) extension.
PHP 8.1 or newer plus Composer. Spoof checking and DNSCheckValidation additionally require the PHP Internationalization Libraries (PHP Intl) extension.If the DNS check passes, can I trust the mailbox really exists?No — DNSCheckValidation only looks for DNS records signaling that the server accepts mail; a passing check does not entail the address exists.
No — DNSCheckValidation only looks for DNS records signaling that the server accepts mail; a passing check does not entail the address exists.Which validation strategies does it ship with?Built-in options: RFCValidation (standard RFC-like checks), NoRFCWarningsValidation (fails when warnings are found), DNSCheckValidation, MessageIDValidation (RFC2822 message-id fields), SpoofCheckValidation (flags suspicious multi-UTF-8 characters) and MultipleValidationWithAnd, which combines others with a logical AND.
Built-in options: RFCValidation (standard RFC-like checks), NoRFCWarningsValidation (fails when warnings are found), DNSCheckValidation, MessageIDValidation (RFC2822 message-id fields), SpoofCheckValidation (flags suspicious multi-UTF-8 characters) and MultipleValidationWithAnd, which combines others with a logical AND.Can I combine validations or write my own?Yes. MultipleValidationWithAnd wraps other validations and passes only if all of them pass, and you can extend the library by implementing the EmailValidation interface with your own rules.
Yes. MultipleValidationWithAnd wraps other validations and passes only if all of them pass, and you can extend the library by implementing the EmailValidation interface with your own rules.Does it handle internationalized addresses with non-ASCII characters?Yes — the library explicitly targets RFCs 6530, 6531 and 6532, which cover internationalized addresses, and SpoofCheckValidation can flag multi-UTF-8 names that signal an erroneous email name.
Yes — the library explicitly targets RFCs 6530, 6531 and 6532, which cover internationalized addresses, and SpoofCheckValidation can flag multi-UTF-8 names that signal an erroneous email name.Which version should I use, and is the project still maintained?Use v4.x, released in January 2023 — it is the line in full support. v3.x, v2.1.x and v1.2 are past end-of-life, and PHP version requirements will advance in step with library versions.
Use v4.x, released in January 2023 — it is the line in full support. v3.x, v2.1.x and v1.2 are past end-of-life, and PHP version requirements will advance in step with library versions.What are similar projects?php-fts, validator.js, PHPMailer, laravel-ide-helper, flysystem, sqlx, vee-validate, ajv
php-fts, validator.js, PHPMailer, laravel-ide-helper, flysystem, sqlx, vee-validate, ajvWhich topics is it in?validator, php-library, unicode, internationalization, mit-license, dns, email, php, utility, backend, free, library
validator, php-library, unicode, internationalization, mit-license, dns, email, php, utility, backend, free, library