imap_append

(PHP 4, PHP 5, PHP 7, PHP 8)

imap_appendAñade un mensaje en un buzón de correo

Descripción

imap_append(
    IMAP\Connection $imap,
    string $folder,
    string $message,
    ?string $options = null,
    ?string $internal_date = null
): bool

Añade un message al folder especificado.

Parámetros

imap

An IMAP\Connection instance.

folder

El nombre del buzón de correo, ver la documentación de la función imap_open() para más información

Advertencia

Passing untrusted data to this parameter is insecure, unless imap.enable_insecure_rsh is disabled.

message

El mensaje a añadir, en forma de string

Al intercambiar con el servidor Cyrus IMAP, se debe utilizar "\r\n" como terminación de línea, en lugar de "\n" o la operación fallará.

options

Si se proporciona, el parámetro options será también escrito en el buzón folder

internal_date

Si se define este parámetro, establecerá los INTERNALDATE en el mensaje adjunto. El parámetro debe ser una cadena de fecha que cumpla con las especificaciones del rfc2060 para un valor date_time.

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error.

Historial de cambios

Versión Descripción
8.1.0 The imap parameter expects an IMAP\Connection instance now; previously, a valid imap resource was expected.
8.0.0 options y internal_date ahora son nullables.

Ejemplos

Ejemplo #1 Ejemplo con imap_append()

<?php
$imap
= imap_open("{imap.example.org}INBOX.Drafts", "username", "password");

$check = imap_check($imap);
echo
"Msg Count before append: ". $check->Nmsgs . "\n";

imap_append($imap, "{imap.example.org}INBOX.Drafts"
, "From: me@example.com\r\n"
. "To: you@example.com\r\n"
. "Subject: test\r\n"
. "\r\n"
. "Este es un mensaje de prueba. Ignórelo.\r\n"
);

$check = imap_check($imap);
echo
"Número de mensajes después de añadir : ". $check->Nmsgs . "\n";

imap_close($imap);
?>