(PHP 3, PHP 4)
成功するとIMAPストリームを返し、失敗すると FALSE を返します。この関 数は、POP3やNNTPサーバーへのストリームをオープンする際にも使用可 能です。しかし、いくつかの関数および機能はIMAPサーバーでは利用で きません。
メールボックス名(mailbox)は、サーバー名の部分と使用するサーバーに おけるメールボックスへのパスから構成されます。特別な名前INBOXは、 カレントのユーザの個人メールボックスを意味します。サーバー部は'{' および'}'で括られ、サーバー名またはIPアドレス、オプションの':'か ら始まるポート指定子、('/'で始まる)オプションのプロトコル指定子か ら構成されます。サーバー部は、全てのmailboxパラメータで必須です。 ASCII空間で出力可能な文字以外の外国文字を含むメールボックス名は imap_utf7_encode() でエンコードする必要がありま す。
オプションは、ビットマスクであり、以下の組み合わせとなります。
OP_READONLY - メールボックスを読みこみのみ可でオープン
OP_ANONYMOUS - news に関して.newsrcの使用・更新をしない(NNTPのみ)
OP_HALFOPEN - IMAPおよびNNTP名について、接続をオープンするがメールボックスをオープンしない
CL_EXPUNGE - メールボックスを閉じた際に、自動的にメールボックスを削除する
ローカルマシンのポート143で実行しているIMAPサーバーに接続 する際には、以下のようにします。
例 1 imap_open() の例