Tabela de conteúdos

PHPMailer: enviando e-mail autenticado por SMTP

Para sites hospedados na Criare, prefira SMTP com autenticação. Isso permite usar a conta de e-mail autorizada, mas não garante entrega na Caixa de entrada: SPF, DKIM, DMARC, reputação e conteúdo também precisam estar adequados. A função mail() depende da configuração do servidor e não significa, por si só, que a mensagem será spam.

Envio do site: segurança em cada etapa

Ilustração conceitual: envio autenticado não garante entrega na Caixa de entrada.

Envio autenticado: site → SMTP 587 → destinatário

Atenção: o código abaixo é um exemplo para desenvolvedores. Na dúvida, peça ajuda ao responsável pelo seu site.

Resumo do procedimento

Envio do site: segurança em cada etapa

Antes de começar

1. Instale o PHPMailer

Na pasta do projeto PHP, instale a biblioteca pelo Composer (gerenciador de dependências), que seleciona uma versão compatível com o PHP instalado:

composer require phpmailer/phpmailer

O exemplo abaixo pressupõe instalação pelo Composer. Para instalação manual, siga as instruções de carregamento de arquivos da documentação oficial e substitua o carregamento de vendor/autoload.php.

2. Exemplo de envio

Substitua os endereços de exemplo e confirme o nome do servidor SMTP com o suporte. Configure a variável SMTP_PASSWORD no ambiente do PHP da hospedagem; defini-la só no terminal não a disponibiliza automaticamente ao site. Este exemplo não é um formulário completo: ele exige validação e proteção contra abuso antes de uso público.

<?php
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;
 
require __DIR__ . '/vendor/autoload.php';
 
$smtpPassword = getenv('SMTP_PASSWORD');
if (!is_string($smtpPassword) || $smtpPassword === '') {
    error_log('SMTP_PASSWORD não configurada.');
    http_response_code(500);
    exit('Envio indisponível.');
}
 
if (($_SERVER['REQUEST_METHOD'] ?? '') !== 'POST') {
    header('Allow: POST');
    http_response_code(405);
    exit('Use o formulário para enviar.');
}
 
$replyTo = $_POST['email'] ?? '';
if (!is_string($replyTo) || strlen($replyTo) > 254 || !filter_var($replyTo, FILTER_VALIDATE_EMAIL)) {
    http_response_code(400);
    exit('Informe um e-mail válido.');
}
 
$mail = new PHPMailer(true);           // true: erros viram exceções
try {
    $mail->isSMTP();
    $mail->Host       = 'smtp.seudominio.com.br';   // servidor de saída da sua conta
    $mail->Port       = 587;
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
    $mail->SMTPAuth   = true;
    $mail->Username   = 'contato@seudominio.com.br'; // e-mail completo
    $mail->Password   = $smtpPassword;                // não deixe a senha no código
    $mail->CharSet    = 'UTF-8';
 
    $mail->setFrom('contato@seudominio.com.br', 'Sua Empresa'); // o mesmo e-mail do Username
    $mail->addAddress('cliente@exemplo.com.br', 'Nome do Cliente');
    $mail->addReplyTo($replyTo);
 
    $mail->Subject = 'Mensagem do site';
    $mail->Body    = 'Texto da mensagem';
 
    $mail->send();
    echo 'Mensagem aceita pelo servidor de envio.';
} catch (Exception $e) {
    error_log('Falha ao enviar mensagem pelo SMTP.');
    http_response_code(500);
    echo 'Não foi possível enviar a mensagem.';
}

Teste e diagnóstico

Sucesso em send() significa aceitação pelo servidor SMTP, não confirmação de leitura nem garantia de entrega final. Confira o destinatário, eventuais retornos e o rastreamento de e-mail, quando disponível.

O exemplo usa resposta genérica e não imprime credenciais. Em diagnóstico autorizado, mantenha logs em local restrito, remova dados sensíveis antes de compartilhar e desligue a depuração ao terminar.

Antes de publicar um formulário

Este exemplo não implementa sozinho proteção contra abuso. O sistema precisa validar os demais campos, limitar tamanho e frequência das requisições, controlar anexos e aplicar proteção contra automação. Em fluxos com sessão, avalie proteção contra CSRF. CAPTCHA não substitui essas verificações.

Mantenha os destinatários sob controle da aplicação: não transforme dados enviados pelo visitante em uma lista livre de destinos. Não use uma senha real em repositório, captura de tela ou diretório público.

Boas práticas

Referências