[PHP-DOC] cvs: phpdoc /fr/functions mail.xml

[Damien Seguy]

dams            Tue Jul 24 09:44:28 2001 EDT

  Modified files:              
    /phpdoc/fr/functions        mail.xml 
  Log:
  Corrected mail example
  
Index: phpdoc/fr/functions/mail.xml
diff -u phpdoc/fr/functions/mail.xml:1.9 phpdoc/fr/functions/mail.xml:1.10
--- phpdoc/fr/functions/mail.xml:1.9    Sat Feb 17 07:56:00 2001
+++ phpdoc/fr/functions/mail.xml        Tue Jul 24 09:44:28 2001
@@ -1,172 +1,200 @@
- <reference id="ref.mail">
-  <title>Email</title>
-  <titleabbrev>Mail</titleabbrev>
-  <partintro>
+<reference id="ref.mail">
+ <title>Email</title>
+ <titleabbrev>Mail</titleabbrev>
+ <partintro>
   <simpara>
   <function>mail</function> envoie du courrier &eacute;l&eacute;ctronique.</simpara>
-  </partintro>
-  <refentry id="function.mail">
-   <refnamediv>
-    <refname>mail</refname>
-    <refpurpose>Envoi de mail</refpurpose>
-   </refnamediv>
-   <refsect1>
-    <title>Description</title>
-    <funcsynopsis>
-     <funcprototype>
-      <funcdef>bool <function>mail</function></funcdef>
-      <paramdef>string <parameter>to</parameter></paramdef>
-      <paramdef>string <parameter>subject</parameter></paramdef>
-      <paramdef>string <parameter>message</parameter></paramdef>
-      <paramdef>string
-       <parameter>
-        <optional>additional_headers</optional>
-       </parameter>
-      </paramdef>
-       <paramdef>string
-       <parameter>
-        <optional>additional_parameters</optional>
-       </parameter>
-      </paramdef>
-     </funcprototype>
-    </funcsynopsis>
-    <simpara>
-      <function>mail</function> poste automatiquement le message
-      <parameter>message</parameter> &agrave; destination de
-      <parameter>to</parameter>. Les destinataires multiples doivent &ecirc;tre
-      s&eacute;par&eacute;s par des virgules.
-    </simpara>
-    <para>
-     <example>
-      <title>Envoi de courrier &eacute;lectronique (mail)</title>
-      <programlisting role="php">
+ </partintro>
+ <refentry id="function.mail">
+  <refnamediv>
+   <refname>mail</refname>
+   <refpurpose>Envoi de mail</refpurpose>
+  </refnamediv>
+  <refsect1>
+   <title>Description</title>
+   <funcsynopsis>
+    <funcprototype>
+     <funcdef>boolean <function>mail</function></funcdef>
+     <paramdef>string <parameter>to</parameter></paramdef>
+     <paramdef>string <parameter>subject</parameter></paramdef>
+     <paramdef>string <parameter>message</parameter></paramdef>
+     <paramdef>string
+      <parameter>
+      <optional>additional_headers</optional>
+      </parameter>
+     </paramdef>
+     <paramdef>string
+      <parameter>
+      <optional>additional_parameters</optional>
+      </parameter>
+     </paramdef>
+    </funcprototype>
+   </funcsynopsis>
+   <simpara>
+    <function>mail</function> poste automatiquement le message
+    <parameter>message</parameter> &agrave; destination de
+    <parameter>to</parameter>. Les destinataires multiples doivent &ecirc;tre
+    s&eacute;par&eacute;s par des virgules. Les emails avec pi&egrave;ces jointes
+    ou contenus particuliers (comme les emails en HTML, par exemple), peuvent
+    &ecirc;tre r&eacute;alis&eacute;s avec cette fonction. Il faut respecter 
+l'encodage MIME. Pour
+    plus de d&eacute;tails, voyez
+    <ulink url="http://www.zend.com/zend/spotlight/sendmimeemailpart1.php";>
+    http://www.zend.com/zend/spotlight/sendmimeemailpart1.php</ulink> et
+       la RFC 1896 (Visit <ulink url="http://www.rfc-editor.org/";>
+       http://www.rfc-editor.org/</ulink>).
+   </simpara>
+   <para>
+    <function>mail</function> retourne <literal>TRUE</literal> si le mail
+    est envoy&eacute;, et <literal>FALSE</literal> sinon.
+   </para>
+   <para>
+    <example>
+     <title>Envoi de courrier &eacute;lectronique (mail)</title>
+     <programlisting role="php">
 &lt;?php
-mail("[EMAIL PROTECTED]", "Mon Sujet", "Ligne 1\nLigne 2\nLigne 3");
+  mail("[EMAIL PROTECTED]", "Mon Sujet", "Ligne 1\nLigne 2\nLigne 3");
 ?&gt;
-      </programlisting>
-     </example>
+     </programlisting>
+    </example>
+   </para>
+   <simpara>
+    Le quatri&egrave;me argument pass&eacute; sera ins&eacute;r&eacute; &agrave;
+    la fin de l'en-t&ecirc;te. Typiquement, cela permet d'ins&eacute;rer des
+    en-t&ecirc;tes suppl&eacute;mentaires. Les en-t&ecirc;tes multiples doivent
+    &ecirc;tre s&eacute;par&eacute;s par des virgules.
+   </simpara>
+   <note>
+    <para>
+     Sous Windows 32bits, vous devez utiliser <literal>\r\n</literal> pour
+     s&eacute;parer les en-t&ecirc;tes. Notez aussi que les en-t&ecirc;tes cc: et 
+bcc: sont
+     sensibles &agrave; la casse et doivent &ecirc;tre &eacute;crits 
+<literal>Cc:</literal>
+     et <literal>Bcc:</literal> sous Win32.
     </para>
-    <simpara>
-     Le quatri&egrave;me argument pass&eacute; sera ins&eacute;r&eacute; &agrave;
-     la fin de l'ent&ecirc;te. Typiquement, cela permet d'ins&eacute;rer des
-     ent&ecirc;tes suppl&eacute;mentaires. Les ent&ecirc;tes multiples doivent
-     &ecirc;tre s&eacute;par&eacute;s par des virgules.
-    </simpara>
-    <simpara>
-     Si le cinqui&egrave;me argument <parameter>additional_parameters</parameter>
-     est fourni, PHP l'utilisera dans son appel du programme d'envoi de
-     courrier &eacute;lectronique. Ceci est pratique pour passer une valeur
-     correcte &agrave; l'ent&ecirc;te <literal>Return-Path</literal>, avec sendmail.
-    </simpara>
-    <note>
-     <para>
-      Le cinqui&egrave;me param&egrave;tre a &eacute;t&eacute;
-      ajout&eacute; en PHP 4.0.5.
-     </para>
-    </note>
+   </note>
+   <simpara>
+    Si le cinqui&egrave;me argument <parameter>additional_parameters</parameter>
+    est fourni, PHP l'utilisera dans son appel du programme d'envoi de
+    courrier &eacute;lectronique. Ceci est pratique pour passer une valeur
+    correcte &agrave; l'en-t&ecirc;te <literal>Return-Path</literal>, avec sendmail.
+   </simpara>
+   <note>
     <para>
-     <example>
-      <title>Envoi de eMail avec des ent&ecirc;tes suppl&eacute;mentaires.</title>
-      <programlisting role="php">
+     Le cinqui&egrave;me param&egrave;tre a &eacute;t&eacute;
+     ajout&eacute; en PHP 4.0.5.
+    </para>
+   </note>
+   <para>
+    <example>
+     <title>Envoi de eMail avec des en-t&ecirc;tes suppl&eacute;mentaires.</title>
+     <programlisting role="php">
 &lt;?php
-mail("[EMAIL PROTECTED]", "Le sujet", $message,
-     "From: webmaster@$SERVER_NAME\nReply-To: webmaster@$SERVER_NAME\nX-Mailer: PHP/" 
. phpversion());
+  mail("[EMAIL PROTECTED]", "Le sujet", $message,
+       "From: webmaster@$SERVER_NAME\nReply-To: webmaster@$SERVER_NAME\nX-Mailer: 
+PHP/" . phpversion());
 ?&gt;
-      </programlisting>
-     </example>
-     Avec le cinqui&egrave;me param&egrave;tre, vous pouvez ajouter d'autres 
param&egrave;tres
-     de ligne de commande qui seront utilis&eacute;s par le programme d'envoi de
-     courrier. Dans l'exemple ci-dessous, l'ent&ecirc;te 
<literal>Return-Path</literal>
-     est correctement param&eacute;tr&eacute;. Normalement, sendmail ajoute 
automatiquement
-     l'ent&ecirc;te <literal>X-Authentication-Warning</literal> (param&egrave;tre -f),
-     car l'utilisateur "serveur web" n'est probablement pas un de ses
-     utilisateurs de confiance ("trusted users"). Pour supprimer cette
-     alerte, ajoutez l'utilisateur du serveur web dans la  configuration
-     de sendmail.
-     <example>
-      <title>
-       Envoi de eMail avec des ent&ecirc;tes suppl&eacute;mentaires et
-       un param&egrave;tre de ligne de commande suppl&eacute;mentaire
-      </title>
-      <programlisting>
+     </programlisting>
+    </example>
+    Avec le cinqui&egrave;me param&egrave;tre, vous pouvez ajouter d'autres 
+param&egrave;tres
+    de ligne de commande qui seront utilis&eacute;s par le programme d'envoi de
+    courrier. Dans l'exemple ci-dessous, l'en-t&ecirc;te 
+<literal>Return-Path</literal>
+    est correctement param&eacute;tr&eacute;. Normalement, sendmail ajoute 
+automatiquement
+    l'en-t&ecirc;te <literal>X-Authentication-Warning</literal> (param&egrave;tre -f),
+    car l'utilisateur "serveur web" n'est probablement pas un de ses
+    utilisateurs de confiance ("trusted users"). Pour supprimer cette
+    alerte, ajoutez l'utilisateur du serveur web dans la  configuration
+    de sendmail.
+    <example>
+     <title>
+      Envoi de eMail avec des en-t&ecirc;tes suppl&eacute;mentaires et
+      un param&egrave;tre de ligne de commande suppl&eacute;mentaire
+     </title>
+     <programlisting>
 &lt;?php
-mail("[EMAIL PROTECTED]", "the subject", $message,
-     "From: webmaster@$SERVER_NAME", "-fwebmaster@$SERVERNAME");
+  mail("[EMAIL PROTECTED]", "the subject", $message, "From: webmaster@$SERVER_NAME", 
+"-fwebmaster@$SERVERNAME");
 ?&gt;
-      </programlisting>
-     </example>
-     Vous pouvez aussi utiliser des techniques simples de
-     concat&eacute;nations de cha&icirc;nes pour construire des
-     messages complexes :
-     <example>
-      <title>Envoi de mail complexe.</title>
-      <programlisting role="php">
+     </programlisting>
+    </example>
+    Vous pouvez aussi utiliser des techniques simples de
+    concat&eacute;nations de cha&icirc;nes pour construire des
+    messages complexes :
+    <example>
+     <title>Envoi de mail complexe.</title>
+     <programlisting role="php">
 &lt;?php
-/* destinataire */
-$recipient .= "Mary &lt;[EMAIL PROTECTED]>".", " ; //remarquez les virgules
-$recipient .= "Kelly &lt;[EMAIL PROTECTED]>".", ";
-$recipient .= "[EMAIL PROTECTED]";
-/* sujet */
-$subject = "Rappel des anniversaires du mois d'aout";
-/* message */
-$message .= "Le mail suivant inclus une table au format ASCII\n";
-$message .= "Jour \t\tMois \t\tAn\n";
-$message .= "3 \t\tAou \t\t1970\n";
-$message .= "17\t\tAou \t\t1973\n";
-/* Vous pouvez ajouter une signature */
-$message .= "--\r\n"; //D&eacute;limiteur de signature
-$message .= "Rappel d'anniversaire : copyleft par public domain";
-/* d'autres ent&ecirc;tes : errors, From cc's, bcc's, etc */
-$headers .= "From: Rappel d'anniversaire &lt;[EMAIL PROTECTED]>\n";
-$headers .= "X-Sender: &lt;[EMAIL PROTECTED]>\n";
-$headers .= "X-Mailer: PHP\n"; // maileur
-$headers .= "X-Priority: 1\n"; //  Message urgent!
-$headers .= "Return-Path: &lt;[EMAIL PROTECTED]>\n";  // Re-chemin de retour pour les 
erreurs
-$headers .= "Content-Type: text/html; charset=iso-8859-1\n" // Type MIME
-$headers .= "cc:[EMAIL PROTECTED]\n"; // Champs CC
-$headers .= "bcc:[EMAIL PROTECTED], [EMAIL PROTECTED]\n"; // Champs BCCs
-/* et hop, &agrave; la poste */
-mail($recipient, $subject, $message, $headers);
+  /* destinataire */
+    $recipient .= "Mary &lt;[EMAIL PROTECTED]>".", " ; //remarquez les virgules
+    $recipient .= "Kelly &lt;[EMAIL PROTECTED]>".", ";
+    $recipient .= "[EMAIL PROTECTED]";
+  /* sujet */
+    $subject = "Rappel des anniversaires du mois d'ao&ucirc;t";
+  /* message */
+    $message .= "Le mail suivant inclut une table au format ASCII\n";
+    $message .= "Jour \t\tMois \t\tAn\n";
+    $message .= "3 \t\tAou\t\t1970\n";
+    $message .= "17\t\tAou\t\t1973\n";
+  /* Vous pouvez ajouter une signature */
+    $message .= "--\r\n";
+  //D&eacute;limiteur de signature
+    $message .= "Rappel d'anniversaire : copyleft par public domain";
+  /* D'autres en-t&ecirc;tes : errors, From cc's, bcc's, etc */
+    $headers .= "From: Rappel d'anniversaire &lt;[EMAIL PROTECTED]>\n";
+    $headers .= "X-Sender: &lt;[EMAIL PROTECTED]>\n";
+    $headers .= "X-Mailer: PHP\n"; // maileur
+    $headers .= "X-Priority: 1\n"; //  Message urgent!
+    $headers .= "Return-Path: &lt;[EMAIL PROTECTED]>\n";  // Re-chemin de retour pour 
+les erreurs
+    $headers .= "Content-Type: text/html; charset=iso-8859-1\n" // Type MIME
+    $headers .= "Cc:[EMAIL PROTECTED]\n"; // Champs CC
+    $headers .= "Bcc:[EMAIL PROTECTED], [EMAIL PROTECTED]"; // Champs BCCs
+  /* et hop, &agrave; la poste */
+    mail($recipient, $subject, $message, $headers);
 ?&gt;
-      </programlisting>
-     </example>
+     </programlisting>
+    </example>
+   </para>
+   <note>
+    <para>
+     Assurez-vous qu'il n'y a aucune nouvelle ligne (ou d'autre
+     espace ou caract&egrave;re blanc) dans les param&egrave;tres 
+<parameter>to</parameter>
+     ou <parameter>subject</parameter>, car cela peut avoir des effets
+     secondaires irrationnels.
     </para>
-   </refsect1>
-  </refentry>
+   </note>
+  </refsect1>
+ </refentry>
  <refentry id="function.ezmlm-hash">
-   <refnamediv>
-    <refname>ezmlm_hash</refname>
-    <refpurpose>Calcule la valeur de hash demand&eacute;e par EZMLM</refpurpose>
-   </refnamediv>
-   <refsect1>
-    <title>Description</title>
-    <funcsynopsis>
-     <funcprototype>
-      <funcdef>int <function>ezmlm_hash</function></funcdef>
-      <paramdef>string <parameter>addr</parameter></paramdef>
-     </funcprototype>
-    </funcsynopsis>
-    <simpara>
-     <function>ezmlm_hash</function> calcule la valeur de hash, n&eacute;cessaire
-     lors de la gestion de liste de diffusions EZMLM dans une base
-     de donn&eacute;es MySQL.
-    </simpara>
-    <para>
-     <example>
-      <title>Calcul du hash et enregistrement d'un utilisateur</title>
-      <programlisting role="php">
+  <refnamediv>
+   <refname>ezmlm_hash</refname>
+   <refpurpose>Calcule la valeur de hash demand&eacute;e par EZMLM</refpurpose>
+  </refnamediv>
+  <refsect1>
+   <title>Description</title>
+   <funcsynopsis>
+    <funcprototype>
+     <funcdef>int <function>ezmlm_hash</function></funcdef>
+     <paramdef>string <parameter>addr</parameter></paramdef>
+    </funcprototype>
+   </funcsynopsis>
+   <simpara>
+    <function>ezmlm_hash</function> calcule la valeur de hash, n&eacute;cessaire
+    lors de la gestion de liste de diffusions EZMLM dans une base
+    de donn&eacute;es MySQL.
+   </simpara>
+   <para>
+    <example>
+     <title>Calcul du hash et enregistrement d'un utilisateur</title>
+     <programlisting role="php">
 &lt;?php
-$user = "[EMAIL PROTECTED]";
-$hash = ezmlm_hash ($user);
-$query = sprintf ("INSERT INTO sample VALUES (%s, '%s')", $hash, $user);
-$db->query($query); // utilisation de l'interface PHPLIB
+  $user = "[EMAIL PROTECTED]";
+  $hash = ezmlm_hash($user);
+  $query = sprintf("INSERT INTO sample VALUES (%s, '%s')", $hash, $user);
+  $db->query($query); 
+// utilisation de l'interface PHPLIB
 ?&gt;
-      </programlisting>
-     </example>
-    </para>
-   </refsect1>
-  </refentry>
- </reference>
+     </programlisting>
+    </example>
+   </para>
+  </refsect1>
+ </refentry>
+</reference>
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml