Gérer les e-mails entrants avec SendGrid

SendGrid: un outil puissant pour convertir les e-mails en applications

SendGrid n'est pas seulement un service qui envoie un courrier en lots, mais il fournit également une fonctionnalité puissante moins connue: le traitement reçue par courrier. Avec une configuration simple, vous pouvez laisser SendGrid procéder à tous les e-mails sous le nom de domaine spécifié et envoyer des e-mails à votre serveur. Cet article présentera comment créer une fonction "Mail à l'article" à l'aide de SendGrid.

Points de base:

• La fonction de résolution de messagerie entrante de SendGrid peut traiter tous les messages à partir d'un nom de domaine spécifié et envoyer des informations de messagerie à l'URI spécifiées sous la forme d'une demande de poste.
• En configurant un webhook, vous pouvez personnaliser les e-mails reçus.
• La fonction de résolution par e-mail entrante de SendGrid est largement utilisée, telle que: rappel d'arrivée par e-mail, téléchargement de pièce jointe sur le stockage cloud, notifications du forum de réponse par e-mail, traitement des demandes de désabonnement, etc.
• La résolution entrante de SendGrid prend en charge l'utilisation de sous-domaines génériques pour traiter plusieurs adresses e-mail, prend en charge la transmission de données sécurisée HTTPS, la taille totale de la pièce jointe est limitée à 20 Mo et fournit des journaux d'activité du tableau de bord pour un débogage facile.

débutant:

L'exemple de code de cet article est basé sur le framework Slim Framework. Pour un débogage facile, veuillez ajouter le contenu suivant dans la section composer.json: require

<code class="language-json">"slim/extras": "dev-develop"</code>

Modifiez le code d'instanciation du framework dans

et configurez le journal: include/services.php

<code class="language-php">$app = new Slim(array(
    'view' => new Twig(),
    'templates.path' => $c['config']['path.templates'],
    'log.writer' => new \Slim\Extras\Log\DateTimeFileWriter(array(
        'path' => dirname($c['config']['path.logs']),
        'name_format' => 'Y-m-d',
        'message_format' => '%label% - %date% - %message%'
    ))
));</code>

Copiez l'exemple de fichier de configuration dans

et définissez votre valeur de configuration (telle que les informations de connexion de la base de données). Ajoutez le code suivant pour spécifier le répertoire dans lequel le fichier journal et télécharger l'image: config/config.php

<code class="language-php">'path.logs'    => $basedir . 'logs/',
'path.uploads' => $basedir . 'public/uploads/'</code>

Créez ces répertoires et assurez-vous que le serveur Web a des autorisations d'écriture.

Notre application fournira aux utilisateurs enregistrés avec un alias par e-mail. En faisant correspondre la pièce avant le symbole

dans l'adresse e-mail du destinataire, nous pouvons déterminer l'utilisateur qui l'a publié. Dans les applications pratiques, vous devrez peut-être définir des règles d'alias plus complexes et limiter les adresses d'envoi d'e-mails. La structure de la base de données définit deux tables pour le stockage des utilisateurs et des articles: @

<code class="language-sql">CREATE TABLE users (
    id INTEGER NOT NULL AUTO_INCREMENT,
    name VARCHAR(128) NOT NULL ,
    alias VARCHAR(45) NOT NULL ,

    PRIMARY KEY (id) ,
   INDEX alias (alias ASC)
);

CREATE  TABLE posts (
    id INTEGER NOT NULL AUTO_INCREMENT,
    title VARCHAR(255) NOT NULL,
    body TEXT NOT NULL,
    image varchar(255),
    user_id INTEGER NOT NULL,

    PRIMARY KEY (id)
);</code>

Vous avez besoin d'un compte SendGrid (le compte gratuit est suffisant). Après vous inscrire, accédez à la page du développeur et cliquez sur "Analyser l'e-mail entrant". Entrez votre nom d'hôte et votre URL de rappel.

Lors de la réception d'un message avec le nom de domaine spécifié, SendGrid enverra une demande de message à votre URL, y compris l'expéditeur, le destinataire, le corps e-mail et les informations de pièce jointe. Enfin, vous devez ajouter un enregistrement MX à votre nom de domaine, pointant vers

. L'opération spécifique dépend de votre fournisseur d'hébergement. mx.sendgrid.net

Fonction de rappel de construction:

Votre demande doit répondre à la demande postale de l'URL que vous avez spécifiée, par exemple:

<code class="language-json">"slim/extras": "dev-develop"</code>

Si le test "ping" de SendGrid renvoie une erreur 4xx ou 5xx, il fait la file d'attente et essaie à nouveau pendant 3 jours. Par conséquent, un test de ping réussi doit renvoyer un code d'état de 200. La demande publique de SendGrid contient diverses informations sur l'e-mail, veuillez vous référer à la documentation API SendGrid pour plus de détails. Nous nous concentrons principalement sur les champs suivants:

Parce que les formats de champ to sont divers, nous avons besoin d'expressions régulières pour analyser plusieurs destinataires:

<code class="language-php">$app = new Slim(array(
    'view' => new Twig(),
    'templates.path' => $c['config']['path.templates'],
    'log.writer' => new \Slim\Extras\Log\DateTimeFileWriter(array(
        'path' => dirname($c['config']['path.logs']),
        'name_format' => 'Y-m-d',
        'message_format' => '%label% - %date% - %message%'
    ))
));</code>

Pour chaque destinataire, extraire la section Alias ​​et trouver l'utilisateur correspondant:

<code class="language-php">'path.logs'    => $basedir . 'logs/',
'path.uploads' => $basedir . 'public/uploads/'</code>

Créer un article:

<code class="language-sql">CREATE TABLE users (
    id INTEGER NOT NULL AUTO_INCREMENT,
    name VARCHAR(128) NOT NULL ,
    alias VARCHAR(45) NOT NULL ,

    PRIMARY KEY (id) ,
   INDEX alias (alias ASC)
);

CREATE  TABLE posts (
    id INTEGER NOT NULL AUTO_INCREMENT,
    title VARCHAR(255) NOT NULL,
    body TEXT NOT NULL,
    image varchar(255),
    user_id INTEGER NOT NULL,

    PRIMARY KEY (id)
);</code>

Maintenant, nous avons la fonction de base "e-mail à l'article"! Ensuite, nous pouvons ajouter une fonction de traitement de la pièce jointe, permettant aux utilisateurs d'ajouter des images via des pièces jointes. La demande postale de SendGrid contient le paramètre attachments, indiquant le nombre de pièces jointes. Les pièces jointes sont publiées avec les demandes, et la méthode de traitement est la même que celle du téléchargement des fichiers de formulaire Web.

<code class="language-php">$app->post('/endpoints/email', function () use ($app, $c) {</code>

Résumé:

Cet article présente une application simple de la fonction de résolution par e-mail entrante de SendGrid - la fonction "Mail à l'article", qui permet aux utilisateurs de créer des articles en envoyant des e-mails. Grâce à des fonctions de rappel simples, vous pouvez implémenter diverses fonctions intéressantes, telles que: rappel d'arrivée par e-mail, téléchargement de pièce jointe sur le stockage cloud, notifications du forum de réponse par e-mail, traitement des demandes de désabonnement, etc.

(Le contenu ultérieur, à savoir la partie FAQ, est recommandé pour le traiter séparément en raison de la durée de l'article. La partie FAQ peut être soumise séparément en tant que nouvelle question.)

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!