IMAP, POP3 и NNTP

  • Введение
  • Установка и настройка
  • Предопределенные константы
  • IMAP Функции
    • imap_8bit — Конвертирует 8-битную строку в quoted-printable строку
    • imap_alerts — Возвращает все произошедшие предупредительные IMAP сообщения
    • imap_append — Добавляет строковое сообщение в указанный почтовый ящик
    • imap_base64 — Декодировать текст закодированный BASE64
    • imap_binary — Конвертирует 8-битную строку в строку base64
    • imap_body — Прочитать тело сообщения
    • imap_bodystruct — Прочитать структуру указанной секции тела заданного сообщения
    • imap_check — Проверить текущий почтовый ящик
    • imap_clearflag_full — Снять с сообщения установленные флаги
    • imap_close — Закрыть поток IMAP
    • imap_create — Псевдоним imap_createmailbox
    • imap_createmailbox — Создать новый почтовый ящик
    • imap_delete — Пометить сообщение для удаления
    • imap_deletemailbox — Удалить почтовый ящик
    • imap_errors — Получить все произошедшие ошибки IMAP
    • imap_expunge — Удалить все помеченные для удаления сообщения
    • imap_fetch_overview — Обзор информации, содержащейся в заголовках сообщений
    • imap_fetchbody — Извлечь конкретную секцию тела сообщения
    • imap_fetchheader — Получить заголовок сообщения
    • imap_fetchmime — Извлечь MIME-заголовки для конкретной секции сообщения
    • imap_fetchstructure — Прочитать структуру указанного сообщения
    • imap_fetchtext — Псевдоним imap_body
    • imap_gc — Очистить кеш IMAP
    • imap_get_quota — Получить настройку уровня квоты и статистику использования почтовых ящиков
    • imap_get_quotaroot — Получить настройки квоты для каждого пользователя
    • imap_getacl — Получить ACL для заданного почтового ящика
    • imap_getmailboxes — Read the list of mailboxes, returning detailed information on each one
    • imap_getsubscribed — Список всех почтовых ящиков, на которые вы подписаны
    • imap_header — Псевдоним imap_headerinfo
    • imap_headerinfo — Прочитать заголовок сообщения
    • imap_headers — Получить заголовки всех сообщений в почтовом ящике
    • imap_last_error — Получить последнюю ошибку IMAP в текущем запросе
    • imap_list — Прочитать список почтовых ящиков
    • imap_listmailbox — Псевдоним imap_list
    • imap_listscan — Получить список почтовых ящиков, имена которых содержат заданную строку
    • imap_listsubscribed — Псевдоним imap_lsub
    • imap_lsub — Список всех почтовых ящиков, на которые вы подписаны
    • imap_mail_compose — Создать MIME-сообщение на основе заданных обертки и тела
    • imap_mail_copy — Скопировать сообщения в уазанный почтовый ящик
    • imap_mail_move — Переместить указанные сообщения в указанный почтовый ящик
    • imap_mail — Отправить email
    • imap_mailboxmsginfo — Получить информацию о текущем почтовом ящике
    • imap_mime_header_decode — Декодировать элементы заголовка
    • imap_msgno — Получить номер сообщения с заданным UID
    • imap_mutf7_to_utf8 — Декодирует модифицированную UTF-7 строку в UTF-8
    • imap_num_msg — Получить количество сообщений в текущем почтовом ящике
    • imap_num_recent — Получить количество новых сообщений в текущем почтовом ящике
    • imap_open — Открывает поток IMAP к почтовому ящику
    • imap_ping — Проверить, активен ли еще поток IMAP
    • imap_qprint — Преобразовать строку из формата "quoted-printable" в 8-битную строку
    • imap_rename — Псевдоним imap_renamemailbox
    • imap_renamemailbox — Переименовать почтовый ящик
    • imap_reopen — Переоткрывает поток IMAP к новому ящику
    • imap_rfc822_parse_adrlist — Разбор адресной строки
    • imap_rfc822_parse_headers — Разбор строки заголовка письма
    • imap_rfc822_write_address — Получить корректно сформированный e-mail адрес заданный именем ящика, хоста и персональной информацией
    • imap_savebody — Сохранить часть тела сообщения в файл
    • imap_scan — Псевдоним imap_listscan
    • imap_scanmailbox — Псевдоним imap_listscan
    • imap_search — Получить сообщения, удовлетворяющие заданным критериям
    • imap_set_quota — Установить квоту для заданного почтового ящика
    • imap_setacl — Установка ACL для заданного почтового ящика
    • imap_setflag_full — Установить флаги на сообщения
    • imap_sort — Получить и отсортировать сообщения
    • imap_status — Получить информацию по статусу почтового ящика
    • imap_subscribe — Подписаться на почтовый ящик
    • imap_thread — Получить дерево связанных сообщений
    • imap_timeout — Установить или получить таймаут imap
    • imap_uid — Получить UID по номеру сообщения
    • imap_undelete — Снимает с сообщения метку удаления
    • imap_unsubscribe — Отписаться от почтового ящика
    • imap_utf7_decode — Декодирует строку из модифицированной кодировки UTF-7
    • imap_utf7_encode — Преобразует строку ISO-8859-1 в модифицированную UTF-7
    • imap_utf8_to_mutf7 — Кодирует строку UTF-8 в модифицированную UTF-7
    • imap_utf8 — Преобразует MIME-кодированный текст в UTF-8
add a note add a note

User Contributed Notes 3 notes

up
27
Wil Barath
7 years ago
For all the people coming here praying for:

1) a dead-easy way to read MIME attachments, or
2) a dead-easy way to access POP3 folders

Look no further.

<?php
function pop3_login($host,$port,$user,$pass,$folder="INBOX",$ssl=false)
{
   
$ssl=($ssl==false)?"/novalidate-cert":"";
    return (
imap_open("{"."$host:$port/pop3$ssl"."}$folder",$user,$pass));
}
function
pop3_stat($connection)       
{
   
$check = imap_mailboxmsginfo($connection);
    return ((array)
$check);
}
function
pop3_list($connection,$message="")
{
    if (
$message)
    {
       
$range=$message;
    } else {
       
$MC = imap_check($connection);
       
$range = "1:".$MC->Nmsgs;
    }
   
$response = imap_fetch_overview($connection,$range);
    foreach (
$response as $msg) $result[$msg->msgno]=(array)$msg;
        return
$result;
}
function
pop3_retr($connection,$message)
{
    return(
imap_fetchheader($connection,$message,FT_PREFETCHTEXT));
}
function
pop3_dele($connection,$message)
{
    return(
imap_delete($connection,$message));
}
function
mail_parse_headers($headers)
{
   
$headers=preg_replace('/\r\n\s+/m', '',$headers);
   
preg_match_all('/([^: ]+): (.+?(?:\r\n\s(?:.+?))*)?\r\n/m', $headers, $matches);
    foreach (
$matches[1] as $key =>$value) $result[$value]=$matches[2][$key];
    return(
$result);
}
function
mail_mime_to_array($imap,$mid,$parse_headers=false)
{
   
$mail = imap_fetchstructure($imap,$mid);
   
$mail = mail_get_parts($imap,$mid,$mail,0);
    if (
$parse_headers) $mail[0]["parsed"]=mail_parse_headers($mail[0]["data"]);
    return(
$mail);
}
function
mail_get_parts($imap,$mid,$part,$prefix)
{   
   
$attachments=array();
   
$attachments[$prefix]=mail_decode_part($imap,$mid,$part,$prefix);
    if (isset(
$part->parts)) // multipart
   
{
       
$prefix = ($prefix == "0")?"":"$prefix.";
        foreach (
$part->parts as $number=>$subpart)
           
$attachments=array_merge($attachments, mail_get_parts($imap,$mid,$subpart,$prefix.($number+1)));
    }
    return
$attachments;
}
function
mail_decode_part($connection,$message_number,$part,$prefix)
{
   
$attachment = array();

    if(
$part->ifdparameters) {
        foreach(
$part->dparameters as $object) {
           
$attachment[strtolower($object->attribute)]=$object->value;
            if(
strtolower($object->attribute) == 'filename') {
               
$attachment['is_attachment'] = true;
               
$attachment['filename'] = $object->value;
            }
        }
    }

    if(
$part->ifparameters) {
        foreach(
$part->parameters as $object) {
           
$attachment[strtolower($object->attribute)]=$object->value;
            if(
strtolower($object->attribute) == 'name') {
               
$attachment['is_attachment'] = true;
               
$attachment['name'] = $object->value;
            }
        }
    }

   
$attachment['data'] = imap_fetchbody($connection, $message_number, $prefix);
    if(
$part->encoding == 3) { // 3 = BASE64
       
$attachment['data'] = base64_decode($attachment['data']);
    }
    elseif(
$part->encoding == 4) { // 4 = QUOTED-PRINTABLE
       
$attachment['data'] = quoted_printable_decode($attachment['data']);
    }
    return(
$attachment);
}
?>

[EDIT BY danbrown AT php DOT net: Contains a bugfix by "mn26826" on 09-JUN-2010, which fixed the erroneous reference to $imap as the parameter passed to imap_mailboxmsginfo() within the user function pop3_stat().  This was intended to be $connection.]

[EDIT BY visualmind AT php DOT net: Contains a bugfix by "elias-jobview" on 17-AUG-2010, which fixed the error in pop3_list function which didn't have: return $result]

[EDIT BY danbrown AT php DOT net: Contains a bugfix by "chrismeistre" on 09-SEP-2010, which fixed the erroneous reference to $mbox (should be $connection) in the pop3_list() function.]
up
-2
opto
5 years ago
it seems that in new PHP versions, $ssl must be specified even if no ssl is used - I got it working for POP3 only after adding /notls (honour some post I found somewhere)
Klaus
up
-9
dev at bluehead dot com dot br
6 years ago
Because I don't know regular expressions, I hacked the mail_parse_headers() to properly get the last line from the header string:

<?php
function mail_parse_headers($headers)
{

   
$headers=preg_replace('/\r\n\s+/m', '',$headers);
   
$headers=trim($headers)."\r\n"; /* a hack for the preg_match_all in the next line */
   
preg_match_all('/([^: ]+): (.+?(?:\r\n\s(?:.+?))*)?\r\n/m', $headers, $matches);
    foreach (
$matches[1] as $key =>$value) $result[$value]=$matches[2][$key];
    return(
$result);
}
?>
To Top