imap_append
(PHP 4, PHP 5, PHP 7)
imap_append — Добавляет строковое сообщение в указанный почтовый ящик
Описание
$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);
?>