White cat - Справочник по PHP

Пример использования функции bzwrite():

Функция поддерживается PHP 4= 4.0.4, PHP 5

Для того, чтобы эти функции заработали вы должны скомпилировать PHP с флагом --with-imap .

Этот флаг требует,чтобы была установлена библиотека c-client. Последнюю версию можно получить по адресу ftp://ftp.cac.washington.edu/imap/.

Затем скопируйте c-client/c-client.a в /usr/local/lib или какую либо другую директорию, прописанную в пути, затем скопируйте c-client/rfc822.h, mail.h и linkage.h в /usr/local/include или другую директорию с include-файлами.

Не смотря на имя модуля, имеющиеся в нем функции позволяют выполнять также много других полезных операций, выходящих за рамки простого использования протокола IMAP. Лежащая в основе библиотека C-клиента также поддерживает NNTP, POP3 и методы доступа к локальным почтовым ящикам.

imap_append

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

Синтаксис:

int imap_append(int imap_stream, string mbox, string message, stringflags);

Возвращает true в случае успеха или false иначе.

imap_append()добавляет текстовое сообщение в указанный почтовый ящик mbox . Если указаны необязательные флаги, также записывает в почтовый ящик и флаги. При общении с сервером Cyrus IMAP нужно использовать в качестве ограничителей строки "rn" вместо "n",иначе действие не выполнится.

imap_base64

Декодирует текст, закодированный с помощью BASE64.

Синтаксис:

string imap_base64(string text);

Функция imap_base64()декодирует текст в формате BASE-64. Декодированное сообщение возвращается как строка.

imap_body

Читает тело сообщения.

Синтаксис:

string imap_body(int imap_stream, int msg_number, int flags);

Функция imap_body()возвращает тело сообщения, имеющего номер п/п msg_number в текущем почтовом ящике.

Необязательные флаги это битовые маски из

imap_check

Проверяет текущий почтовый ящик.

Синтаксис:

array imap_check(int imap_stream);

Возвращает информацию о текущем почтовом ящике. В случае неуспеха возвращает FALSE.

Функция imap_check()проверяет статус текущего почтового ящика на сервере и возвращает информацию в объекте со следующими свойствами :

imap_close

Закрывает поток IMAP.

Синтаксис:

int imap_close(int imap_stream, int flags);

Закрывает поток imap. Необязательный флаг CL_EXPUNGE заставляет стереть помеченные на удаление сообщения при закрытии.

imap_createmailbox

Создает новый почтовый ящик.

Синтаксис:

int imap_createmailbox(int imap_stream, string mbox);

imap_createmailbox()создает новый почтовый ящик указанный в mbox .Возвращает true в случае успеха и false при ошибке.

imap_delete

Помечает сообщение из текущего почтового ящика на удаление.

Синтаксис:

int imap_delete(int imap_stream, int msg_number);

Возвращает true. Функция imap_delete()помечает сообщение, указанное через msg_number на удаление. Настоящее удаление сообщений осуществляется функцией imap_expunge().

imap_deletemailbox

Удаляет почтовый ящик.

Синтаксис:

int imap_deletemailbox(int imap_stream, string mbox);

Возвращает true в случае успеха и false иначе.

imap_expunge

Удаляет все сообщения, помеченные на удаление.

Синтаксис:

int imap_expunge(int imap_stream);

imap_expunge()удаляет все сообщения помеченные на удаление с помощью imap_delete().

Возвращает true.

imap_fetchbody

Извлекает простую секцию тела сообщения.

Синтаксис:

string imap_fetchbody(int imap_stream, int msg_number, int part_number, flags flags);

Эта функция заставляет извлечь подробную секцию указанного сообщения как текстовую строку. Секция это строка целых чисел, разделенных точками, которые указывают на части тела сообщения в списке частей согласно спецификации IMAP4. Части тела не декодируются этой функцией.

Необязательным параметром к imap_fetchbody()является битовая маска из

imap_fetchstructure

Читает структуру простого сообщения.

Синтаксис:

array imap_fetchstructure(int imap_stream, int msg_number);

Эта функция заставляет извлечь всю информацию о структуре сообщения с номером msg_number . Возвращаемая величина является объектом со следующими элементами :

Также функция возвращает массив объектов под названием parameters[] . Этот объект имеет следующие свойства :

value - величина

В случае сообщения из нескольких частей, функция также возвращает массив объектов всех свойств под название parts[] .

imap_header

Читает заголовок сообщения.

Синтаксис:

object imap_header(int imap_stream, int msg_number, int fromlength, int subjectlength, int defaulthost);

Эта функция возвращает объект различных элементов заголовка

imap_headers

Возвращает заголовки всех сообщений в почтовом ящике.

Синтаксис:

array imap_headers(int imap_stream);

Возвращает строковый массив из информации по заголокам. Один элемент массива на сообщение.

imap_listmailbox

Читает список почтовых ящиков.

Синтаксис:

array imap_listmailbox(int imap_stream, string ref, string pat);

Возвращает массив, содержащий названия почтовых ящиков.

imap_listsubscribed

Перечисляет все подписанные ящики.

Синтаксис:

array imap_listsubscribed(int imap_stream, string ref, string pattern);

Возвращает массив всех почтовых ящиков на которые Вы подписаны. Аргументы ref и pattern указывают начальноеместорасположение откуда начинать поиск и шаблон, которому должны удовлетворять названия почтовых ящиков.

imap_mail_copy

Копирует указанные сообщения в почтовый ящик.