PHP Conference Japan 2024

imap_uid

(PHP 4, PHP 5, PHP 7, PHP 8)

imap_uid此函数返回给定邮件序列号的 UID

描述

imap_uid(IMAP\Connection $imap, int $message_num): int|false

此函数返回给定邮件序列号的 UID。UID 是一个唯一的标识符,它不会随着时间的推移而改变,而邮件序列号可能会在邮箱内容发生变化时改变。

此函数是 imap_msgno() 的反函数。

参数

imap

一个 IMAP\Connection 实例。

message_num

邮件编号。

返回值

给定邮件的 UID。

变更日志

版本 描述
8.1.0 imap 参数现在需要一个 IMAP\Connection 实例;以前,需要一个有效的 imap 资源

备注

注意:

此函数不受 POP3 邮箱支持。

参见

添加备注

用户贡献的笔记 4 个笔记

8
Denis Rendler
9 年前
我想指出,至少在 Gmail 的情况下,如果将电子邮件从一个文件夹移动到另一个文件夹,则电子邮件的 UID 会发生更改。即使移动回同一文件夹,UID 也会递增并因此更改。
在我几乎在所有文档中都发现 UID 不会更改的概念后,我以这种艰难的方式发现了这一点。
5
steve_foley at excite dot com
22 年前
请注意,标题中的 message_id 不是 UID - 并且使用它很危险,因为许多邮件程序都不会放入 message_id
4
Maikel
14 年前
请注意,uid 在单个邮箱中是唯一的。这意味着一条邮件可以拥有与邮箱数量一样多的 uid
2
Andreas Seeger
16 年前
如果使用 imap_expunge,uid 将会改变。确保
所有工作都在使用 imap_expunge 之前完成。
To Top