imap_savebody

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

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

Описание

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

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

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

imap

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

file

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

message_num

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

section

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

flags

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

  • 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 add a note

User Contributed Notes 4 notes

up
11
anon
12 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.

<?php
$whandle
= fopen('./incomming/tmp.tif','w');

stream_filter_append($whandle,
  
'convert.base64-decode',STREAM_FILTER_WRITE);

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

fclose($whandle);
?>

NOTE: To find the proper filter you need to check the encoding given by the structure of the body.
up
-2
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:

<?php
$tFile
= "/path/to/attachment";
$tFileOutput="";
$tFileHandle = fopen($tFile, "r");

//get the content of the file into a string
while(!feof($tFileHandle))
 
$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);
?>
up
-4
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
up
-6
stupergenius at gmail dot com
17 years ago
This function will save ALL information from the email if the part number is left out. Pretty handy for archiving.
To Top