cvs: phpdoc /fr/functions mail.xml

From: Date: Tue, 24 Jul 2001 13:44:28 +0000
Subject: cvs: phpdoc /fr/functions mail.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969336476@lists.php.net to get a copy of this message
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("rasmus@lerdorf.on.ca", "Mon Sujet", "Ligne 1\nLigne 2\nLigne 3"); + mail("rasmus@lerdorf.on.ca", "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("nobody@aol.com", "Le sujet", $message, - "From: webmaster@$SERVER_NAME\nReply-To: webmaster@$SERVER_NAME\nX-Mailer: PHP/" . phpversion()); + mail("nobody@aol.com", "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("nobody@aol.com", "the subject", $message, - "From: webmaster@$SERVER_NAME", "-fwebmaster@$SERVERNAME"); + mail("nobody@aol.com", "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;mary@u.college.edu>".", " ; //remarquez les virgules -$recipient .= "Kelly &lt;kelly@u.college.edu>".", "; -$recipient .= "ronabop@php.net"; -/* 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;birthday@php.net>\n"; -$headers .= "X-Sender: &lt;birthday@php.net>\n"; -$headers .= "X-Mailer: PHP\n"; // maileur -$headers .= "X-Priority: 1\n"; // Message urgent! -$headers .= "Return-Path: &lt;birthday@php.net>\n"; // Re-chemin de retour pour les erreurs -$headers .= "Content-Type: text/html; charset=iso-8859-1\n" // Type MIME -$headers .= "cc:birthdayarchive@php.net\n"; // Champs CC -$headers .= "bcc:birthdaycheck@php.net, birthdaygifts@php.net\n"; // Champs BCCs -/* et hop, &agrave; la poste */ -mail($recipient, $subject, $message, $headers); + /* destinataire */ + $recipient .= "Mary &lt;mary@u.college.edu>".", " ; //remarquez les virgules + $recipient .= "Kelly &lt;kelly@u.college.edu>".", "; + $recipient .= "ronabop@php.net"; + /* 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;birthday@php.net>\n"; + $headers .= "X-Sender: &lt;birthday@php.net>\n"; + $headers .= "X-Mailer: PHP\n"; // maileur + $headers .= "X-Priority: 1\n"; // Message urgent! + $headers .= "Return-Path: &lt;birthday@php.net>\n"; // Re-chemin de retour pour les erreurs + $headers .= "Content-Type: text/html; charset=iso-8859-1\n" // Type MIME + $headers .= "Cc:birthdayarchive@php.net\n"; // Champs CC + $headers .= "Bcc:birthdaycheck@php.net, birthdaygifts@php.net"; // 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 = "kris@koehntopp.de"; -$hash = ezmlm_hash ($user); -$query = sprintf ("INSERT INTO sample VALUES (%s, '%s')", $hash, $user); -$db->query($query); // utilisation de l'interface PHPLIB + $user = "kris@koehntopp.de"; + $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
« previous php.doc (#969336476) next »