imap_append

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

    imap_append — Hängt eine String-Nachricht an ein Postfach an

    Beschreibung

    imap_append(
        IMAP\Connection$imap,
        string$folder,
        string$message,
        ?string$options = null,
        ?string$internal_date = null
    ): bool

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

    Parameter-Liste

    imap

    Eine IMAP\Connection-Instanz.

    folder

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

    Warnung

    Die Übergabe von nicht vertrauenswürdigen Daten an diesen Parameter ist unsicher,falls imap.enable_insecure_rsh nicht deaktiviert ist.

    message

    Die anzufügende Nachricht als String

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

    options

    Wenn angegeben, werden die in options gesetzten Optionen auch ins Postfach folder geschrieben.

    internal_date

    Wenn dieser Parameter angegeben wird, wird das INTERNALDATE für die hinzugefügte Nachricht gesetzt. Der Parameter sollte ein Datumsstring sein, der den rfc2060-Spezifikationen für einen date_time-Wert entspricht.

    Rückgabewerte

    Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.

    Changelog

    VersionBeschreibung
    8.1.0 Der Parameter imap erwartet nun eine IMAP\Connection-Instanz; vorher wurde eine gültige imap-Ressource erwartet.
    8.0.0options und internal_date sind jetzt nullable (akzeptieren den null-Wert).

    Beispiele

    Beispiel #1 imap_append()-Beispiel

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

    $check = imap_check($imap);
    echo     "Anzahl der Nachrichten vor dem Anhängen: ". $check->Nmsgs . "\n";

    imap_append($imap, "{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($imap);
    echo     "Anzahl der Nachrichten nach dem Anhängen: ". $check->Nmsgs . "\n";

    imap_close($imap);
    ?>
    To Top