Обработка входящей электронной почты с SendGrid

 $app->post('/endpoints/email', function () use ($app, $c) {

Если SendGrid попытается «пропинговать» вашу конечную точку и получит ответ 4xx или 5xx, он будет ставить в очередь и повторять запрос, и продолжит делать это в течение 3 дней. Поэтому важно, чтобы успешный пинг возвращал статус 200.

Когда SendGrid достигает конечной точки, он делает это с различной информацией из полученного е-мейла. Они описаны в онлайн-справочнике по API , но особенно нас интересуют:

В идеальном мире мы могли бы просто прочитать адрес электронной почты получателя непосредственно из поля «to», но это поле могло бы соответствовать любому из следующего неисчерпывающего списка примеров в зависимости от того, как было отправлено:

• test-user@example.com
• "Test User" <test-user@example.com>
• "Test User" <test-user@example.com>, another-recipient@example.com
• "Test User" <test-user@example.com>; "Another Recipient" <another-recipient@example.com>

Нам нужно регулярное выражение для анализа того, что может быть несколькими получателями:

 $to = $req->post('to');
preg_match_all('/\b[A-Z0-9._%+-]+@(?:[A-Z0-9-]+\.)+[A-Z]+\b/i', $to, $result, PREG_PATTERN_ORDER);

foreach ($result[0] as $toAddress) {
    // handle the from address
}

Для каждого получателя мы затем извлекаем псевдоним части адреса и пытаемся найти пользователя, который соответствует:

 $alias = substr($toAddress, 0, strpos($toAddress, '@'));
$user = $c['db']->users->where('alias = ?', $alias)->fetch();

if ($user) {
    // great, we've got a valid user 
}

Для каждого получателя создание сообщения может выглядеть примерно так:

 $c['db']->posts()->insert(array(
    'title'   =>  $req->post('subject'),
    'body'    =>  ($req->post('html')) ? $req->post('html') : $req->post('text'),          
    'user_id' =>  $user['id'],
));

Теперь у нас есть базовые функции электронной почты! Конечно, это не очень безопасно, но это выходит за рамки этой статьи.

Давайте немного расширим приложение и позволим пользователям добавлять изображение в сообщение, отправляя его как почтовое вложение. Запрос POST от SendGrid включает параметр под названием attachments Прикрепленные файлы размещаются вместе с запросом и могут обрабатываться так же, как при загрузке файлов из веб-формы.

 if ($user) {
    $numAttachments = $req->post('attachments');
    $uploadedFiles = array();

    if ($numAttachments) {
        foreach ($_FILES as $key => $file) {
            $log->info('Saving file to ' . $c['config']['uploads.dir'] . $file['name']);
            move_uploaded_file($file['tmp_name'], $c['config']['uploads.dir'] . $file['name']);
            $uploadedFiles[] = $file['name'];
    }
}

Для простоты давайте просто сохраним имя файла первого прикрепленного файла в базе данных:

 $c['db']->posts()->insert(array(
    'title'   => $req->post('subject'),
    'body'    => ($req->post('html')) ? $req->post('html') : $req->post('text'),          
    'user_id' => $user['id'],
    'image'   => (count($uploaded_files)) ? $uploadedFiles[0] : ''
));

Резюме

В этой статье мы рассмотрели простое использование парсинга входящей электронной почты — базовая функция типа «электронная почта для публикации» для приложения в стиле блогов, позволяющая пользователям создавать сообщения, отправляя электронную почту на специальный адрес.

Регистрируя простой обратный вызов, вы можете делать разные забавные и интересные вещи, чтобы отвечать на входящие письма. Например, как насчет:

• отправка оповещений при получении письма
• передача вложений в Dropbox, Copy.com, SkyDrive, S3 и т. д.
• позволяя людям отвечать по электронной почте на уведомления с досок объявлений, систем обмена сообщениями и т. д.
• обработка запросов на отписку

Если вы думаете о других интересных применениях, дайте мне знать в комментариях. О, и загружаемый код для этой статьи доступен на GitHub для вас, чтобы клонировать и исследовать.