SendGrid：將郵件轉(zhuǎn)化為應(yīng)用的強(qiáng)大工具

SendGrid不僅是一個(gè)批量發(fā)送郵件的服務(wù)，它還提供了一個(gè)鮮為人知的強(qiáng)大功能：處理收到的郵件。通過簡(jiǎn)單的配置，你可以讓SendGrid處理指定域名下的所有郵件，并將郵件信息發(fā)送到你的服務(wù)器。本文將介紹如何利用SendGrid構(gòu)建一個(gè)“郵件到文章”功能。

核心要點(diǎn):

• SendGrid的入站郵件解析功能可以處理指定域名的所有郵件，并將郵件信息以POST請(qǐng)求的形式發(fā)送到指定的URI。
• 通過設(shè)置Webhook，你可以對(duì)收到的郵件進(jìn)行自定義處理。
• SendGrid的入站郵件解析功能應(yīng)用廣泛，例如：郵件到達(dá)提醒、附件上傳到云存儲(chǔ)、郵件回復(fù)論壇通知、處理退訂請(qǐng)求等。
• SendGrid的入站解析Webhook支持使用通配符子域名處理多個(gè)郵箱地址，支持HTTPS安全數(shù)據(jù)傳輸，附件總大小限制為20MB，并提供儀表盤活動(dòng)日志方便調(diào)試。

入門指南:

本文的示例代碼基于Slim Framework框架。為了方便調(diào)試，請(qǐng)?jiān)?code>composer.json的require部分添加以下內(nèi)容：

"slim/extras": "dev-develop"

在include/services.php中修改框架實(shí)例化代碼，配置日志記錄器：

$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%'
    ))
));

復(fù)制示例配置文件到config/config.php，設(shè)置你的配置值（例如數(shù)據(jù)庫連接信息）。添加以下代碼指定日志文件和上傳圖片的目錄：

'path.logs'    => $basedir . 'logs/',
'path.uploads' => $basedir . 'public/uploads/'

創(chuàng)建這些目錄并確保Web服務(wù)器具有寫入權(quán)限。

我們的應(yīng)用會(huì)為注冊(cè)用戶提供一個(gè)郵件別名。通過匹配收件人郵箱地址中的@符號(hào)之前的部分，我們可以確定發(fā)帖的用戶。在實(shí)際應(yīng)用中，你可能需要設(shè)置更復(fù)雜的別名規(guī)則，并限制郵件發(fā)送地址。數(shù)據(jù)庫結(jié)構(gòu)定義了兩個(gè)表，分別用于存儲(chǔ)用戶和文章：

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)
);

你需要一個(gè)SendGrid賬戶（免費(fèi)賬戶足夠）。注冊(cè)后，前往開發(fā)者頁面，點(diǎn)擊“解析收件郵箱”。輸入你的主機(jī)名和回調(diào)URL。

當(dāng)收到指定域名的郵件時(shí)，SendGrid會(huì)向你的URL發(fā)送POST請(qǐng)求，包含發(fā)件人、收件人、郵件正文和附件信息。最后，你需要為你的域名添加一個(gè)MX記錄，指向mx.sendgrid.net。具體操作取決于你的主機(jī)提供商。

構(gòu)建回調(diào)函數(shù):

你的應(yīng)用需要響應(yīng)你指定的URL的POST請(qǐng)求，例如：

"slim/extras": "dev-develop"

如果SendGrid的“ping”測(cè)試返回4xx或5xx錯(cuò)誤，它會(huì)將請(qǐng)求排隊(duì)并重試，持續(xù)3天。因此，成功的ping測(cè)試必須返回200狀態(tài)碼。SendGrid的POST請(qǐng)求包含郵件的各種信息，詳見SendGrid API文檔。我們主要關(guān)注以下字段：

由于to字段格式多樣，我們需要正則表達(dá)式解析多個(gè)收件人：

$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%'
    ))
));

對(duì)于每個(gè)收件人，提取別名部分并查找匹配的用戶：

'path.logs'    => $basedir . 'logs/',
'path.uploads' => $basedir . 'public/uploads/'

創(chuàng)建文章：

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)
);

現(xiàn)在我們有了基本的“郵件到文章”功能！接下來，我們可以添加附件處理功能，允許用戶通過郵件附件添加圖片。SendGrid的POST請(qǐng)求包含attachments參數(shù)，表示附件數(shù)量。附件與請(qǐng)求一起POST，處理方式與Web表單文件上傳相同。

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

總結(jié):

本文介紹了SendGrid入站郵件解析功能的一個(gè)簡(jiǎn)單應(yīng)用——“郵件到文章”功能，允許用戶通過發(fā)送郵件創(chuàng)建文章。通過簡(jiǎn)單的回調(diào)函數(shù)，你可以實(shí)現(xiàn)各種有趣的功能，例如：郵件到達(dá)提醒、附件上傳到云存儲(chǔ)、郵件回復(fù)論壇通知、處理退訂請(qǐng)求等。

(后續(xù)內(nèi)容，即FAQ部分，由于篇幅過長(zhǎng)，建議單獨(dú)處理?？梢詫AQ部分單獨(dú)作為一個(gè)新的問題提交。)

以上是用sendgrid處理傳入的電子郵件的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！