PHP IMAP问题：获取Gmail邮件时消息仍被标记为已读

我之前帮不少开发者踩过Gmail IMAP这个坑——明明加了FT_PEEK和OP_READONLY，但邮件还是被标记成已读。这主要是因为Gmail的IMAP实现有一些非标准的行为，咱们一步步来解决：

核心原因分析 #

Gmail的IMAP对「已读（\Seen）」标记的处理和标准IMAP不太一样：

• 即使你用了OP_READONLY打开邮箱，某些fetch操作如果没有明确指定不修改标记，Gmail可能还是会触发\Seen标记
• 单独在fetch函数里加FT_PEEK有时候不够，因为Gmail的全局IMAP设置可能会覆盖这个选项

分步解决方案 #

1. 升级IMAP连接字符串，全局禁用已读标记 #

在你的连接地址里加上/peek参数，这会告诉Gmail的IMAP服务器全程不要设置\Seen标记，比单独在fetch里加选项更可靠：

CONST HOSTNAME='{imap.gmail.com:993/imap/ssl/readonly/peek}INBOX';

这里的/readonly确保你只能读取邮件，/peek强制服务器不修改任何标记。

2. 确保所有fetch操作都明确使用FT_PEEK #

即使加了全局的/peek，也建议在每个获取邮件内容的函数里都加上FT_PEEK选项，双重保险：

// 获取邮件概览时加FT_PEEK
$overview = imap_fetch_overview($imap, $num, FT_PEEK);
// 获取邮件正文时加FT_PEEK
$body = imap_fetchbody($imap, $num, 1, FT_PEEK);
// 获取邮件头时也加上FT_PEEK
$header = imap_fetchheader($imap, $num, FT_PEEK);

注意：imap_headerinfo函数默认不会触发已读标记，但如果你需要更细致的控制，还是建议用imap_fetchheader加FT_PEEK。

3. 检查Gmail账户的IMAP设置 #

登录你的Gmail账号，进入「设置」→「查看所有设置」→「转发和POP/IMAP」→「IMAP访问」，确认以下选项：

• 找到「当邮件在IMAP中被访问时」，选择「不要自动标记为已读」
• 确保「当IMAP客户端标记邮件为已读时」的设置符合你的预期（一般选「立即标记」即可，但如果有冲突可以调整）

4. 排查代码中的误操作 #

检查你的getMessagesSince方法里有没有不小心设置\Seen标记的代码，比如：

• 有没有调用imap_setflag_full($imap, $num, '\\Seen')？
• 有没有用imap_clearflag_full清除其他标记时误碰了\Seen？
• 有没有在imap_close时用了CL_EXPUNGE参数？（这个会删除已标记为删除的邮件，但不会直接标记已读，但还是要确认）

修改后的示例代码 #

class imap{
    CONST HOSTNAME='{imap.gmail.com:993/imap/ssl/readonly/peek}INBOX';
    CONST USERNAME = '[Address hidden]';
    CONST PASSWORD = '[Password hidden]'; //App password from Google

    function getMessagesSince($date){
        $messages=array();
        $imap = imap_open(self::HOSTNAME, self::USERNAME, self::PASSWORD);
        
        if(!$imap){
            error_log('IMAP连接失败: ' . imap_last_error());
            return $messages;
        }

        // 搜索指定日期后的邮件
        $msgNums = imap_search($imap, 'SINCE "' . $date . '"');
        
        if($msgNums){
            foreach($msgNums as $num){
                // 用FT_PEEK获取邮件概览
                $overview = imap_fetch_overview($imap, $num, FT_PEEK);
                if(!$overview) continue;

                // 用FT_PEEK获取邮件正文（这里取的是纯文本部分，根据需要调整参数）
                $body = imap_fetchbody($imap, $num, 1, FT_PEEK);
                // 如果是base64编码的正文，需要解码
                $body = imap_base64($body);

                $messages[] = [
                    'subject' => imap_utf8($overview[0]->subject),
                    'from' => $overview[0]->from,
                    'date' => $overview[0]->date,
                    'body' => $body
                ];
            }
        }

        // 关闭连接，不要用CL_EXPUNGE避免误操作
        imap_close($imap);
        return $messages;
    }
}

最后验证 #

修改完后，测试一下：

1. 找一封未读邮件
2. 调用你的getMessagesSince方法获取这封邮件
3. 打开Gmail网页版，确认邮件还是未读状态

如果还是有问题，可以检查一下是否有其他IMAP客户端（比如手机邮件APP）在同步时标记了已读，或者尝试用Gmail的「邮件ID（UID）」来获取邮件，而不是用邮件序号（因为邮件序号可能会变化）。

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