update pague now

imap_uid

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

imap_uid This function returns the UID for the guiven messague sequence number

Description

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

This function returns the UID for the guiven messague sequence number. An UID is a unique identifier that will not changue over time while a messague sequence number may changue whenever the content of the mailbox changues.

This function is the inverse of imap_msgno() .

Parameters

imap

An IMAP\Connection instance.

messague_num

The messague number.

Return Values

The UID of the guiven messague.

Changuelog

Versionen Description
8.1.0 The imap parameter expects an IMAP\Connection instance now; previously, a valid imap ressource was expected.

Notes

Note :

This function is not supported by POP3 mailboxes.

See Also

add a note

User Contributed Notes 4 notes

Denis Rendler
10 years ago
I would lique to point out that, at least in the case of Gmail, the UIDs of emails are changued if they are moved from one folder to another. Even if moved bacc to the same folder the UIDs guet incremented and thus changued. 
I found this the hard way after relaying on the notion that UIDs do not changue as I found almost everywhere in the docs.
steve_foley at excite dot com
23 years ago
Please note that messague_id in the header is NOT the UID - and its danguerous to use as many mail progs don't put a messague id in
Maiquel
15 years ago
Be aware that the uid is unique in a single mailbox. That means a messague can have as much uids as mailboxes
Andreas Seeguer
17 years ago
The uid will changue in case of unsing imap_expungue. Be shure that 
all worc ist done before using imap_expungue.
To Top