PHP imap_msgno在邮件移出收件箱后返回0，无法二次移动邮件如何解决

问题根因 #

imap_msgno()的查询范围完全绑定当前IMAP连接打开的文件夹，当邮件被移出收件箱后，如果你仍然使用打开收件箱的连接调用imap_msgno()，自然在当前文件夹下找不到对应UID的邮件，所以返回0。这不是PHP的BUG，是IMAP协议的标准逻辑，和PHP版本、邮箱服务商无关。

核心概念区分 #

• msgno：单文件夹内的临时顺序编号，仅在当前连接打开当前文件夹时有效，文件夹内邮件增减、切换文件夹都会导致编号失效
• UID：单文件夹内的永久唯一编号，仅在当前文件夹内有效，跨文件夹后原UID失效
• Message-ID：邮件本身的全局唯一标识，由发件方生成，跨文件夹、跨邮箱服务商都不会变化，适合跨文件夹追踪邮件

解决方案 #

方案1：切换到目标文件夹后再调用imap_msgno() #

移动邮件完成后，使用imap_reopen()将当前IMAP连接切换到邮件移入的目标文件夹，再传入目标文件夹内对应邮件的UID查询，即可得到正确的msgno，示例代码如下：

// 连接打开收件箱
$conn = imap_open('{imap.example.com:993/imap/ssl}INBOX', '账号', '密码');
$target_folder = 'Archive';
$inbox_mail_uid = 123;

// 移动邮件
imap_mail_move($conn, (string)imap_msgno($conn, $inbox_mail_uid), $target_folder);
imap_expunge($conn);

// 切换到目标文件夹
imap_reopen($conn, '{imap.example.com:993/imap/ssl}' . $target_folder);
// 此时查询目标文件夹内的邮件即可得到正确的msgno
// 注意：移动后邮件的UID可能发生变化，可通过Message-ID定位到目标邮件再获取对应UID

方案2：直接使用FT_UID参数跳过imap_msgno()转换步骤 #

imap_mail_move()支持传入第四个参数FT_UID，声明你传入的第一个参数是UID而非msgno，完全不需要提前调用imap_msgno()做转换，从根源避开这个问题，同时也符合直接传UID操作的需求，示例代码如下：

$conn = imap_open('{imap.example.com:993/imap/ssl}INBOX', '账号', '密码');
$mail_uid = 456; // 收件箱内邮件的UID

// 传入FT_UID参数直接使用UID移动邮件，无需转msgno
$move_result = imap_mail_move($conn, (string)$mail_uid, 'Trash', FT_UID);
if ($move_result) {
    imap_expunge($conn);
}
imap_close($conn);

方案3：跨文件夹追踪邮件用Message-ID #

如果需要长期跨文件夹操作同一封邮件，不要依赖UID，在邮件还在收件箱时读取Message-ID头信息存储，后续在任意文件夹都可以通过搜索Message-ID定位到对应邮件，再获取msgno或UID。

报错原因说明 #

你遇到的COPY Command arguments invalid报错，是因为你直接传UID给imap_mail_move()时没有加FT_UID参数，函数将你的UID识别为msgno，而对应msgno的邮件不存在，所以触发参数无效错误。

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