Enviar e receber correio com a API Mail

Este guia descreve como usar a API Mail para enviar e receber correio.

Esta API é suportada para runtimes de primeira geração e pode ser usada quando atualizar para runtimes de segunda geração correspondentes. Se estiver a fazer a atualização para o tempo de execução do App Engine PHP 7/8, consulte o guia de migração para saber mais sobre as suas opções de migração para serviços agrupados antigos.

Antes de começar

Tem de registar os seus emails de remetente como remetentes autorizados. Para mais informações, consulte quem pode enviar emails.

A enviar correio

A função mail() incorporada do PHP pode enviar emails através da API Mail do App Engine. Isto deve funcionar bem com a maioria do código existente, desde que esteja em conformidade com as restrições indicadas no artigo Enviar correio.

Em alternativa, pode fazer chamadas diretas para a API Mail:

use google\appengine\api\mail\Message;

// Notice that $image_content_id is the optional Content-ID header value of the
// attachment. Must be enclosed by angle brackets (<>)
$image_content_id = '<image-content-id>';

// Pull in the raw file data of the image file to attach it to the message.
$image_data = file_get_contents('image.jpg');

try {
    $message = new Message();
    $message->setSender('[e-mail]');
    $message->addTo('[e-mail]');
    $message->setSubject('Example email');
    $message->setTextBody('Hello, world!');
    $message->addAttachment('image.jpg', $image_data, $image_content_id);
    $message->send();
    echo 'Mail Sent';
} catch (InvalidArgumentException $e) {
    echo 'There was an error';
}

Receber correio

Pode configurar a sua app para receber emails recebidos em endereços no seguinte formato:

[e-mail]

Nota: mesmo que a sua app esteja implementada num domínio personalizado, não pode receber emails enviados para endereços nesse domínio.

Para receber emails:

1. Ative o correio recebido no ficheiro app.yaml da sua app. Adicione o seguinte ao inbound_services:

   - mail

2. No ficheiro de configuração, crie mapeamentos de caminhos de URL que representam endereços de email para controladores no código da sua app. O padrão /_ah/mail/.+ corresponde a todos os endereços de email recebidos:

   - url: /_ah/mail/.+
     script: handle_incoming_email.php
     login: admin

3. Implemente código para os controladores especificados no código da aplicação.

   Pode ler os dados MIME de php://input e analisar o conteúdo do email com Mailparse.