imap_savebody

(PHP 5 >= 5.1.3, PHP 7)

imap_savebody — Save a specific body section to a file

Description

bool imap_savebody ( resource $imap_stream , mixed $file , int $msg_number [, string $part_number = "" [, int $options = 0 ]] )

Saves a part or the whole body of the specified message.

Parameters

imap_stream

An IMAP stream returned by imap_open().

file

The path to the saved file as a string, or a valid file descriptor returned by fopen().

msg_number

The message number

part_number

The part number. It is a string of integers delimited by period which index into a body part list as per the IMAP4 specification

options

A bitmask with one or more of the following:

FT_UID - The msg_number is a UID
FT_PEEK - Do not set the \Seen flag if not already set
FT_INTERNAL - The return string is in internal format, will not canonicalize to CRLF.

Return Values

Returns TRUE on success or FALSE on failure.

User Contributed Notes

anon

3 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.

stupergenius at gmail dot com

8 years ago


This function will save ALL information from the email if the part number is left out. Pretty handy for archiving.

janus at forty-seven dot info

7 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);
?>

technocraze at gmail dot com