萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 使用 IMAP 協議讀取郵件完整教程:從連接到解析

環境準備

  • PHP 安裝 imap 擴展(docker-php-ext-install imap 或 php.ini 啟用 extension=imap)。
  • 郵件服務器開啟 IMAP 服務(如 Gmail 需開啟「不太安全的應用」或使用應用專用密碼)。

連接郵箱服務器

<?php
$mailServer = '{imap.gmail.com:993/imap/ssl}INBOX'; // Gmail 示例
$username = 'your_email@gmail.com';
$password = 'your_app_password'; // 非登錄密碼

$conn = @imap_open($mailServer, $username, $password);
if (!$conn) {
    throw new RuntimeException('IMAP 連接失敗:' . imap_last_error());
}
echo "連接成功!\n";

郵箱格式說明:{host:port/protocol/ssl}mailbox,常見協議 imap、pop3、novalidate-cert(自簽證書)。

獲取郵件列表

<?php
// 獲取所有郵件概覽
$overview = imap_fetch_overview($conn, '1:*', 0);
foreach ($overview as $msg) {
    echo "UID: {$msg->uid} | From: {$msg->from} | Subject: {$msg->subject} | Date: {$msg->date}\n";
}

// 分頁獲取:最新 20 封
$total = imap_num_msg($conn);
$start = max(1, $total - 19);
$overview = imap_fetch_overview($conn, "$start:$total", 0);

讀取單封郵件詳情

<?php
$uid = 12345; // 目標郵件 UID
$header = imap_headerinfo($conn, $uid);
$body = imap_body($conn, $uid, FT_PEEK); // FT_PEEK 不標記已讀

echo "From: {$header->fromaddress}\n";
echo "To: {$header->toaddress}\n";
echo "Subject: {$header->subject}\n";
echo "Date: {$header->date}\n";
echo "Body:\n$body\n";

處理 MIME 多部分郵件(附件/HTML/純文本)

<?php
function parseMimeStructure($structure, $conn, $msgno, &$parts = []) {
    foreach ($structure->parts as $i => $part) {
        $partNum = $i + 1;
        if ($part->ifdisposition && strtolower($part->disposition) === 'attachment') {
            $parts['attachments'][] = [
                'filename' => $part->dparameters[0]->value ?? 'unknown',
                'type' => $part->subtype,
                'size' => $part->bytes,
                'part' => $partNum,
            ];
        } elseif ($part->subtype === 'PLAIN' || $part->subtype === 'HTML') {
            $parts['body'][$part->subtype] = imap_fetchbody($conn, $msgno, $partNum, FT_PEEK);
        } elseif ($part->subtype === 'ALTERNATIVE' || $part->subtype === 'MIXED') {
            parseMimeStructure($part, $conn, $msgno, $parts);
        }
    }
}

$structure = imap_fetchstructure($conn, $uid);
$parts = [];
parseMimeStructure($structure, $conn, $uid, $parts);
// $parts['body']['PLAIN'] 純文本,$parts['body']['HTML'] HTML 版,$parts['attachments'] 附件列表

關閉連接與錯誤處理

imap_close($conn, CL_EXPUNGE); // CL_EXPUNGE 刪除標記為刪除的郵件

生產環境建議:

  • 使用 imap_errors() imap_alerts() 捕獲警告。
  • 長連接複用:imap_open 返回的資源可在請求間復用(需進程模型支援)。
  • 大量郵件分批處理,避免記憶體耗盡。
copyright © 萬盛學電腦網 all rights reserved