Ler e-mails do GMail pelo PHP

Este artigo mostra como obter os e-mails recebidos por uma conta do GMail a partir de código PHP.

Primeiramente, é preciso configurar o GMail para aceitar conexão IMAP. Para isso, é preciso entrar na sua conta pelo web mail (mail.google.com), e acessar o link "Configurações", no canto superior direito da página. Isso deve abrir uma tela com várias abas de configurações, então acesse a aba "Encaminhamento e POP/IMAP". Nesta aba, ative o IMAP no campo mostrado pela imagem:

E não se esqueça de clicar em "Salvar alterações".

Também é necessário permitir o acesso por aplicações menos seguras nesse link Aplicativos menos seguros.

Agora é só montar o script. Para isso, será preciso usar o módulo imap do PHP. Ele pode ser instalado via PECL.

Abrindo a conexão:

// Configure com seu login/senha
$login = 'teste';
$senha = '12345';

$str_conexao = '{imap.gmail.com:993/imap/ssl}';
if (!extension_loaded('imap')) {
    die('Modulo PHP/IMAP nao foi carregado');
}

// Abrindo conexao
$mailbox = imap_open($str_conexao, $login, $senha);
if (!$mailbox) {
    die('Erro ao conectar: '.imap_last_error());
}

Obtendo dados básicos sobre a conta:

$check = imap_check($mailbox);

// Ultima mensagem
echo $check->Date;

// Tipo de conexao
echo $check->Driver;

// Mailbox
echo $check->Mailbox;

// Numero de mensagens total
echo $check->Nmsgs;

// Numero de mensagens novas
echo $check->Recent;

Obter os marcadores (ou diretórios) da conta:

$marcadores = imap_getmailboxes($mailbox, $str_conexao, '*');

if (is_array($marcadores)) {
    foreach ($marcadores as $marcador) {
        $nome = str_replace($str_conexao, '', $marcador->name);
        $pos = strpos($nome, $marcador->delimiter);
        if ($pos !== false) {
            $nome = substr($nome, $pos + 1);
        }
        echo $nome."\n";
    }
} else {
    echo imap_last_error();
}

Obtém um array com informações sobre a mensagem "1" (primeira mensagem da caixa de entrada):

$overview = imap_fetch_overview($mailbox, 1);

$email = current($overview);

// Assunto
echo $email->subject;

// Remetente
echo $email->from;

// Destinatarios
echo $email->to;

// Data
echo $email->date;

// Identificador da mensagem
echo $email->message_id;

// Identificador da mensagem de referencia
echo $email->references;

// Identificador da mensagem que gerou a resposta
echo $email->in_reply_to;

// Tamanho em bytes
echo $email->size;

// Identificador da mensagem na caixa de entrada
echo $email->uid;

// Numero sequencial da mensagem na caixa de entrada
echo $email->msgno;

// Possui marca de "recente"
echo $email->recent;

// Possui marca de "marcada"
echo $email->flagged;

// Possui marca de "respondida"
echo $email->answered;

// Possui marca de "pronta para ser apagada"
echo $email->deleted;

// Possui marca de "lida"
echo $email->seen;

// Possui marca de "rascunho"
echo $email->draft;

Ler o cabeçalho da mensagem "1" (primeira mensagem da caixa de entrada):

$header = imap_header($mailbox, 1);

// Data
echo $header->Date;

// Endereco do destinatario
echo $header->toaddress;

// Endereco do remetente
echo $header->fromaddress;

// Enderecos de copia
echo $header->cc;

// Endereco de resposta
echo $header->reply_toaddress;

// Tamanho da mensagem
echo $header->Size;

// Assunto da mensagem
echo $header->Subject;

Obter o conteúdo da mensagem 1 (primeira mensagem):

$conteudo = imap_body($mailbox, 1);

Obtendo o conteúdo de texto (PLAIN e/ou HTML) das mensagens não lidas:

/** Funcao para decodificar o conteudo de uma mensagem */
function parse_encoding($body, $encoding) {
    switch ($encoding) {
    case ENCBASE64:
        return base64_decode($body);
    case ENCQUOTEDPRINTABLE:
        return imap_qprint($body);
    case ENC7BIT:
        return imap_mutf7_to_utf8($body);
    case ENC8BIT:
    case ENCBINARY:
    case ENCOTHER:
        return $body;
    }
}

// Obter os IDs dos e-mails nao lidos
$unseen = imap_search($mailbox, 'UNSEEN');      

foreach ($unseen as $id) {
    // Obter o conteudo cru da mensagem
    $body = imap_body($mailbox, $id);
    $structure = imap_fetchstructure($mailbox, $id);

    // Decodificando o conteudo das partes da mensagem
    $contents = array();
    if ($structure->type == TYPEMULTIPART) {
        foreach ($structure->parts as $j => $part) {
            $body_part = imap_fetchbody($mailbox, $id, $j + 1);
            if ($part->type == TYPETEXT) {
                $contents[$part->subtype] = parse_encoding($body_part, $part->encoding);
            }
        }
    } else {
        $contents[$structure->subtype] = parse_encoding($body, $structure->encoding);
    }

    // Exibindo o conteudo de texto do e-mail
    var_dump($contents);
}

Fechar a conexão IMAP:

imap_close($mailbox);