array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'function.imap-reopen.php', 1 => 'imap_reopen', 2 => '新規メールボックスへの IMAP ストリームを再度オープンする', ), 'up' => array ( 0 => 'ref.imap.php', 1 => 'IMAP 関数', ), 'prev' => array ( 0 => 'function.imap-renamemailbox.php', 1 => 'imap_renamemailbox', ), 'next' => array ( 0 => 'function.imap-rfc822-parse-adrlist.php', 1 => 'imap_rfc822_parse_adrlist', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'reference/imap/functions/imap-reopen.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

imap_reopen

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

imap_reopen — 新規メールボックスへの IMAP ストリームを再度オープンする

説明

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

IMAP または NNTP サーバー上の新しい mailbox に対して指定されたストリームを再オープンします。

パラメータ

imap

IMAP\Connection クラスのインスタンス。

mailbox

メールボックス名。詳細は imap_open() を参照ください。

警告

信頼できないデータをこのパラメータに渡すのであれば、 imap.enable_insecure_rsh を無効にしておかなければ危険です。

flags

flags はビットマスクであり、以下の組み合わせとなります。

  • OP_READONLY - メールボックスを読み込み専用でオープンします。
  • OP_ANONYMOUS - ニュースに関して .newsrc を使用せず、更新もしません（NNTP のみ）。
  • OP_HALFOPEN - IMAP および NNTP 名について、接続をオープンするがメールボックスをオープンしません。
  • OP_EXPUNGE - 何も警告せずにリサイクルストリームを削除します。
  • CL_EXPUNGE - メールボックスを閉じた際に、自動的に メールボックスを削除する（imap_delete() および imap_expunge() も参照ください）。

retries

接続試行の最大数。

戻り値

ストリームを再度オープンした場合に true、 それ以外の場合に false を返します。

変更履歴

バージョン 説明
8.1.0 引数 imap は、IMAP\Connection クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、有効な imap resource が期待されていました。

例

例1 imap_reopen() の例

<?php
$mbox = imap_open("{imap.example.org:143}INBOX", "username", "password") or die(implode(", ", imap_errors()));
// ...
imap_reopen($mbox, "{imap.example.org:143}INBOX.Sent") or die(implode(", ", imap_errors()));
// ..
?>