PHP Conference Nagoya 2025

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; раньше параметр ждал ресурс (resource) imap.

Примечания

Замечание:

Эта функция не поддерживается для почтовых ящиков POP3.

Смотрите также

  • imap_msgno() - Получает номер сообщения с заданным UID

Добавить

Примечания пользователей 4 notes

up
8
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
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
4
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
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.
To Top