Envio de email em PHP: PHPMailer, SwiftMailer e mail() — guia completo

Envio de email em PHP: visão geral de bibliotecas e ferramentas

O envio de e-mails é parte essencial de qualquer aplicação web: registro de usuários, redefinição de senha, notificações, campanhas de marketing. Em PHP, existem várias formas de implementar o envio de mensagens: desde a função embutida mail() até bibliotecas especializadas, como PHPMailer e SwiftMailer. Neste artigo, analisaremos detalhadamente cada ferramenta, suas vantagens, desvantagens e forneceremos exemplos práticos de código.

1. Função embutida mail()

A maneira mais simples é usar a função nativa do PHP mail(). Ela não requer instalação de bibliotecas adicionais, mas possui limitações significativas.

Sintaxe

mail($to, $subject, $message, $headers, $parameters);

Exemplo de envio de e-mail de texto simples

<?php$to = 'user@example.com';$subject = 'Saudação';$message = 'Olá! Este é um e-mail de teste.';$headers = 'From: noreply@pythonlib.ru' . "\\r" .           'Reply-To: support@pythonlib.ru' . "\\r" .           'X-Mailer: PHP/' . phpversion();

if(mail($to, $subject, $message, $headers)) {    echo 'E-mail enviado.';} else {    echo 'Erro ao enviar.';}?>

Desvantagens do mail()

• Depende das configurações do servidor (sendmail, postfix, etc.) — frequentemente cai no spam.
• Não suporta e-mails HTML e anexos sem criação manual de cabeçalhos MIME.
• Ausência de suporte para autenticação SMTP.
• Difícil depuração de erros.

Devido a essas limitações, para projetos sérios, recomenda-se o uso de bibliotecas especializadas.

2. PHPMailer — a biblioteca mais popular

PHPMailer é uma biblioteca poderosa e conveniente para envio de e-mail em PHP. Suporta HTML, anexos, autenticação SMTP, criptografia TLS/SSL e muitas outras funcionalidades.

Instalação

composer require phpmailer/phpmailer

Ou baixe manualmente do GitHub.

Exemplo de envio de e-mail HTML via SMTP Gmail

<?phpuse PHPMailer\\PHPMailer\\PHPMailer;use PHPMailer\\PHPMailer\\Exception;

require 'vendor/autoload.php';

$mail = new PHPMailer(true);

try {    // Configurações do servidor    $mail->isSMTP();    $mail->Host       = 'smtp.gmail.com';    $mail->SMTPAuth   = true;    $mail->Username   = 'your-email@gmail.com';    $mail->Password   = 'your-app-password';    $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;    $mail->Port       = 587;

    // Remetente e destinatário    $mail->setFrom('from@example.com', 'Seu nome');    $mail->addAddress('user@example.com', 'Destinatário');

    // Anexos    $mail->addAttachment('/path/to/file.pdf', 'document.pdf');

    // Conteúdo    $mail->isHTML(true);    $mail->Subject = 'Olá do PHPMailer';    $mail->Body    = '<h1>Título</h1><p>Este é um e-mail <b>HTML</b>.</p>';    $mail->AltBody = 'Versão em texto para clientes de e-mail sem suporte a HTML';

    $mail->send();    echo 'E-mail enviado.';} catch (Exception $e) {    echo "Erro: {$mail->ErrorInfo}";}?>

Vantagens do PHPMailer

• API simples e intuitiva.
• Suporte a todos os protocolos de e-mail modernos.
• Codificação automática de anexos.
• Boa documentação e grande comunidade.

3. SwiftMailer — alternativa flexível

SwiftMailer é outra biblioteca popular que fornece uma interface orientada a objetos para envio de e-mails. Ao contrário do PHPMailer, ela utiliza o conceito de "transportes" (Transport) e "mensagens" (Message).

Instalação

composer re