imap_uid
(PHP 4, PHP 5, PHP 7, PHP 8)
imap_uid — 指定したメッセージシーケンス番号の UID を返す
説明
この関数は、指定したメッセージシーケンス番号の UID を返します。 メッセージ番号はメールボックスの内容を変更する度に変わる可能性が ありますが、UID はユニークな ID であり時間が経過しても変わりません。
この関数は、imap_msgno() の逆関数です。
戻り値
指定したメッセージの UID を返します。
変更履歴
バージョン | 説明 |
---|---|
8.1.0 |
引数 imap は、IMAP\Connection
クラスのインスタンスを期待するようになりました。
これより前のバージョンでは、有効な imap リソース が期待されていました。
|
注意
注意:
この関数は、POP3 メールボックスではサポートされません。
+add a note
User Contributed Notes 4 notes
Denis Rendler ¶
9 years ago
I would like to point out that, at least in the case of Gmail, the UIDs of emails are changed if they are moved from one folder to another. Even if moved back to the same folder the UIDs get incremented and thus changed.
I found this the hard way after relaying on the notion that UIDs do not change as I found almost everywhere in the docs.
steve_foley at excite dot com ¶
22 years ago
Please note that message_id in the header is NOT the UID - and its dangerous to use as many mail progs don't put a message id in
Maikel ¶
14 years ago
Be aware that the uid is unique in a single mailbox. That means a message can have as much uids as mailboxes
Andreas Seeger ¶
16 years ago
The uid will change in case of unsing imap_expunge. Be shure that
all work ist done before using imap_expunge.