Envio de e-mail autenticado utilizando o PHPMailer

� muito comum que uma aplicaç�o web necessite enviar e-mails. Podemos observar essa necessidade na criaç�o de uma p�gina de cadastro, na qual precisamos solicitar a confirmaç�o e permitir a recuperaç�o da senha, tarefas conclu�das atrav�s de correio eletr�nico, na maioria dos casos. Embora trivial essa implementaç�o pode exigir do programador conhecimentos sobre o protocolo e servidor utilizados.

Email autenticado com o PHPMailer

Apesar do PHP possuir uma funç�o nativa para o envio de e-mails, novas soluç�es t�m sido adotadas pelos programadores por oferecerem um n�vel mais alto de abstraç�o e serem independentes de plataformas. Neste documento falaremos sobre uma dessas soluç�es, a biblioteca PHPMailer.

T�picos

Introduç�o ao PHPMailer

PHPMailer � uma biblioteca de c�digo aberto para o envio de e-mails com suporte a HTML, diferentes protocolos e n�veis de autenticaç�o. Por possuir uma implementaç�o do protocolo SMTP integrada essa biblioteca pode ser utilizada em plataformas que n�o possuem um servidor para envio de e-mails nativo, como o Windows.

Antes de usarmos as classes da PHPMailer, devemos obter seu c�digo fonte. Isso pode ser feito a partir do reposit�rio oficial no GitHub ou via composer.

Usando o composer precisamos configurar uma depend�ncia no arquivo composer.json, conforme demonstrado abaixo:

"phpmailer/phpmailer": "~5.2"

Ou a partir do comando a seguir:

composer require phpmailer/phpmailer

Alternativamente, podemos atrav�s do git clonar o reposit�rio oficial com o seguinte comando:

git clone https://github.com/PHPMailer/PHPMailer.git

Ou ainda baixar todo c�digo fonte em um arquivo que poder� ser descompactado dentro do diret�rio do projeto:

https://github.com/PHPMailer/PHPMailer/archive/master.zip

Enviando e-mails com o PHPMailer

Veremos a partir daqui como enviar e-mails com o PHPMailer passo a passo.

Para utilizar o PHPMailer precisamos incluir o arquivo PHPMailerAutoload.php, que cont�m uma implementaç�o da funç�o autoload do PHP, respons�vel por localizar e carregar as classes utilizadas no c�digo. Fazemos isso com as funç�es require ou include:

require 'mailer/PHPMailerAutoload.php';

A partir daqui podemos criar uma inst�ncia da classe PHPMailer e configurar os dados do envio. Nesta documentaç�o optamos por utilizar o Gmail, conforme podemos ver a seguir, assim informamos para cada par�metro os valores requeridos por este provedor.


  $mail = new PHPMailer();
  $mail->isSMTP();
  $mail->Host = 'smtp.gmail.com';
  $mail->SMTPAuth = true;
  $mail->SMTPSecure = 'tls';
  $mail->Username = 'exemplo@gmail.com';
  $mail->Password = 'senha';
  $mail->Port = 587;

Linha 1: Instanciamos a classe PHPMailer;

Linha 3: Informamos que o protocolo utilizado � o SMTP, conforme recomendado pelo Gmail;

Linha 4: Este � o endereço para o servidor de e-mails do Gmail;

Linha 5: Habilitamos a autenticaç�o SMTP;

Linha 6: Definimos a criptografia a ser usada, conforme recomendado pelo Gmail;

Linhas 7 e 8: � preciso informar os dados de uma conta de e-mail ativa para concluir o envio;

Linha 9: Para autenticar via SSL precisamos informar a porta 587, conforme recomendado pelo Gmail.

Tamb�m � preciso informar a lista de destinat�rios e remetentes envolvidos no envio:


  $mail->setFrom('remetente@email.com.br');
  $mail->addReplyTo('no-reply@email.com.br');
  $mail->addAddress('email@email.com.br', �Nome�);
  $mail->addAddress('email@email.com.br', 'Contato'�);
  $mail->addCC('email@email.com.br', 'C�pia');
  $mail->addBCC('email@email.com.br', 'C�pia Oculta')

Linha 1: Definimos o e-mail do remetente;

Linha 2: Informamos um e-mail para o qual ser�o enviadas as respostas;

Linha 3 e 4: Adicionamos um destinat�rio. A qualquer momento podemos utilizar um nome opcional ap�s o endereço de e-mail;

Linhas 5 e 6: Informamos os e-mails em c�pia e c�pia oculta.

Diferentemente da funç�o mail do PHP (php mail), o PHPMailer d� suporte ao HTML, que usaremos para configurar a mensagem que ser� enviada no corpo do e-mail:


  $mail->isHTML(true);
  $mail->Subject = 'Assunto do email';
  $mail->Body    = 'Este � o conte�do da mensagem em <b>HTML!</b>';
  $mail->AltBody = 'Para visualizar essa mensagem acesse http://site.com.br/mail';
  $mail->addAttachment('/tmp/image.jpg', 'nome.jpg');

Linha 1: Indicamos o uso do HTML;

Linha 2: Damos um t�tulo para a mensagem;

Linhas 3: Definimos o conte�do do e-mail;

Linhas 4: Criamos um texto opcional para clientes que n�o suportem HTML, ou que tenham esse recurso desativado;

Linha 5: Adicionamos arquivos para serem enviados em anexo.

Neste ponto estamos prontos para disparar o e-mail:


  if(!$mail->send()) {
      echo 'N�o foi poss�vel enviar a mensagem.<br>';
      echo 'Erro: ' . $mail->ErrorInfo;
  } else {
      echo 'Mensagem enviada.';
  }

Linhas 1 a 3: Adicionamos uma condiç�o que verifica o retorno da funç�o send, respons�vel por disparar o e-mail. Informamos o erro que foi retornado pela propriedade $mail->ErrorInfo, se o envio falhar.

Linha 5: Caso a funç�o retorne verdadeiro, � impressa uma mensagem de sucesso.

Depurando o envio

Al�m dos recursos para verificaç�o de falhas, o PHPMailer disponibiliza um m�dulo de depuraç�o que pode ser ativado durante a fase de testes do sistema. Para isso, podemos configurar alguns par�metros a fim de detalharmos as falhas.

A primeira propriedade � a PHPMailer::SMTPDebug, que pode receber quatro valores, conforme a Tabela 1.

C�digo	Descriç�o
0	Desativa a depuraç�o, sendo a opç�o padr�o.
1	Exibe mensagens retornadas pelo cliente
2	Exibe mensagens do cliente e servidor
3	Exibe mensagens do cliente, servidor e status da conex�o
4	Exibe todas as mensagens, incluindo detalhes da comunicaç�o

Tabela 1. Valores para a propriedade PHPMailer::SMTPDebug

O c�digo a seguir mostra como podemos habilitar a depuraç�o e obter as mensagens em portugu�s do Brasil, visto que o PHPMailer oferece suporte a diferentes idiomas.


  $mail->SMTPDebug = 3;
  $mail->Debugoutput = 'html';
  $mail->setLanguage('pt');

Linha 1: Informamos o n�vel de depuraç�o.

Linha 2: Escolhemos como as mensagens ser�o exibidas.

Linha 3: Definiç�o do idioma.

Nota: � recomendado inserir esse tr�s logo ap�s instanciar a classe PHPMailer.

Exemplo pr�tico

O formul�rio abaixo � respons�vel por enviar uma mensagem que ser� processada pelo script email.php:


  <form action="email.php" method="post">
            <input type="text" name="assunto" placeholder="Assunto">
            <input type="text" name="mensagem" placeholder="Mensagem">
            <input type="submit" name="Enviar">
  </form>

Esses dados ser�o utilizados para enviar uma mensagem por e-mail, como mostra o trecho de c�digo a seguir:


 require 'mailer/PHPMailerAutoload.php';

if (isset($_POST['assunto']) && !empty($_POST['assunto'])) {
    $assunto = $_POST['assunto'];
}
if (isset($_POST['mensagem']) && !empty($_POST['mensagem'])) {
    $mensagem = $_POST['mensagem'];
}

$mail = new PHPMailer;

$mail->isSMTP();
$mail->Host = 'smtp.gmail.com';
$mail->SMTPAuth = true;
$mail->SMTPSecure = 'tls';
$mail->Username = 'exemplo@gmail.com';
$mail->Password = 'senha';
$mail->Port = 587;

$mail->setFrom('email@gmail.com', 'Contato');
$mail->addAddress('email@mail.com.br');

$mail->isHTML(true);

$mail->Subject = $assunto;
$mail->Body    = nl2br($mensagem);
$mail->AltBody = nl2br(strip_tags($mensagem));

if(!$mail->send()) {
    echo 'N�o foi poss�vel enviar a mensagem.
';
    echo 'Erro: ' . $mail->ErrorInfo;
} else {
    header('Location: index.php?enviado');
}

Linha 1: Include do autoload do PHPMailer;

Linhas 3 a 8: Capturamos o valor dos dados enviados no formul�rio e atribu�mos as vari�veis $assunto e $mensagem;

Linha 10: Instanciamos a classe PHPMailer para setar seus atributos e utilizar seus m�todos;

Linha 12: Definimos o protocolo que ser� utilizado, nesse caso, o SMTP;

Linha 13: Definimos o endereço para o servidor de e-mails do Gmail;

Linha: 14: Habilitamos a autenticaç�o SMTP;

Linha 15: Definimos a criptografia a ser usada, conforme recomendado pelo Gmail;

Linhas 16 e 17: � preciso informar os dados de uma conta de e-mail ativa para concluir o envio;

Linha 18: Para autenticar via SSL precisamos informar a porta 587, conforme recomendado pelo Gmail;

Linhas 20 e 21: Informamos o e-mail de destinat�rio e remetente, respectivamente;

Linha 23: Indicamos o uso do HTML no conte�do do e-mail;

Linha 25: Informamos o assunto para a mensagem;

Linha 26: Definimos o conte�do do e-mail e aplicamos a funç�o nl2br() para que o conte�do insira as quebras de linhas adicionadas ao texto;

Linha 27: Criamos um texto opcional para clientes que n�o suportem HTML, ou que tenham esse recurso desativado. Aplicamos a funç�o nl2br() e a funç�o strip_tags(), que remove os caracteres em HTML.

Linhas 29 a 31: Adicionamos uma condiç�o que verifica o retorno da funç�o send, respons�vel por disparar o e-mail. Informamos o erro que foi retornado pela propriedade $mail->ErrorInfo, se o envio falhar;

Linha 33: Caso a funç�o retorne verdadeiro, � impressa uma mensagem de sucesso.

Em um exemplo real, os endereços do remetente e destinat�rio podem ser capturados de uma fonte de dados. Aqui usamos valores fict�cios a t�tulo de exemplo.

Com isso garantimos o envio do e-mail utilizando o protocolo SMTP.

PHP: Envio de e-mail autenticado utilizando o PHPMailer

Nesta documentação você aprenderá a utilizar a biblioteca PHPMailer, com ela, você pode realizar envios de emails autenticados com o protocolo SMTP.

Email autenticado com o PHPMailer

T�picos

Introduç�o ao PHPMailer

Enviando e-mails com o PHPMailer

Depurando o envio

Exemplo pr�tico

Artigos relacionados