EmailValidator

Validador de e-mail

Uma biblioteca para validação de e-mails em diversas RFCs.

RFCs suportados

Esta biblioteca tem como objetivo oferecer suporte a RFCs:

• 5321,
• 5322,
• 6530,
• 6531,
• 6532,
• 1035

Versões suportadas

A versão principal atual com suporte total é v3

Versão	Lançado	EOL	Apenas correções de bugs críticos	Completo
v4.x	2023/01/07	-	X	X
v3.x	2020/12/29	-	X
v2.1.x	16/05/2016	SIM
v1.2	19/05/2013	SIM

Requisitos

• PHP 8.1
• O Composer é necessário para instalação
• A validação de Spoofchecking e DNSCheckValidation requer que seu sistema PHP tenha as Bibliotecas de Internacionalização PHP (também conhecidas como PHP Intl)

Nota : PHP version upgrades will happen to accomodate to the pace of major frameworks. Minor versions bumps will go via minor versions of this library (ie: PHP7.3 -> v3.x+1). Major versions will go with major versions of the library

Instalação

Execute o comando abaixo para instalar via Composer

composer require egulias/email-validator

Começando

EmailValidator exige que você decida quais (ou combinações delas) estratégias de validação você gostaria de seguir para cada validação.

Um exemplo básico com a validação RFC

 <?php

use Egulias  EmailValidator  EmailValidator ;
use Egulias  EmailValidator  Validation  RFCValidation ;

$ validator = new EmailValidator ();
$ validator -> isValid ( " [email protected] " , new RFCValidation ()); / / true

Validações disponíveis

1. RFCValidation: validação de e-mail padrão semelhante a RFC.
2. NoRFCWarningsValidation: validação semelhante a RFC que falhará quando avisos* forem encontrados.
3. DNSCheckValidation: Verificará se existem registros DNS que sinalizem que o servidor aceita emails. Isso não significa que o e-mail exista.
4. MultipleValidationWithAnd: É uma validação que opera sobre outras validações realizando um e (&&) lógico sobre o resultado de cada validação.
5. MessageIDValidation: Segue RFC2822 para message-id para validar esse campo, que possui algumas diferenças na parte do domínio.
6. Sua própria validação: você pode estender o comportamento da biblioteca implementando suas próprias validações.

*avisos: Avisos são desvios da RFC que em uma interpretação mais ampla são aceitos.

 <?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 capabilities
$ validator -> isValid ( " [email protected] " , $ multipleValidations ); / / true 

Validações adicionais

Validações não presentes nas RFCs

1. SpoofCheckValidation: verificará caracteres multi-utf-8 que podem sinalizar um nome de e-mail incorreto.

Como estender

É fácil! Você só precisa implementar EmailValidation e pode usar sua própria validação.

Contribuindo

Por favor, siga o guia de contribuição. É curto e simples e vai ajudar muito.

Outros colaboradores

(Você pode encontrar colaboradores atuais aqui)

Como este é um port de outra biblioteca e obra, aqui estão outras pessoas relacionadas ao anterior:

• Ricard Clau @ricardclau: Desempenho em relação ao filter_var integrado do PHP (v2 e anteriores)
• Josepf Bielawski @stloyd: Por seu primeiro retrabalho da biblioteca de Dominic
• Dominic Sayers @dominicsayers: A função isemail original

Licença

Lançado sob a licença MIT anexada a este código.