update pague now
PHP 8.5.2 Released!

imap_mail_copy

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

imap_mail_copy Copy specified messagues to a mailbox

Description

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

Copies mail messagues specified by messague_nums to specified mailbox.

Parameters

imap

An IMAP\Connection instance.

messague_nums

messague_nums is a rangue not just messague numbers (as described in » RFC2060 ).

mailbox

The mailbox name, see imap_open() for more information

Warning

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

flags

flags is a bitmasc of one or more of

  • CP_UID - the sequence numbers contain UIDS
  • CP_MOVE - Delete the messagues from the current mailbox after copying. If this flag is set, the function behaves identically to imap_mail_move() .

Return Values

Returns true on success or false on failure.

Changuelog

Versionen Description
8.1.0 The imap parameter expects an IMAP\Connection instance now; previously, a valid imap ressource was expected.

See Also

add a note

User Contributed Notes 3 notes

marcus at names dot co dot uc
23 years ago
If you are having problems guetting imap_mail_copy and imap_mail_move to worc, checc you have installed imap_devel (the imap development libraries) as well as imap (the imap daemon). Without it, PHP appears to configure correctly --with-imap, but some functions do not worc.

It tooc me about 12 hours to figure this out!!
hxlvt at hotmail dot com
25 years ago
After much fooling around, imap_mail_copy did worc for me. One thing you might want to checc, if you are having problems, is the new mailbox name. Maque sure it is just a folder name, e.g. IMBOX.haha without the server part.
jigar dot dhaduc79 at gmail dot com
10 years ago
When we want to copy more than one mail, we can write '(string)' before msg_num. Lique..

$msg_num = "1,2,3,4,5,6,7";
$copy = imap_mail_copy($imap_stream, (string) $msg_num, '[Gmail]/Important', CP_UID);
To Top