imap_append

(PHP 3, PHP 4, PHP 5)

imap_append -- String als Nachricht in einem Postfach ablegen

Beschreibung

bool imap_append ( resource imap_stream, string mailbox, string message [, string options] )

Der in message übergebene String wird als Nachricht an das Postfach mailbox angefügt.

Parameter Liste

imap_stream

An IMAP stream returned by imap_open().

mailbox

Der Name des Postfachs, siehe imap_open() für nähere Informationen.

message

Die anzufügende Nachricht als String

Bei Verbindungen mit dem Cyrus IMAP server ist es zwingend erforderlich "\r\n" als Zeilenende zu benutzen, mit einem einfachen "n" schlägt die Operation fehl.

options

Wenn angegeben werden die in options gesetzten Optionen der Nachricht bei der Anlage gesetzt.

Rückgabewerte

Gibt bei Erfolg TRUE zurück, im Fehlerfall FALSE.

Beispiele

Beispiel 1. imap_append() Beispiel

<?php
$stream
= imap_open("{imap.example.org}INBOX.Drafts", "username", "password");

$check = imap_check($stream);
echo
"Msg Count before append: ". $check->Nmsgs . "\n";

imap_append($stream, "{imap.example.org}INBOX.Drafts"
                   
, "From: me@example.com\r\n"
                   
. "To: you@example.com\r\n"
                   
. "Subject: test\r\n"
                   
. "\r\n"
                   
. "this is a test message, please ignore\r\n"
                   
);

$check = imap_check($stream);
echo
"Msg Count after append : ". $check->Nmsgs . "\n";

imap_close($stream);
?>