核心要點(diǎn)

• Laravel 的命令行工具 Artisan 可以擴(kuò)展為接收原始郵件並在應(yīng)用程序中使用它。這涉及創(chuàng)建新的命令，例如 php artisan email:parse，該命令可以在 Artisan 中註冊(cè)並執(zhí)行以從 IO 流中檢索原始郵件。
• 使用 php-mime-mail-parser 等包可以將原始郵件解析為單獨(dú)的部分。這允許檢索郵件的主題和正文等標(biāo)頭。然後可以輕鬆地將解析後的郵件存儲(chǔ)在數(shù)據(jù)庫(kù)中。
• 此設(shè)置還可以處理郵件中的任何附件。檢索附件後，可以創(chuàng)建文件系統(tǒng)對(duì)像以將文件保存在服務(wù)器上。此外，根據(jù)使用的工具或郵件服務(wù)器，可以使用不同的方法將郵件傳遞到應(yīng)用程序。

引言

在項(xiàng)目管理或支持管理工具中，您會(huì)經(jīng)?？吹竭@種情況：您可以回復(fù)電子郵件，它會(huì)自動(dòng)顯示在 Web 應(yīng)用程序中。這些工具能夠?qū)⑦@些電子郵件直接導(dǎo)入其係統(tǒng)。

在本文中，我們將了解如何將電子郵件傳遞到我們的 Laravel 4 應(yīng)用程序。為此，我們從一個(gè)全新的 Laravel 4 項(xiàng)目開始，該項(xiàng)目通過 Composer 安裝，如下所示。

composer create-project laravel/laravel your-project-name --prefer-dist

創(chuàng)建 Artisan 命令

為了能夠?qū)㈦娮余]件導(dǎo)入我們的應(yīng)用程序，我們必須通過命令行將電子郵件傳遞到我們的應(yīng)用程序。幸運(yùn)的是，Laravel 有一個(gè)名為 Artisan 的命令行工具，它能夠執(zhí)行多個(gè)任務(wù)。要查看 Artisan 可以運(yùn)行的所有任務(wù)的列表，您可以在項(xiàng)目的根目錄中運(yùn)行 php artisan list。

在這種情況下，我們希望它執(zhí)行一項(xiàng)非常具體的任務(wù)：接受原始電子郵件並在我們的應(yīng)用程序中使用它。不幸的是，這不是 Artisan 可以處理的基本功能之一。我們可以使用新命令輕鬆擴(kuò)展它：php artisan email:parse。然後，我們將啟動(dòng) Artisan 並執(zhí)行特定任務(wù)，在本例中稱為 email:parse。

我們的第一步是創(chuàng)建此命令。您可以通過 Artisan 自己的創(chuàng)建新命令的命令來創(chuàng)建新命令。只需在項(xiàng)目的根目錄中運(yùn)行以下命令：

php artisan command:make EmailParserCommand

如果一切順利，您現(xiàn)在將在 app/commands 目錄中找到一個(gè)名為 EmailParserCommand.php 的文件。在您喜歡的編輯器中打開它，並查看 $name 和 $description 屬性。我們可以根據(jù)需要自定義它。通過為其提供清晰的名稱和描述，該命令將在 Artisan 命令列表中很好地列出。

例如，我將其更改為此：

/**
 * 控制臺(tái)命令名稱。
 *
 * @var string
 */
protected $name = 'email:parse';

/**
 * 控制臺(tái)命令描述。
 *
 * @var string
 */
protected $description = '解析傳入的電子郵件。';

註冊(cè)命令

當(dāng)我們?cè)陧?xiàng)目的根目錄中運(yùn)行 php artisan email:parse 時(shí)，您將收到一條消息，指出此命令尚未註冊(cè)。我們的下一步是確保此命令在 Artisan 中註冊(cè)。讓我們打開 app/start/artisan.php 文件，並將 Artisan::add(new EmailParserCommand); 添加到文件的末尾以註冊(cè)我們新創(chuàng)建的命令。我們現(xiàn)在可以再次運(yùn)行 list 命令來查看我們列出的 email:parse 命令。請(qǐng)注意，您剛剛填寫的名稱和描述將在此處顯示。

檢索原始電子郵件

每當(dāng)通過 Artisan 調(diào)用命令時(shí)，它總是會(huì)調(diào)用 fire 方法。因此，最初我們必須在此處添加我們的電子郵件解析。電子郵件當(dāng)前位於我們的 IO 流中，我們可以從 php://stdin 中檢索它。我們打開此 IO 流，然後收集少量電子郵件，直到我們讀取整個(gè)流。

composer create-project laravel/laravel your-project-name --prefer-dist

發(fā)送到我們的 Artisan 命令的電子郵件現(xiàn)在位於 $rawEmail 變量中。它是整個(gè)電子郵件，包含標(biāo)頭、正文和任何附件。

解析電子郵件

我們現(xiàn)在有了原始電子郵件，但我更希望將電子郵件分成多個(gè)部分。我想檢索諸如主題和郵件正文之類的標(biāo)頭。我們可以編寫我們自己的代碼來分割所有這些部分，但有人已經(jīng)創(chuàng)建了一個(gè)我們可以在我們的應(yīng)用程序中使用的包。此包能夠?qū)⑽覀兊恼麄€(gè)電子郵件分成邏輯部分。將以下行添加到您的 composer.json 文件中並運(yùn)行 composer update

php artisan command:make EmailParserCommand

現(xiàn)在我們需要確保我們實(shí)際上可以在我們的命令中使用此包，因此我們?cè)俅未蜷_我們的 app/command/EmailParserCommand.php，並將以下幾行添加到頂部：

/**
 * 控制臺(tái)命令名稱。
 *
 * @var string
 */
protected $name = 'email:parse';

/**
 * 控制臺(tái)命令描述。
 *
 * @var string
 */
protected $description = '解析傳入的電子郵件。';

現(xiàn)在我們可以將原始電子郵件解析為單獨(dú)的部分。將以下幾行代碼添加到 fire 方法的末尾。

/**
 * 執(zhí)行控制臺(tái)命令。
 *
 * @return void
 */
public function fire()
{
    // 從 stdin 讀取
    $fd = fopen("php://stdin", "r");
    $rawEmail = "";
    while (!feof($fd)) {
        $rawEmail .= fread($fd, 1024);
    }
    fclose($fd);
}

我們首先創(chuàng)建一個(gè)新的解析器。接下來，我們將原始電子郵件設(shè)置為解析器的文本，最後，我們調(diào)用各種不同的方法來從標(biāo)頭或正文中獲取數(shù)據(jù)。

您現(xiàn)在可以輕鬆地將電子郵件存儲(chǔ)在數(shù)據(jù)庫(kù)中。例如，如果您有一個(gè)電子郵件實(shí)體，您可以像這樣將電子郵件保存到您的數(shù)據(jù)庫(kù)：

"messaged/php-mime-mail-parser": "dev-master"

處理附件

您甚至可能希望將附加到電子郵件的任何附件存儲(chǔ)在您的服務(wù)器上。電子郵件解析器類可以處理任何可用的附件。首先，再次將以下幾行添加到 app/command/EmailParserCommand.php 類的頂部。

use MimeMailParser\Parser;

現(xiàn)在我們必須用一些將處理附件的代碼擴(kuò)展我們的 fire 方法：

composer create-project laravel/laravel your-project-name --prefer-dist

讓我們看看這部分實(shí)際上做了什麼。第一行從電子郵件中檢索附件。 $attachments 變量是一個(gè)附件對(duì)象的數(shù)組。接下來，我們確保創(chuàng)建了一個(gè)新的 FileSystem 對(duì)象，它將處理在我們的服務(wù)器上保存文件。然後我們開始迭代所有附件。我們調(diào)用 FileSystem 對(duì)象的 put 方法，它接受文件的路徑和內(nèi)容。在這種情況下，我們想將文件添加到 public/uploads 目錄並使用附件實(shí)際具有的文件名。第二個(gè)參數(shù)是實(shí)際文件的內(nèi)容。

就是這樣！您的文件現(xiàn)在存儲(chǔ)在 public/uploads 中。只需確保您的郵件服務(wù)器可以通過設(shè)置正確的權(quán)限來實(shí)際將文件添加到此目錄。

配置我們的郵件服務(wù)器

到目前為止，我們已經(jīng)準(zhǔn)備好了整個(gè)應(yīng)用程序來檢索、分割和保存我們的電子郵件。但是，如果您不知道如何將電子郵件實(shí)際發(fā)送到您新創(chuàng)建的 Artisan 命令，則此代碼毫無用處。

下面您將找到將電子郵件傳遞到您的應(yīng)用程序的不同方法，具體取決於您使用的工具或郵件服務(wù)器。例如，我想將 support@peternijssen.nl 轉(zhuǎn)發(fā)到我的應(yīng)用程序，該應(yīng)用程序位於 /var/www/supportcenter。 請(qǐng)注意，在下面您將看到的實(shí)際命令中，我每次都添加了 --env=local，以確保 Artisan 的運(yùn)行方式就像我們?cè)陂_發(fā)機(jī)器上一樣。如果您處?kù)渡a(chǎn)環(huán)境中，則可以刪除此部分。

CPanel

如果您使用的是 CPanel，您可以點(diǎn)擊常規(guī)菜單中的轉(zhuǎn)發(fā)器。添加一個(gè)新的轉(zhuǎn)發(fā)器並定義您想轉(zhuǎn)發(fā)到您的應(yīng)用程序的地址。單擊高級(jí)設(shè)置並選擇管道到程序選項(xiàng)。 在輸入字段中，您可以插入以下行：

php artisan command:make EmailParserCommand

請(qǐng)注意，CPanel 使用相對(duì)於您的主目錄的路徑。

Exim

如果在 Exim 上，請(qǐng)打開文件 /etc/valiases/peternijssen.nl。 確保此文件中存在以下行：

/**
 * 控制臺(tái)命令名稱。
 *
 * @var string
 */
protected $name = 'email:parse';

/**
 * 控制臺(tái)命令描述。
 *
 * @var string
 */
protected $description = '解析傳入的電子郵件。';

運(yùn)行 newaliases 以重建別名數(shù)據(jù)庫(kù)。

Postfix

在 Postfix 上，請(qǐng)確保在繼續(xù)之前，以下幾行存在於您的 /etc/postfix/main.cf 文件中並且未被註釋：

/**
 * 執(zhí)行控制臺(tái)命令。
 *
 * @return void
 */
public function fire()
{
    // 從 stdin 讀取
    $fd = fopen("php://stdin", "r");
    $rawEmail = "";
    while (!feof($fd)) {
        $rawEmail .= fread($fd, 1024);
    }
    fclose($fd);
}

如果您必須更改文件，請(qǐng)通過運(yùn)行 service postfix reload 來重新加載 postfix。

我們現(xiàn)在可以創(chuàng)建一個(gè)新的別名，它將被傳遞到我們的應(yīng)用程序。 打開 /etc/aliases 並添加以下行：

"messaged/php-mime-mail-parser": "dev-master"

運(yùn)行 newaliases 以重建別名數(shù)據(jù)庫(kù)。

Sendmail

使用 Sendmail，您應(yīng)該首先在 /etc/aliases 文件中創(chuàng)建一個(gè)別名：

use MimeMailParser\Parser;

運(yùn)行 newaliases 以重建別名數(shù)據(jù)庫(kù)。接下來，確保 Artisan 文件的 chmod 為 755，以便可以執(zhí)行。

最後，將 artisan 文件和 php 本身符號(hào)鏈接到 /etc/smrsh

composer create-project laravel/laravel your-project-name --prefer-dist

QMail

根據(jù)您的安裝情況，您必須確保存在以下文件：

php artisan command:make EmailParserCommand

或：

/**
 * 控制臺(tái)命令名稱。
 *
 * @var string
 */
protected $name = 'email:parse';

/**
 * 控制臺(tái)命令描述。
 *
 * @var string
 */
protected $description = '解析傳入的電子郵件。';

打開任一文件並將以下行添加為內(nèi)容：

/**
 * 執(zhí)行控制臺(tái)命令。
 *
 * @return void
 */
public function fire()
{
    // 從 stdin 讀取
    $fd = fopen("php://stdin", "r");
    $rawEmail = "";
    while (!feof($fd)) {
        $rawEmail .= fread($fd, 1024);
    }
    fclose($fd);
}

結(jié)論

任何具有可用命令行工具的框架都能夠處理您的電子郵件。此處提供的代碼只是一個(gè)基本設(shè)置。根據(jù)您的項(xiàng)目，您可能只想允許某些電子郵件地址向您的應(yīng)用程序發(fā)送電子郵件。在傳遞到您的應(yīng)用程序之前，請(qǐng)確保您已經(jīng)在 postfix 等工具中過濾了電子郵件。

如果您想使用某種票務(wù)系統(tǒng)，您可以輕鬆嘗試從電子郵件主題中提取支持票證 ID，並根據(jù)該 ID 對(duì)電子郵件執(zhí)行多個(gè)不同的操作。

密切關(guān)注郵件服務(wù)器的日誌文件。當(dāng)實(shí)際管道在如何解決它方面失敗時(shí)，它會(huì)為您提供一些提示。

(由於篇幅限制，F(xiàn)AQs部分略去。 原FAQs內(nèi)容與文章主題關(guān)聯(lián)性較弱，且部分內(nèi)容與文章內(nèi)容重複，故不進(jìn)行偽原創(chuàng)處理。)

以上是將電子郵件提供給Laravel應(yīng)用程序的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！