Configuration des mails » History » Version 9
Simon, 08/11/2022 05:04 AM
| 1 | 4 | Simon | h1. Configuration du système d'envoi d'emails |
|---|---|---|---|
| 2 | 1 | Simon | |
| 3 | 7 | Simon | L'envoi d'emails par l'application repose sur la librairie PHP SwiftMailer [[http://swiftmailer.org]]. |
| 4 | |||
| 5 | 6 | Simon | h2. Sendmail, configuration par défaut |
| 6 | 1 | Simon | |
| 7 | 6 | Simon | Par défaut, l'application est configurée pour envoyer les messages avec _sendmail_. |
| 8 | 4 | Simon | |
| 9 | 6 | Simon | <pre> |
| 10 | <code class="php"> |
||
| 11 | [MAIL_SETTINGS] |
||
| 12 | |||
| 13 | MAIL_SENDMAIL = "/usr/sbin/sendmail -t -i" |
||
| 14 | MAIL_PORT = 25 |
||
| 15 | MAIL_MAILER = "sendmail" |
||
| 16 | </code> |
||
| 17 | </pre> |
||
| 18 | |||
| 19 | |||
| 20 | |||
| 21 | h2. Utiliser un serveur SMTP |
||
| 22 | |||
| 23 | *MAIL_MAILER* prend la valeur _'smtp'_. Indiquez l'adresse du serveur via *MAIL_HOST*. Le port peut être changé (_25_ est le port par défaut). |
||
| 24 | |||
| 25 | h3. en mode non-authentifié |
||
| 26 | |||
| 27 | <pre> |
||
| 28 | <code class="php"> |
||
| 29 | [MAIL_SETTINGS] |
||
| 30 | |||
| 31 | MAIL_PORT = 25 |
||
| 32 | MAIL_MAILER = "smtp" |
||
| 33 | MAIL_HOST = "your.smtp.net" |
||
| 34 | MAIL_SMTP_AUTH = 0 |
||
| 35 | MAIL_SMTP_USER = "" |
||
| 36 | MAIL_SMTP_PASS = "" |
||
| 37 | </code> |
||
| 38 | </pre> |
||
| 39 | |||
| 40 | |||
| 41 | h3. en mode authentifié |
||
| 42 | |||
| 43 | <pre> |
||
| 44 | <code class="php"> |
||
| 45 | [MAIL_SETTINGS] |
||
| 46 | |||
| 47 | MAIL_PORT = 25 |
||
| 48 | MAIL_MAILER = "smtp" |
||
| 49 | MAIL_HOST = "your.smtp.net" |
||
| 50 | MAIL_SMTP_AUTH = 1 |
||
| 51 | MAIL_SMTP_USER = "utilisateur" |
||
| 52 | MAIL_SMTP_PASS = "motdepasse" |
||
| 53 | </code> |
||
| 54 | </pre> |
||
| 55 | 7 | Simon | |
| 56 | |||
| 57 | 8 | Simon | h2. Choisir un envoi différé |
| 58 | |||
| 59 | |||
| 60 | Il est possible de configurer l'envoi différé d'email de masse. Pour cela remplacez la valeur de MAIL_BULK par défaut paramétrée à 'nodelay' par un entier. Cet entier désigne le nombre d'emails à traiter par lot. Veillez à ce que la valeur soit compatible avec les limitations imposées par votre hébergeur Web, le cas échéant. |
||
| 61 | |||
| 62 | <pre> |
||
| 63 | <code class="php"> |
||
| 64 | [MAIL_SETTINGS] |
||
| 65 | |||
| 66 | MAIL_BULK = 200 |
||
| 67 | </code> |
||
| 68 | </pre> |
||
| 69 | |||
| 70 | Par défaut, le script d'envoi différé est exécuté chaque 10 minutes. Si ce rythme ne vous convient pas vous pouvez modifier son comportement en vous référent à la "documentation de référence":http://dev.linea21.com/projects/linea21/wiki/CronJobs#Localisation-des-Cronjobs. |
||
| 71 | |||
| 72 | 7 | Simon | h2. Utiliser la fonction PHP native _mail()_ |
| 73 | |||
| 74 | Bien que l'application utilise par défaut SwiftMailer, il est possible d'envoyer les emails directement via la fonction native PHP _email()_. |
||
| 75 | 9 | Simon | Pour cela il suffit de préciser à MAIL_MAILER une valeur qui n'est ni `smtp` ni `sendmail`. Pour des questions de lisibilité, nous vous invitons à choisir une valeur explicite telle que `PHP`, `mail`, `php_mail`, ... |
| 76 | 1 | Simon | |
| 77 | 9 | Simon | *Attention : cette option n'est plus disponible en version 2.6, en raison d'une mise à jour de la librairire SwiftMailer qui a supprimé cette possibilité pour des raisons de sécurité.* |
| 78 | 6 | Simon | |
| 79 | 4 | Simon | h2. Sur un hébergement Free.fr |
| 80 | |||
| 81 | |||
| 82 | Free est gratuit mais certains paramétrages y sont spécifiques. |
||
| 83 | |||
| 84 | Par conséquent, *MAIL_MAILER* doit prendre la valeur "*mail*" |
||
| 85 | |||
| 86 | <pre> |
||
| 87 | 6 | Simon | <code class="php"> |
| 88 | 1 | Simon | [MAIL_SETTINGS] |
| 89 | MAIL_USE_SSL = 0 |
||
| 90 | MAIL_SENDMAIL = "/usr/sbin/sendmail -t -i" |
||
| 91 | MAIL_MAILER_SSL = 0 |
||
| 92 | MAIL_HOST_SSL = 0 |
||
| 93 | MAIL_PORT_SSL = 465 |
||
| 94 | MAIL_MAILER = "mail" |
||
| 95 | MAIL_HOST = 0 |
||
| 96 | MAIL_SMTP_AUTH = 0 |
||
| 97 | MAIL_SMTP_USER = 0 |
||
| 98 | MAIL_SMTP_PASS = 0 |
||
| 99 | 6 | Simon | </code> |
| 100 | 4 | Simon | </pre> |
| 101 | 3 | Simon | |
| 102 | |||
| 103 | 4 | Simon | _Remarque_ : Free.fr ajoute des entêtes spécifiques - et exotiques (XPARM / XPARAM2) au message envoyé via la fonction PHP _mail()_ (la seule disponible). |
| 104 | *Nous avons constaté que certains serveurs de mail refusaient les messages contenant ces entêtes.* |
||
| 105 | 3 | Simon | |
| 106 | 4 | Simon | _Linea21 n'est pas responsable de ce désagrément_. Choisissez un hébergement de type professionnel si vos exigences sont professionnelles. |