imap_append

(PHP 4, PHP 5, PHP 7)

imap_append — Добавляет строковое сообщение в указанный почтовый ящик

Описание

imap_append ( resource $imap_stream , string $mailbox , string $message , string $options = null , string $internal_date = null ) : bool

Добавляет строку message в указанный mailbox.

Список параметров

imap_stream

Поток IMAP, полученный из imap_open().

mailbox

Имя почтового ящика. Смотрите imap_open() для подробной информации.

Внимание

Если imap.enable_insecure_rsh не отключен, то передача в этот параметр не проверенных данных не безопасна.

message

Добавляемое сообщение в виде строки

При обращении к серверу Cyrus IMAP следует использовать "\r\n" как завершающий символ строки вместо "\n", иначе операция будет неудачна.

options

Если указан, то параметр options также будет записан в mailbox

internal_date

Если этот параметр указан, он установит INTERNALDATE в добавляемом сообщении. Параметр должен содержать дату, представленную строкой, которая соответствует спецификации rfc2060 для значения date_time.

Возвращаемые значения

Возвращает true в случае успешного завершения или false в случае возникновения ошибки.

Примеры

Пример #1 Пример использования imap_append()

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

$check = imap_check($stream);
echo 
"Кол-во сообщений до добавления: ". $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"
                   
. "это проверочное сообщение, пожалуйста, игнорируйте его\r\n"
                   
);

$check = imap_check($stream);
echo 
"Кол-во сообщений после добавления : ". $check->Nmsgs . "\n";

imap_close($stream);
?>