imap_open

Beschreibung

Diese Funktion liefert ein Verbindungs-Handle bzw. FALSE bei evtl. auftretenden Fehlern. Verbindungen können nicht nur zu IMAP-, sondern auch zu POP- oder NNTP-Servern aufgebaut werden, wobei dann allerdings nicht der gesamte Funktionsumfang zur Verfügung steht. Liefert ein IMAP-Streamhandle oder FALSE bei Fehlern.

Der Name eines Postfachs setzt sich zusammen aus der Bezeichnung des Servers und dem Pfad des Postfachs auf diesem Server. Der spezielle Name INBOX steht dabei als Synonym für das persönliche Postfach des jeweiligen Benutzers. Die Bezeichnung des Servers setzt sich zusammen aus dem eigentlichen Servernamen oder der entsprechenden IP-Adresse sowie das gewünschte Protokoll (getrennt durch '/') und optional der zu benutzende Port (getrennt durch ':'). Die gesamte Serverbezeichnung wird in '{' und '}' eingeschlossen und muß immer mit angegeben werden. Enthält der Name eines Postfachs Zeichen außerhalb des druckbaren ASCII-Bereiches wie z.B. Umlaute oder das 'ß', so muß er mit Hilfe der Funktion imap_utf7_encode() codiert werden.

Der optionale Parameter flags kann sich aus den folgenden Bitmasken zusammensetzen:

• OP_READONLY - Über diese Verbindung darf nur lesend zugegriffen werden

• OP_ANONYMOUS - Bei NNTP-Verbindungen wird die Datei .newsrc nicht aktualisiert

• OP_HALFOPEN - es wird eine IMAP- oder NNTP-Verbindung aufgebaut, aber noch kein Postfach ausgewählt

• CL_EXPUNGE - beim Schließen der Verbindung werden alle zum Löschen vorgemerkte Nachrichten endgültig gelöscht (siehe auch imap_delete() und imap_expunge())

Das folgende Beispiel stellt eine Verbindung zu einem lokalen IMAP-Server (IMAP = Port 143) her:

$mbox = imap_open ("{localhost:143}INBOX", "user_id", "password");

$mbox = imap_open ("{localhost/pop3:110}INBOX", "user_id", "password");

$nntp = imap_open ("{localhost/nntp:119}comp.test", "", "");

Beispiel 1. imap_open() Beispiel $mbox = imap_open ("{your.imap.host:143}", "username", "password"); echo "<p><h1>Mailboxes</h1>\n"; $folders = imap_listmailbox ($mbox, "{your.imap.host:143}", "*"); if ($folders == false) echo "Call failed<br>\n"; else while (list ($key, $val) = each ($folders)) echo $val . "<br>\n"; echo "<p><h1>Headers in INBOX</h1>\n"; $headers = imap_headers ($mbox); if ($headers == false) echo "Call failed<br>\n"; else while (list ($key, $val) = each ($headers)) echo $val . "<br>n"; imap_close ($mbox);