成功すると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サーバーに接続
する際には、以下のようにします。