CascadiaPHP 2024


(PHP 5 >= 5.1.3, PHP 7, PHP 8)

imap_savebodyСохраняет часть тела сообщения в файл


    IMAP\Connection $imap,
    resource|string|int $file,
    int $message_num,
    string $section = "",
    int $flags = 0
): bool

Записывает часть тела сообщения в файл.

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


Экземпляр класса IMAP\Connection.


Путь к файлу в виде строки, либо открытый с помощью fopen() файловый дескриптор.


Номер сообщения


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


Битовая маска из одной или нескольких опций:

  • FT_UID - The message_num is a UID
  • FT_PEEK - Не устанавливать флаг \Seen, если он уже не установлен
  • FT_INTERNAL - возвращать строку во внутреннем формате, без преобразования концов строк к CRLF.

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

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

Список изменений

Версия Описание
8.1.0 Параметр imap теперь ожидает экземпляр класса IMAP\Connection; раньше параметр ждал ресурс (resource) imap.

Смотрите также

  • imap_fetchbody() - Извлекает конкретную секцию тела сообщения

add a note

User Contributed Notes 4 notes

11 years ago
By using imap_fetchbody() you may run in trouble by using too much memory. Using imap_savebody() may prevent this.

But the content will be encoded, in other words it is useless. Adding a filter can help here.

= fopen('./incomming/tmp.tif','w');


imap_savebody ($mbox, $whandle, $i, $partcounter++);


NOTE: To find the proper filter you need to check the encoding given by the structure of the body.
janus at forty-seven dot info
15 years ago
It seems that imap_savebody saves attachments with special characters above ascii 127 as quoted printable.
But if you need it in utf8, you may use the imap_qprint function after the attachment is saved:

= "/path/to/attachment";
$tFileHandle = fopen($tFile, "r");

//get the content of the file into a string
$tFileOutput = $tFileOutput . fgets($tFileHandle, 4096);

fclose ($tFileHandle);

$tFileHandle = fopen($tFile, "w");
//write the new 8Bit string to the file
fwrite($tFileHandle, imap_qprint($tFileOutput));
fclose ($tFileHandle);
technocraze at gmail dot com
16 years ago
I tried to use this function. But it seems it requires php_zip.dll to be load.. i got the php errror like below.

[20-Dec-2007 13:38:17] PHP Warning: PHP Startup: Unable to load dynamic library './php_zip.dll' - ./php_zip.dll: cannot open shared object file: No such file or directory in Unknown on line 0
[20-Dec-2007 13:38:17] PHP Fatal error: Call to undefined function imap_savebody() in /opt/oss/share/apache2/htdocs/blogtest/wp-inst/batch/pop3_mail.php on line 153
stupergenius at gmail dot com
16 years ago
This function will save ALL information from the email if the part number is left out. Pretty handy for archiving.
To Top