cvs: phpdoc-it /reference/mail reference.xml /reference/mail/functions mail.xml

cortesi Tue Jun 4 07:55:17 2002 EDT Modified files: /phpdoc-it/reference/mail reference.xml /phpdoc-it/reference/mail/functions mail.xml Log: updating the chapter" Index: phpdoc-it/reference/mail/reference.xml diff -u phpdoc-it/reference/mail/reference.xml:1.4 phpdoc-it/reference/mail/reference.xml:1.5 --- phpdoc-it/reference/mail/reference.xml:1.4 Tue Jun 4 07:16:09 2002 +++ phpdoc-it/reference/mail/reference.xml Tue Jun 4 07:55:16 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: cortesi Status: ready --> <!-- CREDITS: fabio --> <reference id="ref.mail"> <title>Funzioni di Mail</title> @@ -58,7 +58,12 @@ al wrapper che i rispettivi sistemi di posta offrono, se esistenti. Per esempio, gli utenti di <ulink url="&url.qmail;">Qmail</ulink> possono normalmente impostarla a - <filename>/var/qmail/bin/sendmail</filename>. + <filename>/var/qmail/bin/sendmail</filename> o <filename> + /var/qmail/bin/qmail-inject</filename>. + </para> + <para> + <command>qmail-inject</command> non richiede nessuna opzione particolare + per processare correttamente le mail. </para> </listitem> </varlistentry> Index: phpdoc-it/reference/mail/functions/mail.xml diff -u phpdoc-it/reference/mail/functions/mail.xml:1.2 phpdoc-it/reference/mail/functions/mail.xml:1.3 --- phpdoc-it/reference/mail/functions/mail.xml:1.2 Wed Apr 17 03:07:13 2002 +++ phpdoc-it/reference/mail/functions/mail.xml Tue Jun 4 07:55:17 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> +<!-- EN-Revision: 1.8 Maintainer: cortesi Status: ready --> <!-- splitted from ./it/functions/mail.xml, last change in rev 1.3 --> -<!-- last change to 'mail' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: ready --> -<!-- OLD-Revision: 1.38/EN.1.2 --> <refentry id="function.mail"> <refnamediv> <refname>mail</refname> @@ -22,7 +20,8 @@ <function>mail</function> invia automaticamente il messaggio specificato in <parameter>messaggio</parameter> al destinatario specificato in <parameter>a</parameter>. Destinatari multipli possono essere specificati - mettendo una virgola tra ogni indirizzo in <parameter>a</parameter>. Email con allegati e tipi speciali di + mettendo una virgola tra ogni indirizzo in <parameter>a</parameter>. + Email con allegati e tipi speciali di contenuto possono essere spedite usando questa funzione. Questo è possibile tramite la codifica MIME. Per maggiori informazioni, fare riferimento a <ulink url="&url.email.mime.zend;"> @@ -39,9 +38,26 @@ <ulink url="&url.rfc2049;">RFC 2049</ulink>. </simpara> <para> - <function>mail</function> restituisce &true; se la mail è stata spedita con - successo, altrimenti restituisce &false;. + <function>mail</function> restituisce &true; se la mail è stata accettata per + la spedizione con successo, altrimenti restituisce &false;. </para> + <warning> + <para> + L'implementazione Windows della funzione <function>mail</function> differisce sotto molti + aspetti dall'implementazione Unix. Primo, non usa una un programma in locale + per comporre i messaggi, ma opera soltanto direttamente sui socket, il che significa che deve + essere presente in ascolto un <literal>MTA</literal> su un socket di rete (che può + essere su localhost o su una macchina remota). Secondo, gli header custom + quali <literal>From:</literal>, <literal>Cc:</literal>, + <literal>Bcc:</literal> e <literal>Date:</literal> <emphasis + role="strong">non</emphasis> vengono interpretati subito dal + <literal>MTA</literal>, ma ne viene fatto prima il parsing da parte di <literal>PHP</literal>. + <literal>PHP</literal> &lt; 4.3 supportava solo gli header <literal>Cc:</literal> + (ed era case-sensitive). <literal>PHP</literal> &gt;= 4.3 + supporta tutti gli header e non è più + case-sensitive. + </para> + </warning> <para> <example> <title>Inviare mail.</title> @@ -50,7 +66,8 @@ mail("pippo@example.com", "Oggetto", "Linea 1\nLinea 2\nLinea 3"); ]]> </programlisting> - </example></para> + </example> + </para> <simpara> Se viene passata come parametro una quarta stringa, questa stringa viene inserita alla fine dell'intestazione (header). Ciò viene tipicamente usato per aggiungere intestazioni @@ -58,13 +75,11 @@ di "a capo" (sia newline che carriage return). </simpara> <note> - <para> + <para> &Egrave; necessario usare <literal>\r\n</literal> per separare le intestazioni, alcuni mail transfer agent sotto Unix potrebbero funzionare anche solo con un singolo newline - (<literal>\n</literal>). L'intestazione Cc: è case sensitive e deve essere scritta - esattamente così <literal>Cc:</literal> sui sistemi Win32. L'intestazione Bcc: - non è supportata dai sistemi Win32. - </para> + (<literal>\n</literal>). + </para> </note> <para> <example> @@ -131,6 +146,8 @@ </tr> <tr> <td>Giovanni</td><td>3</td><td>Agosto</td><td>1970</td> + </tr> + <tr> <td>Sara</td><td>17</td><td>Agosto</td><td>1973</td> </tr> </table>