PHP 8.2中imap_search的SUBJECT/FROM条件在mail.ru服务器失效求助

核心原因 #

Mail.ru的IMAP服务器对搜索条件的字符编码处理逻辑特殊，直接传入UTF-8字符串（即使指定charset: 'UTF-8'）无法被正确解析，导致SUBJECT、FROM这类文本匹配条件失效，但时间、状态类条件（OLD、UNSEEN等）不受编码影响，因此可正常工作。

可行解决方案 #

1. 用imap_utf8()转换搜索关键词 #

将非ASCII的主题/发件人关键词通过imap_utf8()转换为IMAP兼容编码，再拼入搜索条件：

$subject = imap_utf8("Тест");
$results = imap_search(
    imap: $inbox,
    criteria: "SUBJECT \"$subject\"",
    charset: 'UTF-8'
);

2. 手动编码为RFC 2047格式 #

如果imap_utf8()不生效，可手动将关键词编码为Mail.ru服务器兼容性更好的RFC 2047格式：

function encodeImapKeyword(string $keyword): string {
    return '=?UTF-8?B?' . base64_encode($keyword) . '?=';
}

$encodedSubject = encodeImapKeyword("Тест");
$results = imap_search(
    imap: $inbox,
    criteria: "SUBJECT \"$encodedSubject\"",
    charset: 'UTF-8'
);

3. 本地过滤替代IMAP服务器搜索 #

若上述方法均无效，可先拉取邮件概览信息，再在本地完成主题/发件人匹配：

// 拉取全部邮件概览（可先加状态条件缩小范围）
$overview = imap_fetch_overview($inbox, '1:*', FT_UID);
$targetSubject = "Тест";
$matchedUids = [];

foreach ($overview as $msg) {
    // 解码服务器返回的编码主题
    $decodedSubject = imap_mime_header_decode($msg->subject)[0]->text;
    if ($decodedSubject === $targetSubject) {
        $matchedUids[] = $msg->uid;
    }
}

// $matchedUids 即为符合条件的邮件UID集合

额外注意事项 #

• 连接Mail.ru IMAP服务器时，确保使用imap.mail.ru地址、993端口（SSL加密），连接参数可添加OP_READONLY | OP_SECURE保障稳定性。
• 测试英文关键词时，可尝试移除引号再执行搜索，部分服务器对引号的解析逻辑存在差异。

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