Returns an IMAP stream on success and FALSE on error. This function can also
be used to open streams to POP3 and NNTP servers, but some
functions and features are only available on IMAP
servers.
A mailbox name consists of a server part and a mailbox
path on this server. The special name INBOX stands for the
current users personal mailbox. The server part, which is
enclosed in '{' and '}', consists of the servers name or ip
address, an optional port (prefixed by ':'), and an optional
protocol specification (prefixed by '/'). The server part is
mandatory in all mailbox parameters. Mailbox names that
contain international characters besides those in the
printable ASCII space have to be encoded with
imap_utf7_encode().
The options are a bit mask with one or more of the
following:
OP_ANONYMOUS - Dont use or update a .newsrc for news (NNTP only)
OP_HALFOPEN - For IMAP and NNTP names, open a
connection but dont open a mailbox
To connect to an IMAP server running on port 143 on the
local machine, do the following: