www/plugins/facteur/inc/envoyer_mail.php

   1 <?php
   2 /*
   3  * Plugin Facteur 2
   4  * (c) 2009-2011 Collectif SPIP
   5  * Distribue sous licence GPL
   6  *
   7  */
   8
   9 if (!defined("_ECRIRE_INC_VERSION")) return;
  10
  11 include_spip('classes/facteur');
  12 // inclure le fichier natif de SPIP, pour les fonctions annexes
  13 include_once _DIR_RESTREINT."inc/envoyer_mail.php";
  14
  15 /**
  16  * @param string $destinataire
  17  * @param string $sujet
  18  * @param string|array $corps
  19  *   au format string, c'est un corps d'email au format texte, comme supporte nativement par le core
  20  *   au format array, c'est un corps etendu qui peut contenir
  21  *     string texte : le corps d'email au format texte
  22  *     string html : le corps d'email au format html
  23  *     string from : email de l'envoyeur (prioritaire sur argument $from de premier niveau, deprecie)
  24  *     string nom_envoyeur : un nom d'envoyeur pour completer l'email from
  25  *     string cc : destinataires en copie conforme
  26  *     string bcc : destinataires en copie conforme cachee
  27  *     string|array repondre_a : une ou plusieurs adresses à qui répondre
  28  *     string adresse_erreur : addresse de retour en cas d'erreur d'envoi
  29  *     array pieces_jointes : listes de pieces a embarquer dans l'email, chacune au format array :
  30  *       string chemin : chemin file system pour trouver le fichier a embarquer
  31  *       string nom : nom du document tel qu'apparaissant dans l'email
  32  *       string encodage : encodage a utiliser, parmi 'base64', '7bit', '8bit', 'binary', 'quoted-printable'
  33  *       string mime : mime type du document
  34  *     array headers : tableau d'en-tetes personalises, une entree par ligne d'en-tete
  35  * @param string $from (deprecie, utiliser l'entree from de $corps)
  36  * @param string $headers (deprecie, utiliser l'entree headers de $corps)
  37  * @return bool
  38  */
  39 function inc_envoyer_mail($destinataire, $sujet, $corps, $from = "", $headers = "") {
  40         $message_html   = '';
  41         $message_texte  = '';
  42
  43         // si $corps est un tableau -> fonctionnalites etendues
  44         // avec entrees possible : html, texte, pieces_jointes, nom_envoyeur, ...
  45         if (is_array($corps)) {
  46                 $message_html   = $corps['html'];
  47                 $message_texte  = nettoyer_caracteres_mail($corps['texte']);
  48                 $pieces_jointes = $corps['pieces_jointes'];
  49                 $nom_envoyeur = $corps['nom_envoyeur'];
  50                 $from = (isset($corps['from'])?$corps['from']:$from);
  51                 $cc = $corps['cc'];
  52                 $bcc = $corps['bcc'];
  53                 $repondre_a = $corps['repondre_a'];
  54                 $adresse_erreur = $corps['adresse_erreur'];
  55                 $headers = (isset($corps['headers'])?$corps['headers']:$headers);
  56                 if (is_string($headers))
  57                         $headers = array_map('trim',explode("\n",$headers));
  58         }
  59         // si $corps est une chaine -> compat avec la fonction native SPIP
  60         // gerer le cas ou le corps est du html avec un Content-Type: text/html dans les headers
  61         else {
  62                 if (preg_match(',Content-Type:\s*text/html,ims',$headers)){
  63                         $message_html   = $corps;
  64                 }
  65                 else {
  66                         $message_texte  = nettoyer_caracteres_mail($corps);
  67                 }
  68                 $headers = array_map('trim',explode("\n",$headers));
  69         }
  70         $sujet = nettoyer_titre_email($sujet);
  71
  72         // si le mail est en texte brut, on l'encapsule dans un modele surchargeable
  73         // pour garder le texte brut, il suffit de faire un modele qui renvoie uniquement #ENV*{texte}
  74         if ($message_texte AND ! $message_html){
  75                 $message_html = recuperer_fond("emails/texte",array('texte'=>$message_texte,'sujet'=>$sujet));
  76         }
  77
  78         // mode TEST : forcer l'email
  79         if (defined('_TEST_EMAIL_DEST')) {
  80                 if (!_TEST_EMAIL_DEST)
  81                         return false;
  82                 else
  83                         $destinataire = _TEST_EMAIL_DEST;
  84         }
  85
  86         // plusieurs destinataires peuvent etre fournis separes par des virgules
  87         // c'est un format standard dans l'envoi de mail
  88         // les passer au format array pour phpMailer
  89         // mais ne pas casser si on a deja un array en entree
  90         if (is_array($destinataire))
  91                 $destinataire = implode(", ",$destinataire);
  92         $destinataire = array_map('trim',explode(",",$destinataire));
  93
  94         // On crée l'objet Facteur (PHPMailer) pour le manipuler ensuite
  95         $facteur = new Facteur($destinataire, $sujet, $message_html, $message_texte);
  96
  97         // On ajoute le courriel de l'envoyeur s'il est fournit par la fonction
  98         if (empty($from) AND empty($facteur->From)) {
  99                 $from = $GLOBALS['meta']["email_envoi"];
 100                 if (empty($from) OR !email_valide($from)) {
 101                         spip_log("Meta email_envoi invalide. Le mail sera probablement vu comme spam.");
 102                         $from = $destinataire;
 103                 }
 104         }
 105
 106         // "Marie Toto <Marie@toto.com>"
 107         if (preg_match(",^([^<>\"]*)<([^<>\"]+)>$,i",$from,$m)){
 108                 $nom_envoyeur = trim($m[1]);
 109                 $from = trim($m[2]);
 110         }
 111         if (!empty($from)){
 112                 $facteur->From = $from;
 113                 // la valeur par défaut de la config n'est probablement pas valable pour ce mail,
 114                 // on l'écrase pour cet envoi
 115                 $facteur->FromName = $from;
 116         }
 117
 118         // On ajoute le nom de l'envoyeur s'il fait partie des options
 119         if ($nom_envoyeur)
 120                 $facteur->FromName = $nom_envoyeur;
 121
 122         // Si plusieurs emails dans le from, pas de Name !
 123         if (strpos($facteur->From,",")!==false){
 124                 $facteur->FromName = "";
 125         }
 126
 127         // S'il y a des copies à envoyer
 128         if ($cc){
 129                 if (is_array($cc))
 130                         foreach ($cc as $courriel)
 131                                 $facteur->AddCC($courriel);
 132                 else
 133                         $facteur->AddCC($cc);
 134         }
 135
 136         // S'il y a des copies cachées à envoyer
 137         if ($bcc){
 138                 if (is_array($bcc))
 139                         foreach ($bcc as $courriel)
 140                                 $facteur->AddBCC($courriel);
 141                 else
 142                         $facteur->AddBCC($bcc);
 143         }
 144
 145         // S'il y a des copies cachées à envoyer
 146         if ($repondre_a){
 147                 if (is_array($repondre_a))
 148                         foreach ($repondre_a as $courriel)
 149                                 $facteur->AddReplyTo($courriel);
 150                 else
 151                         $facteur->AddReplyTo($repondre_a);
 152         }
 153
 154         // S'il y a des pièces jointes on les ajoute proprement
 155         if (count($pieces_jointes)) {
 156                 foreach ($pieces_jointes as $piece) {
 157                         $facteur->AddAttachment(
 158                                 $piece['chemin'],
 159                                 isset($piece['nom']) ? $piece['nom']:'',
 160                                 (isset($piece['encodage']) AND in_array($piece['encodage'],array('base64', '7bit', '8bit', 'binary', 'quoted-printable'))) ? $piece['encodage']:'base64',
 161                                 isset($piece['mime']) ? $piece['mime']:Facteur::_mime_types(pathinfo($piece['chemin'], PATHINFO_EXTENSION))
 162                         );
 163                 }
 164         }
 165
 166         // Si une adresse email a été spécifiée pour les retours en erreur, on l'ajoute
 167         if (!empty($adresse_erreur))
 168                 $facteur->Sender = $adresse_erreur;
 169
 170         // si entetes personalises : les ajouter
 171         // bug : semble ecraser les autres headers. A debug si on veut le rendre fonctionnel
 172         //if (!empty($headers)) {
 173         //      foreach($headers as $h)
 174         //              $facteur->AddCustomHeader($h);
 175         //}
 176
 177         // On passe dans un pipeline pour modifier tout le facteur avant l'envoi
 178         $facteur = pipeline('facteur_pre_envoi', $facteur);
 179
 180         // On génère les headers
 181         $head = $facteur->CreateHeader();
 182
 183         // Et c'est parti on envoie enfin
 184         spip_log("mail via facteur\n$head"."Destinataire:".print_r($destinataire,true),'mail');
 185         spip_log("mail\n$head"."Destinataire:".print_r($destinataire,true),'facteur');
 186         $retour = $facteur->Send();
 187
 188         if (!$retour)
 189                 spip_log("Erreur Envoi mail via Facteur : ".print_r($facteur->ErrorInfo,true),'facteur');
 190
 191         return $retour ;
 192 }
 193
 194 ?>