如何在IMAP下载邮件时，应对uid与msgno变动实现可靠操作？

Great question—this is a super common gotcha with IMAP since both msgno and UID have limitations depending on what you're trying to do. Let's break down how to handle this reliably in PHP:

1. Use UIDs, but pair them with folder context #

UIDs are unique within a specific folder, but they reset when a message is moved to another folder. So if you're storing identifiers for later use, don't just save the UID—save the UID plus the folder path/name it came from.

In PHP, you can fetch UIDs directly with imap_search() by passing the SE_UID flag:

// Get UIDs instead of msgno values
$uids = imap_search($imapConnection, 'UNSEEN', SE_UID);

When you need to fetch the message later, make sure you're in the same folder, then use UID-aware functions (or convert the UID back to a msgno with imap_msgno()—but this only works if the message is still in that folder).

2. Use Message-ID for persistent, cross-folder tracking #

The most reliable way to reference a message long-term is its Message-ID—this is a unique header set by the sending server, and it never changes even if the message is moved, copied, or forwarded.

First, fetch the Message-ID when you initially process the message:

$header = imap_headerinfo($imapConnection, $msgno);
$messageId = $header->message_id;
// Store this Message-ID somewhere (database, file, etc.)

Later, to find the message again (even if it's moved), search for it using the Message-ID header:

// Search for the message by its Message-ID
$matchingMsgNos = imap_search($imapConnection, "HEADER Message-ID \"$messageId\"");
if (!empty($matchingMsgNos)) {
    $targetMsgNo = $matchingMsgNos[0];
    // Fetch the message content using $targetMsgNo
}

Just make sure to quote the Message-ID properly in the search query to avoid syntax issues (many Message-IDs contain angle brackets or special characters).

3. Avoid relying on msgno for anything permanent #

msgno values are just the current position of the message in the folder—add or delete a message, and all subsequent msgno values shift. They're only safe to use for immediate, short-lived operations (like fetching a message right after you run imap_search(), with no chance of folder changes in between).

4. Handle message moves gracefully #

If your script needs to track messages that might be moved:

• Start by storing the Message-ID, folder, and UID
• When you need to access the message again, first try using the stored folder + UID
• If that fails (e.g., imap_fetchbody() returns false), fall back to searching the entire mailbox for the Message-ID, then update your stored folder and UID once you find it

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