chagenbu Thu May 24 10:37:40 2001 EDT
Modified files:
/phpdoc/en/functions imap.xml
Log:
add examples for SSL IMAP and POP3 servers, and correct server specs to be
of form host:port/protocol (some of them were host/protocol:port).
Index: phpdoc/en/functions/imap.xml
diff -u phpdoc/en/functions/imap.xml:1.40 phpdoc/en/functions/imap.xml:1.41
--- phpdoc/en/functions/imap.xml:1.40 Wed May 23 05:02:24 2001
+++ phpdoc/en/functions/imap.xml Thu May 24 10:37:40 2001
@@ -1913,9 +1913,9 @@
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, a protocol
- secification (beginning with '/') and an optional port specifier
- beginnung with ':'. The server part is mandatory in all mailbox
+ '}', 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 <function>imap_utf7_encode</function>.
@@ -1958,13 +1958,27 @@
To connect to a POP3 server on port 110 on the local server, use:
<informalexample>
<programlisting role="php">
-$mbox = imap_open ("{localhost/pop3:110}INBOX", "user_id", "password");
+$mbox = imap_open ("{localhost:110/pop3}INBOX", "user_id", "password");
</programlisting>
</informalexample>
+ To connect to an SSL IMAP or POP3 server, add /ssl after the protocol
+ specification:
+ <informalexample>
+ <programlisting role="php">
+$mbox = imap_open ("{localhost:993/imap/ssl}INBOX", "user_id", "password");
+ </programlisting>
+ </informalexample>
+ To connect to an SSL IMAP or POP3 server with a self-signed
+ certificate, add /ssl/novalidate-cert after the protocol specification:
+ <informalexample>
+ <programlisting role="php">
+$mbox = imap_open ("{localhost:995/pop3/ssl/novalidate-cert}", "user_id", "password");
+ </programlisting>
+ </informalexample>
To connect to an NNTP server on port 119 on the local server, use:
<informalexample>
<programlisting role="php">
-$nntp = imap_open ("{localhost/nntp:119}comp.test", "", "");
+$nntp = imap_open ("{localhost:119/nntp}comp.test", "", "");
</programlisting>
</informalexample>
To connect to a remote server replace "localhost" with the name