PHP中如何通过imap_search拉取指定UID之后的邮件

IMAP原生支持UID维度的序列搜索，不需要依赖日期参数，直接用UID范围筛选即可实现增量拉取，逻辑比日期筛选更可靠，不会出现时区偏差、同时间多邮件漏拉的问题。

核心实现要点 #

• IMAP搜索语法中使用UID 起始UID:*表示拉取从指定UID开始到邮箱当前最大UID的所有邮件
• 调用imap_search时必须传入SE_UID常量作为参数，否则函数默认返回可变的消息序号而非永久UID
• 后续调用imap_fetchheader、imap_body等读取邮件内容的函数时，需要传入FT_UID常量，标识传入的是邮件UID而非消息序号

完整代码示例 #

// 从本地数据库/配置中读取上次同步完成的最大邮件UID
$lastSyncedUid = 1258;
// 本次拉取的起始UID = 上次最后同步UID + 1
$startFetchUid = $lastSyncedUid + 1;

// 执行UID范围搜索，返回所有未拉取过的邮件UID列表
$mailUids = imap_search(
    $imap,
    "UID {$startFetchUid}:*",
    SE_FREE,
    "UTF-8",
    SE_UID
);

// 搜索返回false代表没有符合条件的新邮件
if (!empty($mailUids)) {
    foreach ($mailUids as $uid) {
        // 按UID读取邮件头、内容等信息
        $mailHeader = imap_fetchheader($imap, $uid, FT_UID);
        $mailBody = imap_body($imap, $uid, FT_UID);
        
        // 执行本地存储逻辑...

        // 单封邮件存储完成后，更新本地记录的最后同步UID为当前邮件UID
        $lastSyncedUid = $uid;
    }
}

优化提示 #

• 如果收件箱邮件量级很大，单次拉取容易超时或内存溢出，可以给每次拉取设置数量上限，比如每次最多拉100封：将搜索条件改为"UID {$startFetchUid}:" . ($startFetchUid + 99)，循环拉取直到返回空结果即可
• 不要使用UID > x这类写法，IMAP标准搜索语法不支持大于号运算符，必须使用序列范围格式，Gmail对该标准语法完全兼容

内容的提问来源于stack exchange，提问作者Googlebot