imap_uid

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

imap_uidNumarası belirtilen iletiyle ilgili eşsiz kimliği döndürür

Açıklama

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

Numarası belirtilen iletiyle ilgili eşsiz kimliğini döndürür. Adından anlaşılacağı gibi eşsiz kimlik eşsiz bir betimleyici olup posta kutusundaki her değişiklikte ileti numarası değişse bile o değişmez.

Bu işlev, imap_msgno() işlevinin tersidir.

Bağımsız Değişkenler

imap

IMAP\Connection nesnesi.

ileti_num

İleti numarası.

Dönen Değerler

Belirtilen iletinin eşsiz kimliği döner.

Sürüm Bilgisi

Sürüm: Açıklama
8.1.0 imap bağımsız değişkeni artık IMAP\Connection nesnesi kabul ediyor, evvelce resource türünde geçerli bir imap değeri kabul ederdi.

Notlar

Bilginize:

Bu işlev POP3 posta kutularında kullanılamaz.

Ayrıca Bakınız

  • imap_msgno() - Belirtilen eşsiz kimlik için ileti numarasını döndürür

add a note add a note

User Contributed Notes 7 notes

up
9
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.
up
5
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
up
4
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
up
2
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.
up
-2
cmanley at example dot com
6 years ago
If you want emulated POP3 UIDL support, then you can either use my imap function wrapper class, or just copy/modify it's header to UIDL hashing method:
https://github.com/cmanley/PHP-IMAP-Client/
up
-6
anon et mouse
15 years ago
clarification for Andreas' note about imap_expunge()...

imap_expunge() does indeed change the UID, but only *after* the IMAP stream has closed and then reconnects.

You can use imap_expunge() as many times as you want within one IMAP stream (no reconnects) and the UID stays the same while the Msgno will change with imap_delete() followed by imap_expunge().
up
-6
roger at sdr dot com dot au
16 years ago
A little quirk of UIDs in a PUBLIC folder in MDaemon (and perhaps other servers?). The UIDs may be unsynchronised between users if the server's option to store flags on a per-user basis is turned on. That is, a message may have a UID of 5 for one user (meaning it was the 5th message to enter the box) but 3 for another user (who perhaps subscribed to the box later). If this is a problem, turn off the per-user option for the mailbox.
To Top