jeronimofagundes / email-validator
A library for validating emails against several RFCs
Fund package maintenance!
egulias
Requires
- php: >= 5.5
- doctrine/lexer: ^1.0.1
Requires (Dev)
- dominicsayers/isemail: dev-master
- phpunit/phpunit: ^4.8.35||^5.7||^6.0
- satooshi/php-coveralls: ^1.0.1
Suggests
- ext-intl: PHP Internationalization Libraries are required to use the SpoofChecking validation
- dev-master
- 2.1.7
- 2.1.6
- 2.1.5
- 2.1.4
- 2.1.3
- 2.1.2
- 2.1.1
- 2.1.0
- 2.0.1
- 2.0.0
- 1.2.x-dev
- 1.2.15
- 1.2.14
- 1.2.13
- 1.2.12
- 1.2.11
- 1.2.10
- 1.2.9
- 1.2.8
- 1.2.7
- 1.2.6
- 1.2.5
- 1.2.4
- 1.2.3
- 1.2.2
- 1.2.1
- 1.2.0
- 1.1.1
- 1.1.0
- 1.0.0
- dev-update-egulias
- dev-LeShadow-master
- dev-1_2_cyrillic_email
- dev-cyrillic_email
- dev-domain_back_slash
- dev-moving_tests_around
- dev-invalid_domains_and_backslash
- dev-v2-readme-changes
- dev-readme-updates-for-v2
- dev-62_validation_interface
- dev-66-custom-errors
This package is auto-updated.
Last update: 2024-03-31 06:34:39 UTC
README
Suported RFCs
This library aims to support:
RFC 5321, 5322, 6530, 6531, 6532.
Requirements
- Composer is required for installation
- Spoofchecking and DNSCheckValidation validation requires that your PHP system has the PHP Internationalization Libraries (also known as PHP Intl)
Installation
Run the command below to install via Composer
composer require jeronimofagundes/email-validator "dev-master"
Getting Started
EmailValidatorrequires you to decide which (or combination of them) validation/s strategy/ies you'd like to follow for each validation.
A basic example with the RFC validation
<?php use Egulias\EmailValidator\EmailValidator; use Egulias\EmailValidator\Validation\RFCValidation; $validator = new EmailValidator(); $validator->isValid("example@example.com", new RFCValidation()); //true
Available validations
- RFCValidation: Standard RFC-like email validation.
- NoRFCWarningsValidation: RFC-like validation that will fail when warnings* are found.
- DNSCheckValidation: Will check if there are DNS records that signal that the server accepts emails. This does not entails that the email exists.
- SpoofCheckValidation: Will check for multi-utf-8 chars that can signal an erroneous email name.
- MultipleValidationWithAnd: It is a validation that operates over other validations performing a logical and (&&) over the result of each validation.
- DNSDigCheckValidation
- GMailValidation
- HotmailValidation
- Your own validation: You can extend the library behaviour by implementing your own validations.
*warnings: Warnings are deviations from the RFC that in a broader interpretation are acceptded.
<?php use Egulias\EmailValidator\EmailValidator; use Egulias\EmailValidator\Validation\DNSCheckValidation; use Egulias\EmailValidator\Validation\MultipleValidationWithAnd; use Egulias\EmailValidator\Validation\RFCValidation; $validator = new EmailValidator(); $multipleValidations = new MultipleValidationWithAnd([ new RFCValidation(), new DNSCheckValidation() ]); //ietf.org has MX records signaling a server with email capabilites $validator->isValid("example@ietf.org", $multipleValidations); //true
How to extend
It's easy! You just need to implement EmailValidation and you can use your own validation.
Other Contributors
(You can find current contributors here)
As this is a port from another library and work, here are other people related to the previous one:
- Ricard Clau @ricardclau: Performance against PHP built-in filter_var
- Josepf Bielawski @stloyd: For its first re-work of Dominic's lib
- Dominic Sayers @dominicsayers: The original isemail function
License
Released under the MIT License attached with this code.