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 則筆記

Denis Rendler
9 年前
我想指出的是,至少在 Gmail 的情況下,如果電子郵件從一個資料夾移動到另一個資料夾,其 UID 就會改變。即使移回同一個資料夾,UID 也會遞增,因此會發生變化。
我在依賴幾乎所有文件中都提到的 UID 不會改變的概念後,以慘痛的教訓學到這一點。
steve_foley at excite dot com
22 年前
請注意,標頭中的 message_id 不是 UID,而且使用它很危險,因為許多郵件程式不會放入 message_id。
Maikel
14 年前
請注意,uid 在單一郵箱中是唯一的。這表示一封郵件可以擁有與郵箱數量一樣多的 uid。
Andreas Seeger
16 年前
如果使用 imap_expunge,uid 將會改變。請確保
在使用 imap_expunge 之前,所有工作都已完成。
To Top