cvs: phpdoc /en/reference/mail/functions mail.xml

mfischer Sat May 18 07:04:04 2002 EDT Modified files: /phpdoc/en/reference/mail/functions mail.xml Log: - Document latest Win32 mail() changes. Index: phpdoc/en/reference/mail/functions/mail.xml diff -u phpdoc/en/reference/mail/functions/mail.xml:1.4 phpdoc/en/reference/mail/functions/mail.xml:1.5 --- phpdoc/en/reference/mail/functions/mail.xml:1.4 Wed May 15 14:11:21 2002 +++ phpdoc/en/reference/mail/functions/mail.xml Sat May 18 07:04:04 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./en/functions/mail.xml, last change in rev 1.2 --> <refentry id="function.mail"> <refnamediv> @@ -41,6 +41,23 @@ <function>mail</function> returns &true; if the mail was successfully accepted for delivery, &false; otherwise. </para> + <warning> + <para> + The Windows implementation of <function>mail</function> differs in many + ways from the Unix implementation. First, it doesn't use a local binary + for composing messages but only operates on direct sockets which means a + <literal>MTA</literal> is needed listening on a network socket (which + can either on the localhost or a remote machine). Second, the custom + headers like <literal>From:</literal>, <literal>Cc:</literal>, + <literal>Bcc:</literal> and <literal>Date:</literal> are <emphasis + role="strong">not</emphasis> interpreted by the <literal>MTA</literal> + in the first place, but are parsed by <literal>PHP</literal>. + <literal>PHP</literal> < 4.3 only supported the <literal>Cc:</literal> + header element (and was case-sensitive). <literal>PHP</literal> >= 4.3 + supports all the mentioned header element and is no longer + case-sensitive. + </para> + </warning> <para> <example> <title>Sending mail.</title> @@ -61,9 +78,7 @@ <para> You must use <literal>\r\n</literal> to seperate headers, although some Unix mail transfer agents may work with just a single newline - (<literal>\n</literal>). The Cc: header is case sensitive and must - be written as <literal>Cc:</literal> on Win32 systems. The Bcc: - header is also not supported on Win32 systems. + (<literal>\n</literal>). </para> </note> <para>