imap_msgno

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

imap_msgnoLiefert die Nummer einer Nachricht für eine gegebene UID

Beschreibung

imap_msgno(IMAP\Connection $imap, int $message_uid): int

Gibt die Nummer der Nachricht für message_uid zurück.

Diese Funktion ist das Gegenstück zu imap_uid().

Parameter-Liste

imap

Eine IMAP\Connection-Instanz.

message_uid

Die UID der Nachricht

Rückgabewerte

Gibt die Nummer der Nachricht mit der gegebenen message_uid zurück.

Changelog

Version Beschreibung
8.1.0 Der Parameter imap erwartet nun eine IMAP\Connection-Instanz; vorher wurde eine gültige imap-Ressource erwartet.

Siehe auch

  • imap_uid() - Liefert die UID für die gegebene Nachrichtennummer

add a note add a note

User Contributed Notes 3 notes

up
0
phpdocu at malli dot co dot at
2 years ago
Here is a simple working snippet to properly check the return value of imap_msgno():

$id = imap_msgno($imapConnection, $mailUid); //convert to normal messagenumber in current context
$verifyUid = imap_uid($imapConnection, $id);
if ($verifyUid != $mailUid)
  throw new Exception("Attention: imap_msgno returned nonsense!  The mail was probably not found in the mailbox!");
up
-1
os at simonconsulting dot at
13 years ago
For me, this function returns FALSE if uid does not match a message in the current mailbox.
up
-1
dcridland.at.redwire.com
23 years ago
<p>Note that imap_msgno() doesn't ever give you an error message. So, assuming you're passing about message numbers as a UID, be warned that:</p>
<p>$msguid = false;<br>
$msgno = imap_msgno( $your_initialized_connection, $msguid );</p>
<p>Will leave ($msgno==1) - this is probably not what you want, and it's surprisingly easy to miss while you're doing the basic testing.</p>
To Top