{"id":406,"date":"2022-03-11T18:03:31","date_gmt":"2022-03-11T17:03:31","guid":{"rendered":"https:\/\/jagullo.fr\/blog\/?p=406"},"modified":"2023-12-08T16:22:25","modified_gmt":"2023-12-08T15:22:25","slug":"utiliser-phpmailer-avec-le-smtp-ovh","status":"publish","type":"post","link":"https:\/\/jagullo.fr\/blog\/utiliser-phpmailer-avec-le-smtp-ovh\/","title":{"rendered":"Utiliser PHPMailer avec le SMTP OVH"},"content":{"rendered":"\n

Pourquoi passer par SMTP pour envoyer un message ?<\/h2>\n\n\n\n

Utiliser le protocole SMTP pour envoyer des emails transactionnels<\/strong> dans vos projets PHP a plusieurs avantages. Le premier est de passer par une connexion s\u00e9curis\u00e9e pour l’envoi du message. En effet, la fonction mail native de PHP n’utilise pas de connexion s\u00e9curis\u00e9e donc les messages peuvent \u00eatre intercept\u00e9s sur le r\u00e9seau. Ce n’est pas bien grave quand on envoie des messages de tests lors du d\u00e9veloppement. Second avantage, si on est d\u00e9veloppeur web sur macOS il est difficile d’envoyer un message en local ainsi via la librairie PHPMailer<\/a> et une adresse mail on peut concevoir des applications PHP plus facilement.<\/p>\n\n\n\n

La librairie PHPMailer est l’une des plus utilis\u00e9es<\/strong> dans les applications PHP. Initialement cr\u00e9\u00e9e en 2001 par Brent Matzelle, cette biblioth\u00e8que s’est beaucoup d\u00e9velopp\u00e9e par la communaut\u00e9. Elle est pr\u00e9sente dans de nombreux projets open source comme WordPress, Drupal et de nombreuses autres solutions. En tant que d\u00e9veloppeur web il est difficile de ne pas utiliser cette librairie au lieu de la fonction native de PHP. Une autre solution consiste \u00e0 utiliser des emails transactionnels en passant par une API comme Sendinblue ou MailerSend. Utiliser une API pour envoyer des messages permet aussi de s\u00e9parer la partie graphique de la partie d\u00e9veloppement.<\/p>\n\n\n\n

\"PHPMailer
PHPMailer facilite l’envoi des emails transactionnels dans une application PHP<\/figcaption><\/figure>\n\n\n\n

Configurer PHPMailer pour utiliser SMTP<\/h2>\n\n\n\n

Pour cet exemple il faut une adresse mail chez OVH<\/strong> ou un autre fournisseur. Attention quelques FAI bloquent les envois par SMTP sur certains serveurs pour \u00e9viter les spams. Une fois PHPMailer int\u00e9gr\u00e9 au projet, nous reprendrons le code d’exemple de la documentation afin d’envoyer un message. Dans un premier temps on importe la librairie PHPMailer avec les classes requises pour l’envoi. Il faut aussi importer la classe Exception qui permet de lever et de r\u00e9cup\u00e9rer le message d’erreur lors de l’utilisation de la librairies. <\/p>\n\n\n\n

<?php\nuse PHPMailer\\PHPMailer\\Exception;\nuse PHPMailer\\PHPMailer\\PHPMailer;\nuse PHPMailer\\PHPMailer\\SMTP;\n\nrequire 'PHPMailer-6.6.0\/src\/Exception.php';\nrequire 'PHPMailer-6.6.0\/src\/PHPMailer.php';\nrequire 'PHPMailer-6.6.0\/src\/SMTP.php';\n\n$mail = new PHPMailer(true);<\/code><\/pre>\n\n\n\n
Ensuite on va cr\u00e9er un bout de code d’envoi avec la configuration ad\u00e9quate pour utiliser SMTP<\/strong> dans une connexion chiffr\u00e9e. Il est n\u00e9cessaire d’appeler la m\u00e9thode isSMTP afin d’initialiser PHPMailer au bon protocole puis de le configurer. Si on ne le fait pas cela appellera la fonction native mail du serveur PHP. Pour rappel chez OVH le nom du serveur est ssl0.ovh.net<\/strong>, le port 465<\/strong> et le chiffrement SSL\/TLS<\/strong>.<\/p>\n\n\n\n
\/\/ Config\n$mail->SMTPDebug = SMTP::DEBUG_SERVER;\n$mail->isSMTP();\n$mail->Host       = 'ssl0.ovh.net';\n$mail->SMTPAuth   = true;\n$mail->Username   = 'contact@jagullo.fr';\n$mail->Password   = '*******';\n$mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS;\n$mail->Port       = 465;\n\n\/\/ Header\n$mail->setFrom('contact@jagullo.fr');\n$mail->addAddress('test@test.fr');\n$mail->addReplyTo('contact@jagullo.fr');\n\n\/\/ Content\n$mail->isHTML(true);\n$mail->Subject = 'Here is an email test';\n$mail->Body    = 'This is the HTML message body <b>in bold!<\/b>';\n$mail->AltBody = 'This is the body in plain text for non-HTML mail clients';\n\ntry {\n    \/\/ Send\n    $mail->send();\n    echo 'Message has been sent';\n} catch (Exception $e) {\n    echo \"Message could not be sent. Mailer Error: {$mail->ErrorInfo}\";\n}<\/code><\/pre>\n\n\n\n
Dans la variable Username<\/strong> on indique son adresse email et dans la variable Password<\/strong> son mot de passe. Pour d\u00e9finir le bon chiffrement, il faut appeler la variable SMTPSecure<\/strong> qui n\u00e9cessite une constante de PHPMailer ENCRYPTION_SMTPS. Si on doit utiliser du STARTTLS<\/strong> on peut d\u00e9finir la constante ENCRYPTION_STARTTLS.<\/p>\n\n\n\n
R\u00e9solution des probl\u00e8mes<\/h2>\n\n\n\n
Il se peut que la connexion au serveur SMTP via SSL ne fonctionne pas en local sur certains syst\u00e8mes comme Windows. On peut se r\u00e9f\u00e9rer \u00e0 la documentation de PHPMailer<\/a> pour tenter de r\u00e9soudre quelques probl\u00e8mes. En d\u00e9veloppement il est possible de forcer une connexion non s\u00e9curis\u00e9e <\/strong>ce qui permet de r\u00e9aliser des tests avant la mise en production.<\/p>\n\n\n\n
$mail->SMTPOptions = [\n    'ssl' => [\n        'verify_peer' => false,\n        'verify_peer_name' => false,\n        'allow_self_signed' => true,\n    ]\n];<\/code><\/pre>\n\n\n\n
<\/p>\n\n\n\n
Plus de s\u00e9curit\u00e9 avec OAuth<\/h2>\n\n\n\n
On pourrait utiliser Gmail ou Microsoft comme serveur SMTP mais ces entreprises ont d\u00e9sactiv\u00e9 la prise en charge du protocole SMTP pour leur messagerie. Il est possible d’utiliser le protocole OAuth<\/strong> (Open Authorization) qui est un protocole libre pour s\u00e9curiser les authentifications \u00e0 des services et des API en se basant sur un syst\u00e8me de token. Dans sa version 6.6, PHPMailer facilite l’int\u00e9gration de OAuth pour envoyer des emails avec plus de s\u00e9curit\u00e9. Il existe de nombreuses ressources sur Internet qui traite de ce point et qui peut aussi faire l’objet d’un prochain tutoriel.<\/p>\n\n\n\n
Alternative \u00e0 PHPMailer<\/h2>\n\n\n\n
Il existe plusieurs alternatives \u00e0 cette biblioth\u00e8que dans diff\u00e9rents langages. En PHP il y a Symfony Mailer<\/strong> qui est la librairie par d\u00e9faut du framework Symfony mais qui peut \u00eatre utilis\u00e9e ind\u00e9pendamment. D’ailleurs le framework Laravel utilise lui aussi Symfony Mailer pour l’envoi de message. Sur le serveur NodeJS on retrouve Nodemailer<\/strong> qui est une librairie open source pour envoyer un mail en pur JavaScript. Il existe aussi Emailjs<\/strong> en JavaScript qui impl\u00e9mente seulement le protocole SMTP. De nombreuses solutions open source sont disponibles suivant le langage de programmation que l’on utilise et le type de serveur.<\/p>\n\n\n\n
Une autre possibilit\u00e9 d’envoyer un message, comme vu dans l’introduction, est de passer par la plateforme Sendinblue<\/strong> ou MailerSend<\/strong>. Ces services proposent d’envoyer un message en passant par une API. On r\u00e9aliser un template de mail sur la plateforme avec des variables d’entr\u00e9e puis on appelle l’API en PHP en renseignant les variables du template. Enfin on envoie l’email directement depuis le serveur ce qui permet de d\u00e9velopper tout cela en local sans aucun souci. Un service d’email transactionnel permet d’avoir une meilleure d\u00e9livrabilit\u00e9 et plus de s\u00e9curit\u00e9 pour son application. Enfin il est possible d’avoir des statistiques sur les messages d’envoi comme le taux de d\u00e9livrabilit\u00e9, les liens cliqu\u00e9s, etc.<\/p>\n\n\n\n\n