imap_mail_move

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

imap_mail_moveMueve mensajes a una caja de correo

Descripción

imap_mail_move(
    IMAP\Connection $imap,
    string $message_nums,
    string $mailbox,
    int $flags = 0
): bool

imap_mail_move() mueve los mensajes especificados por message_nums a la caja de correo mailbox. Es importante destacar que los mensajes son en realidad copiados a la caja de correo mailbox, y los mensajes originales son marcados para ser eliminados. Esto implica que los mensajes en mailbox son asignados nuevos UIDs.

Parámetros

imap

An IMAP\Connection instance.

message_nums

message_nums es un intervalo, y no solo una lista de mensajes (como se describe en la » RFC2060).

mailbox

El nombre de la caja de correo, ver la documentación de la función imap_open() para más detalles

Advertencia

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

flags

flags es un campo de bits y puede contener un solo valor:

  • CP_UID - La secuencia de números contiene UIDs

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.

Notas

Nota:

imap_mail_move() marcará el correo electrónico original con un marcador de eliminación, para eliminarlo efectivamente, se requiere una llamada a imap_expunge().

Ver también