source: spip-zone/_plugins_/facteur/trunk/inc/envoyer_mail.php @ 107582

Last change on this file since 107582 was 107582, checked in by bystrano@…, 3 years ago

ajouter une option nom_repondre_a à la fonction envoyer_mail

Pour donner un nom d'envoyeur à l'adresse Reply-to

File size: 10.7 KB
Line 
1<?php
2/*
3 * Plugin Facteur 2
4 * (c) 2009-2011 Collectif SPIP
5 * Distribue sous licence GPL
6 *
7 */
8
9if (!defined("_ECRIRE_INC_VERSION")) return;
10
11include_spip('classes/facteur');
12// inclure le fichier natif de SPIP, pour les fonctions annexes
13include_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 nom_repondre_a : le nom d'envoyeur pour compléter l'email repondre_a
29 *     string adresse_erreur : addresse de retour en cas d'erreur d'envoi
30 *     array pieces_jointes : listes de pieces a embarquer dans l'email, chacune au format array :
31 *       string chemin : chemin file system pour trouver le fichier a embarquer
32 *       string nom : nom du document tel qu'apparaissant dans l'email
33 *       string encodage : encodage a utiliser, parmi 'base64', '7bit', '8bit', 'binary', 'quoted-printable'
34 *       string mime : mime type du document
35 *     array headers : tableau d'en-tetes personalises, une entree par ligne d'en-tete
36 *     bool exceptions : lancer une exception en cas d'erreur (false par defaut)
37 * @param string $from (deprecie, utiliser l'entree from de $corps)
38 * @param string $headers (deprecie, utiliser l'entree headers de $corps)
39 * @return bool
40 */
41function inc_envoyer_mail($destinataire, $sujet, $corps, $from = "", $headers = "") {
42        $message_html   = '';
43        $message_texte  = '';
44        $nom_envoyeur = $cc = $bcc = $repondre_a = '';
45        $pieces_jointes = array();
46
47        // si $corps est un tableau -> fonctionnalites etendues
48        // avec entrees possible : html, texte, pieces_jointes, nom_envoyeur, ...
49        if (is_array($corps)) {
50                $message_html   = isset($corps['html']) ? $corps['html'] : "";
51                $message_texte  = isset($corps['texte']) ? nettoyer_caracteres_mail($corps['texte']) : "";
52                $pieces_jointes = isset($corps['pieces_jointes']) ? $corps['pieces_jointes'] : array();
53                $nom_envoyeur   = isset($corps['nom_envoyeur']) ? $corps['nom_envoyeur'] : "";
54                $from = isset($corps['from']) ? $corps['from']: $from;
55                $cc   = isset($corps['cc']) ? $corps['cc'] : "";
56                $bcc  = isset($corps['bcc']) ? $corps['bcc'] : "";
57                $repondre_a = isset($corps['repondre_a']) ? $corps['repondre_a'] : "";
58                $nom_repondre_a = isset($corps['nom_repondre_a']) ? $corps['nom_repondre_a'] : '';
59                $adresse_erreur = isset($corps['adresse_erreur']) ? $corps['adresse_erreur'] : "";
60                $headers = isset($corps['headers']) ? $corps['headers'] : $headers;
61                if (is_string($headers)){
62                        $headers = array_map('trim',explode("\n",$headers));
63                        $headers = array_filter($headers);
64                }
65        }
66        // si $corps est une chaine -> compat avec la fonction native SPIP
67        // gerer le cas ou le corps est du html avec un Content-Type: text/html dans les headers
68        else {
69                if (preg_match(',Content-Type:\s*text/html,ims',$headers)){
70                        $message_html   = $corps;
71                }
72                else {
73                        // Autodetection : tester si le mail est en HTML
74                        if (strpos($headers,"Content-Type:")===false
75                                AND strpos($corps,"<")!==false // eviter les tests suivants si possible
76                                AND $ttrim = trim($corps)
77                                AND substr($ttrim,0,1)=="<"
78                                AND substr($ttrim,-1,1)==">"
79                                AND stripos($ttrim,"</html>")!==false){
80
81                                if(!strlen($sujet)){
82                                        // dans ce cas on ruse un peu : extraire le sujet du title
83                                        if (preg_match(",<title>(.*)</title>,Uims",$corps,$m))
84                                                $sujet = $m[1];
85                                        else {
86                                                // fallback, on prend le body si on le trouve
87                                                if (preg_match(",<body[^>]*>(.*)</body>,Uims",$corps,$m))
88                                                        $ttrim = $m[1];
89
90                                                // et on extrait la premiere ligne de vrai texte...
91                                                // nettoyer le html et les retours chariots
92                                                $ttrim = textebrut($ttrim);
93                                                $ttrim = str_replace("\r\n", "\r", $ttrim);
94                                                $ttrim = str_replace("\r", "\n", $ttrim);
95                                                // decouper
96                                                $ttrim = explode("\n",trim($ttrim));
97                                                // extraire la premiere ligne de texte brut
98                                                $sujet = array_shift($ttrim);
99                                        }
100                                }
101                                $message_html   = $corps;
102                        }
103                        // c'est vraiment un message texte
104                        else
105                                $message_texte  = nettoyer_caracteres_mail($corps);
106                }
107                $headers = array_map('trim',explode("\n",$headers));
108                $headers = array_filter($headers);
109        }
110        $sujet = nettoyer_titre_email($sujet);
111
112        // si le mail est en texte brut, on l'encapsule dans un modele surchargeable
113        // pour garder le texte brut, il suffit de faire un modele qui renvoie uniquement #ENV*{texte}
114        if ($message_texte AND ! $message_html){
115                $message_html = recuperer_fond("emails/texte",array('texte'=>$message_texte,'sujet'=>$sujet));
116        }
117        // si le mail est en HTML sans alternative, la generer
118        if ($message_html AND !$message_texte){
119                $message_texte = facteur_mail_html2text($message_html);
120        }
121
122        $exceptions = false;
123        if (is_array($corps) AND isset($corps['exceptions'])){
124                $exceptions = $corps['exceptions'];
125        }
126
127        // mode TEST : forcer l'email
128        if (defined('_TEST_EMAIL_DEST')) {
129                if (!_TEST_EMAIL_DEST){
130                        spip_log($e="Envois bloques par la constante _TEST_EMAIL_DEST", 'mail.' . _LOG_ERREUR);
131                        if ($exceptions) {
132                                throw new Exception($e);
133                        }
134                        return false;
135                }
136                else
137                        $destinataire = _TEST_EMAIL_DEST;
138        }
139
140        // plusieurs destinataires peuvent etre fournis separes par des virgules
141        // c'est un format standard dans l'envoi de mail
142        // les passer au format array pour phpMailer
143        // mais ne pas casser si on a deja un array en entree
144        // si pas destinataire du courriel on renvoie false (eviter les warning PHP : ligne 464 de phpmailer-php5/class.phpmailer.php
145        // suppression des adresses de courriels invalides, si aucune valide, renvoyer false (eviter un warning PHP : ligne 464 de phpmailer-php5/class.phpmailer.php)
146        if (is_array($destinataire))
147                $destinataire = implode(", ",$destinataire);
148
149        if(strlen($destinataire) > 0){
150                $destinataire = array_map('trim',explode(",",$destinataire));
151                foreach ($destinataire as $key => $value) {
152                        if(!email_valide($value))
153                                unset($destinataire[$key]);
154                }
155                if(count($destinataire) == 0) {
156                        spip_log($e="Aucune adresse email de destination valable pour l'envoi du courriel.", 'mail.' . _LOG_ERREUR);
157                        if ($exceptions) {
158                                throw new Exception($e);
159                        }
160                        return false;
161                }
162        }
163        else {
164                if ($bcc) {
165                        // On peut envoyer de mail que en bcc
166                        $destinataire = '';
167                } else {
168                        spip_log($e="Aucune adresse email de destination valable pour l'envoi du courriel.", 'mail.' . _LOG_ERREUR);
169                        if ($exceptions) {
170                                throw new Exception($e);
171                        }
172                        return false;
173                }
174        }
175
176        // On crée l'objet Facteur (PHPMailer) pour le manipuler ensuite
177        $facteur = new Facteur($destinataire, $sujet, $message_html, $message_texte);
178        if (is_array($corps) AND isset($corps['exceptions'])){
179                $facteur->SetExceptions($corps['exceptions']);
180        }
181
182        // On ajoute le courriel de l'envoyeur s'il est fournit par la fonction
183        if (empty($from) AND empty($facteur->From)) {
184                $from = $GLOBALS['meta']["email_envoi"];
185                if (empty($from) OR !email_valide($from)) {
186                        spip_log("Meta email_envoi invalide. Le mail sera probablement vu comme spam.", 'mail.' . _LOG_ERREUR);
187                        if(is_array($destinataire) && count($destinataire) > 0)
188                                $from = $destinataire[0];
189                        else
190                                $from = $destinataire;
191                }
192        }
193
194        // "Marie Toto <Marie@toto.com>"
195        if (preg_match(",^([^<>\"]*)<([^<>\"]+)>$,i",$from,$m)){
196                $nom_envoyeur = trim($m[1]);
197                $from = trim($m[2]);
198        }
199        if (!empty($from)){
200                $facteur->From = $from;
201                // la valeur par défaut de la config n'est probablement pas valable pour ce mail,
202                // on l'écrase pour cet envoi
203                $facteur->FromName = $from;
204        }
205
206        // On ajoute le nom de l'envoyeur s'il fait partie des options
207        if ($nom_envoyeur)
208                $facteur->FromName = $nom_envoyeur;
209
210        // Si plusieurs emails dans le from, pas de Name !
211        if (strpos($facteur->From,",")!==false){
212                $facteur->FromName = "";
213        }
214
215        // S'il y a des copies à envoyer
216        if ($cc){
217                if (is_array($cc))
218                        foreach ($cc as $courriel)
219                                $facteur->AddCC($courriel);
220                else
221                        $facteur->AddCC($cc);
222        }
223
224        // S'il y a des copies cachées à envoyer
225        if ($bcc){
226                if (is_array($bcc))
227                        foreach ($bcc as $courriel)
228                                $facteur->AddBCC($courriel);
229                else
230                        $facteur->AddBCC($bcc);
231        }
232
233        // S'il y a une adresse de reply-to
234        if ($repondre_a){
235                if (is_array($repondre_a))
236                        foreach ($repondre_a as $courriel)
237                                $facteur->AddReplyTo($courriel);
238                } elseif ($nom_repondre_a) {
239                        $facteur->AddReplyTo($repondre_a, $nom_repondre_a);
240                } else {
241                        $facteur->AddReplyTo($repondre_a);
242                }
243        }
244
245        // S'il y a des pièces jointes on les ajoute proprement
246        if (count($pieces_jointes)) {
247                foreach ($pieces_jointes as $piece) {
248                        $facteur->AddAttachment(
249                                $piece['chemin'],
250                                isset($piece['nom']) ? $piece['nom']:'',
251                                (isset($piece['encodage']) AND in_array($piece['encodage'],array('base64', '7bit', '8bit', 'binary', 'quoted-printable'))) ? $piece['encodage']:'base64',
252                                isset($piece['mime']) ? $piece['mime']:Facteur::_mime_types(pathinfo($piece['chemin'], PATHINFO_EXTENSION))
253                        );
254                }
255        }
256
257        // Si une adresse email a été spécifiée pour les retours en erreur, on l'ajoute
258        if (!empty($adresse_erreur))
259                $facteur->Sender = $adresse_erreur;
260
261        // si entetes personalises : les ajouter
262        // attention aux collisions : si on utilise l'option cc de $corps
263        // et qu'on envoie en meme temps un header Cc: xxx, yyy
264        // on aura 2 lignes Cc: dans les headers
265        if (!empty($headers)) {
266                foreach($headers as $h){
267                        // verifions le format correct : il faut au moins un ":" dans le header
268                        // et on filtre le Content-Type: qui sera de toute facon fourni par facteur
269                        if (strpos($h,":")!==false
270                          AND strncmp($h,"Content-Type:",13)!==0)
271                                $facteur->AddCustomHeader($h);
272                }
273        }
274
275        // On passe dans un pipeline pour modifier tout le facteur avant l'envoi
276        $facteur = pipeline('facteur_pre_envoi', $facteur);
277
278        // On génère les headers
279        $head = $facteur->CreateHeader();
280
281        // Et c'est parti on envoie enfin
282        spip_log("mail via facteur\n$head"."Destinataire:".print_r($destinataire,true),'mail');
283        spip_log("mail\n$head"."Destinataire:".print_r($destinataire,true),'facteur');
284        $retour = $facteur->Send();
285
286        if (!$retour){
287                spip_log("Erreur Envoi mail via Facteur : ".print_r($facteur->ErrorInfo,true),'mail.'._LOG_ERREUR);
288        }
289
290        return $retour ;
291}
Note: See TracBrowser for help on using the repository browser.