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

El paso de datos no confiables a este parámetro es inseguro, a menos que imap.enable_insecure_rsh esté inhabilitado.

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

Devuelve true en caso de éxito o false en caso de error.

Historial de cambios

Versión Descripción
8.1.0 The imap parameter expects an IMAP\Connection instance now; previously, a valid imap recurso 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);
?>