Project

General

Profile

Edit History

Documentation Linea v1x »

Configuration des mails » History » Version 8

Simon, 05/21/2015 04:48 PM

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
    
    
    
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
    6
    Simon
    





    77
    
    
    





    78
    4
    Simon
    
h2. Sur un hébergement Free.fr





    79
    
    
    





    80
    
    
    





    81
    
    
    
Free est gratuit mais certains paramétrages y sont spécifiques.





    82
    
    
    





    83
    
    
    
Par conséquent, *MAIL_MAILER* doit prendre la valeur "*mail*"





    84
    
    
    





    85
    
    
    
<pre>





    86
    6
    Simon
    
<code class="php">





    87
    1
    Simon
    
[MAIL_SETTINGS]





    88
    
    
    
MAIL_USE_SSL       = 0





    89
    
    
    
MAIL_SENDMAIL       = "/usr/sbin/sendmail -t -i"





    90
    
    
    
MAIL_MAILER_SSL       =  0





    91
    
    
    
MAIL_HOST_SSL       =  0





    92
    
    
    
MAIL_PORT_SSL       = 465





    93
    
    
    
MAIL_MAILER       = "mail"





    94
    
    
    
MAIL_HOST       = 0





    95
    
    
    
MAIL_SMTP_AUTH       = 0





    96
    
    
    
MAIL_SMTP_USER       =  0





    97
    
    
    
MAIL_SMTP_PASS       =  0





    98
    6
    Simon
    
</code>





    99
    4
    Simon
    
</pre>





    100
    3
    Simon
    





    101
    
    
    





    102
    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).





    103
    
    
    
*Nous avons constaté que certains serveurs de mail refusaient les messages contenant ces entêtes.* 





    104
    3
    Simon
    





    105
    4
    Simon
    
_Linea21 n'est pas responsable de ce désagrément_. Choisissez un hébergement de type professionnel si vos exigences sont professionnelles.