JavaScript Editor Javascript debugger     Website design 


imap_append

Append a string message to a specified mailbox (PHP 4, PHP 5)
bool imap_append ( resource imap_stream, string mailbox, string message [, string options] )

Appends a string message to the specified mailbox.

Parameters

imap_stream

An IMAP stream returned by imap_open().

mailbox

The mailbox name, see imap_open() for more information

message

The message to be append, as a string

When talking to the Cyrus IMAP server, you must use "\r\n" as your end-of-line terminator instead of "\n" or the operation will fail

options

If provided, the options will also be written to the mailbox

Return Values

Returns TRUE on success or FALSE on failure.

Examples

Example 1044. imap_append() example

<?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);
?>