SendGrid:將郵件轉化為應用的強大工具
SendGrid不僅是一個批量發送郵件的服務,它還提供了一個鮮為人知的強大功能:處理收到的郵件。通過簡單的配置,你可以讓SendGrid處理指定域名下的所有郵件,並將郵件信息發送到你的服務器。本文將介紹如何利用SendGrid構建一個“郵件到文章”功能。
核心要點:
入門指南:
本文的示例代碼基於Slim Framework框架。為了方便調試,請在composer.json
的require
部分添加以下內容:
"slim/extras": "dev-develop"
在include/services.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%' )) ));
複製示例配置文件到config/config.php
,設置你的配置值(例如數據庫連接信息)。添加以下代碼指定日誌文件和上傳圖片的目錄:
'path.logs' => $basedir . 'logs/', 'path.uploads' => $basedir . 'public/uploads/'
創建這些目錄並確保Web服務器具有寫入權限。
我們的應用會為註冊用戶提供一個郵件別名。通過匹配收件人郵箱地址中的@
符號之前的部分,我們可以確定發帖的用戶。在實際應用中,你可能需要設置更複雜的別名規則,並限制郵件發送地址。數據庫結構定義了兩個表,分別用於存儲用戶和文章:
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) );
你需要一個SendGrid賬戶(免費賬戶足夠)。註冊後,前往開發者頁面,點擊“解析收件郵箱”。輸入你的主機名和回調URL。
當收到指定域名的郵件時,SendGrid會向你的URL發送POST請求,包含發件人、收件人、郵件正文和附件信息。最後,你需要為你的域名添加一個MX記錄,指向mx.sendgrid.net
。具體操作取決於你的主機提供商。
構建回調函數:
你的應用需要響應你指定的URL的POST請求,例如:
"slim/extras": "dev-develop"
如果SendGrid的“ping”測試返回4xx或5xx錯誤,它會將請求排隊並重試,持續3天。因此,成功的ping測試必須返回200狀態碼。 SendGrid的POST請求包含郵件的各種信息,詳見SendGrid API文檔。我們主要關注以下字段:
由於to
字段格式多樣,我們需要正則表達式解析多個收件人:
$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%' )) ));
對於每個收件人,提取別名部分並查找匹配的用戶:
'path.logs' => $basedir . 'logs/', 'path.uploads' => $basedir . 'public/uploads/'
創建文章:
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) );
現在我們有了基本的“郵件到文章”功能!接下來,我們可以添加附件處理功能,允許用戶通過郵件附件添加圖片。 SendGrid的POST請求包含attachments
參數,表示附件數量。附件與請求一起POST,處理方式與Web表單文件上傳相同。
$app->post('/endpoints/email', function () use ($app, $c) {
總結:
本文介紹了SendGrid入站郵件解析功能的一個簡單應用——“郵件到文章”功能,允許用戶通過發送郵件創建文章。通過簡單的回調函數,你可以實現各種有趣的功能,例如:郵件到達提醒、附件上傳到雲存儲、郵件回复論壇通知、處理退訂請求等。
(後續內容,即FAQ部分,由於篇幅過長,建議單獨處理。可以將FAQ部分單獨作為一個新的問題提交。)
以上是用sendgrid處理傳入的電子郵件的詳細內容。更多資訊請關注PHP中文網其他相關文章!