imap 擴展(docker-php-ext-install imap 或 php.ini 啟用 extension=imap)。<?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";
<?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 返回的資源可在請求間復用(需進程模型支援)。