ldapsaisie/doc/conf/LSaddon/LSaddon_mail.docbook

<sect2 id="config-LSaddon_mail">
  <title>LSaddon_mail</title>
  <para>Cet &LSaddon; est utilisé pour gérer l'envoie de mail. Il utilise
  pour cela les librairies &PEAR; <emphasis>Mail</emphasis> et <emphasis>
  Mail_Mime</emphasis> qui doivent être installés. Cet &LSaddon; doit être
  configuré en éditant son fichier de configuration
  <literal>config.LSaddons.mail.php</literal>.</para>

  <programlisting linenumbering="unnumbered">
<citetitle>Structure du fichier</citetitle>/*
 ***********************************************
 * Configuration du support de l'envoi de mail *
 ***********************************************
 */

// Pear :: Mail
define('PEAR_MAIL','/usr/share/php/Mail.php');

// Pear :: Mail_mime
define('PEAR_MAIL_MIME','/usr/share/php/Mail/mime.php');

/*
 * Méthode d'envoie :
 *  - mail : envoie avec la méthode PHP mail()
 *  - sendmail : envoie la commande sendmail du système
 *  - smtp : envoie en utilisant un serveur SMTP
 */
define('MAIL_SEND_METHOD','smtp');

/*
 * Paramètres d'envoie :
 *   Ces paramètres dépende de la méthode utilisé. Repporté vous à la documentation
 *   de PEAR :: Mail pour plus d'information.
 *   Lien : http://pear.php.net/manual/en/package.mail.mail.factory.php
 * Infos :
 *  List of parameter for the backends
 *  mail
 *    o If safe mode is disabled, $params will be passed as the fifth
 *      argument to the PHP mail() function. If $params is an array,
 *      its elements will be joined as a space-delimited string.
 *  sendmail
 *    o $params["sendmail_path"] - The location of the sendmail program
 *      on the filesystem. Default is /usr/bin/sendmail.
 *    o $params["sendmail_args"] - Additional parameters to pass to the
 *      sendmail. Default is -i.
 *  smtp
 *    o $params["host"] - The server to connect. Default is localhost.
 *    o $params["port"] - The port to connect. Default is 25.
 *    o $params["auth"] - Whether or not to use SMTP authentication.
 *      Default is FALSE.
 *    o $params["username"] - The username to use for SMTP authentication.
 *    o $params["password"] - The password to use for SMTP authentication.
 *    o $params["localhost"] - The value to give when sending EHLO or HELO.
 *      Default is localhost
 *    o $params["timeout"] - The SMTP connection timeout.
 *      Default is NULL (no timeout).
 *    o $params["verp"] - Whether to use VERP or not. Default is FALSE.
 *    o $params["debug"] - Whether to enable SMTP debug mode or not.
 *      Default is FALSE.
 *    o $params["persist"] - Indicates whether or not the SMTP connection
 *      should persist over multiple calls to the send() method.
 */
$GLOBALS['MAIL_SEND_PARAMS'] = NULL;

/*
 * Headers :
 */
$GLOBALS['MAIL_HEARDERS = array();

// Catch all sent emails
$GLOBALS['MAIL_CATCH_ALL'] = array();
</programlisting>

<para>Cet &LSaddon; offre la possibilité d'utilisé la fonction &php;
<function>sendMail()</function>.
<funcsynopsis>
<funcprototype>
  <funcdef>bool <function>sendMail</function></funcdef>
    <paramdef>string <parameter>$to</parameter></paramdef>
    <paramdef>string <parameter>$subject</parameter></paramdef>
    <paramdef>string <parameter>$msg</parameter></paramdef>
    <paramdef>array <parameter>$headers</parameter></paramdef>
    <paramdef>array <parameter>$attachments</parameter></paramdef>
    <paramdef>string <parameter>$eol</parameter></paramdef>
    <paramdef>string <parameter>$encoding</parameter></paramdef>
    <paramdef>boolean <parameter>$html</parameter></paramdef>
</funcprototype>
</funcsynopsis>
</para>
</sect2>