# imap_mail_move

(PHP 4, PHP 5, PHP 7)

imap_mail_move — Move specified messages to a mailbox

### 说明

imap_mail_move ( resource `$imap_stream` , string `$msglist` , string `$mailbox` [, int `$options` = 0 ] ) : bool

Moves mail messages specified by `msglist` to the specified `mailbox`.

### 参数

`imap_stream`

  由 imap_open() 返回的 IMAP 流。

`msglist`

  `msglist` is a range not just message 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.

`options`

  `options` is a bitmask and may contain the single option:

  - `CP_UID` - the sequence numbers contain UIDS

### 返回值

成功时返回 `TRUE`， 或者在失败时返回 `FALSE`。

### 注释

> Note:

> imap_mail_move() will flag the original mail with a delete flag, to successfully delete it a call to the imap_expunge() function must be made.

### 参见

- imap_mail_copy() - Copy specified messages to a mailbox