imap_append

(PHP 4, PHP 5)

imap_append — Anexa un mensaje tipo cadena al buzón especificado

Descripción

bool imap_append ( resource $secuencia_imap , string $buzon , string $mensaje [, string $opciones ] )

Agrega una cadena mensaje al buzon especificado.

Lista de parámetros

imap_stream

An IMAP stream returned by imap_open().

buzon

El nombre del buzón, vea imap_open() para más información

mensaje

El mensaje a anexar, como una cadena

Cuando se comunique con el servidor IMAP Cyrus, debe usar "\r\n" como indicador de final-de-línea en lugar de "\n", o la operación fallará

opciones

Si se definen, las opciones serán escritas también al buzon

Valores retornados

Devuelve TRUE si todo se llevó a cabo correctamente, FALSE en caso de fallo.

Ejemplos

Example #1 Ejemplo de imap_append()


<?php
$secuencia = imap_open("{imap.example.org}INBOX.Drafts", "nombre_usuario", "contraseña");

$chequeo = imap_check($secuencia);
echo "Conteo de mensajes antes de anexar: ". $chequeo->Nmsgs . "\n";

imap_append($secuencia, "{imap.example.org}INBOX.Drafts"
                      , "From: fuente@example.com\r\n"
                      . "To: destino@example.com\r\n"
                      . "Subject: prueba\r\n"
                      . "\r\n"
                      . "este es un mensaje de prueba, por favor ignorar\r\n"
                      );

$chequeo = imap_check($secuencia);
echo "Conteo de mensajes después de anexar: ". $chequeo->Nmsgs . "\n";

imap_close($secuencia);
?>

imap_base64

imap_alerts

Last updated: Fri, 11 Apr 2008

add a note User Contributed Notes
imap_append

chris at sma-sportsmgmt dot com
08-Feb-2008 08:06


I spend most of today refining the example to make it work properly when saving to the Inbox.Sent folder.



The append command now looks like:



    $return = imap_append($stream,$mailbox_addr

                       , "From: $fromReply\r\n"

                       . "To: $to\r\n"

                       . "Subject: $subject\r\n"

                       . "Date: $now  \r\n"

              . "X-Mailer: Cmail_v2.0 \r\n"

                       . "X-Originating-IP: $ip_addr \r\n"

                       . "MIME-Version: 1 \r\n"

                       . "Content-Type: text/html;\r\n\tcharset=\"ISO-8859-1\"\r\n"

                       . "Content-Transfer-Encoding: 8bit \r\n"

                       . "\r\n\r\n"

                       . "$wk_msg\r\n"

                       );



This inserts the current date into the email and lets it support html content. The one thing that I haven't got working yet is including attachments. I presumably have to make the boundaries and attachment content part of the message body.



Chris

jille at DIESPAMMERShexon dot cx
03-May-2007 04:36


The last argument, $options, are flags like for use with imap_setflag_full.

It took a while before I found out

svicentemolina at gmail dot com
17-Jan-2007 04:57


I have used this function to copy all the emails of one account from one server to another. The problem was that this function don't copy the original receiving date for each message.

To add a fifth field to provide the date, I have made some changes at some php source files following the steps described in http://www.zend.com/lists/php-dev/200303/msg00843.html and it has worked fine.

The correct date format is the returned by the function mail_date in c-client/mail.c source file, for instance: "17-Jan-2007 10:00:01 +0100"

bithive
24-Jun-2003 12:26


The parameter description is misleading.  You can pass a string of flags such as '\Seen' [see imap_setflag_full()] as the last argument.  In the other imap functions, 'options' seems to usually refer to a bitmask, not message flags.

michel dot jansens at ulb dot ac dot be
29-Apr-2003 04:29


I use imap_append() to decode message/rfc822 attachments type(embedded emails):



$attachment = imap_fetchbody($mbox,$mailuid,$atpos,FT_UID);

$attachment = imap_base64($attachment);

$res =  imap_append($mbox,mboxspec("INBOX"),$attachment);

//the embedded email is now a normal mail in my INBOX

bluebiru78 at hotmail dot com
12-Jun-2002 09:24


i used imap_append to copy any composed message into INBOX.Sent folder..



$app = imap_append($stream,"{" . $connectstring . "}INBOX.Sent","$header\r\n" ."$mbody\r\n");



if (!$app) {

 error("Email copying to Sent folder FAILED!");

}

owain at vaughan dot com
01-Aug-2001 03:49


With SIMS IMAP server you also need to use \r\n as a line terminator, otherwise you will be able to add all the header lines correctly, but the body of the message will not be saved.<br>


You can use \n by itself for each header line, but when creating the blank line between the headers and the body you must use \r\n\r\n

jesper at angelo dot dk
14-Sep-1999 06:13


Please observe that imap_append() do not support NNTP posting. Use fsockopen() instead, and do the work yourself.

add a note

imap_base64

imap_alerts

Last updated: Fri, 11 Apr 2008