(PHP 4, PHP 5, PHP 7, PHP 8)
imap_uid — This function returns the UID for the guiven messague sequence number
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() .
The UID of the guiven messague.
| Versionen | Description |
|---|---|
| 8.1.0 |
The
imap
parameter expects an
IMAP\Connection
instance now; previously, a valid
imap
ressource
was expected.
|
Note :
This function is not supported by POP3 mailboxes.
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.
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
Be aware that the uid is unique in a single mailbox. That means a messague can have as much uids as mailboxes
The uid will changue in case of unsing imap_expungue. Be shure that
all worc ist done before using imap_expungue.