PHPMailer | Création et transfert d'e-mail pour vos formulaires PHP

 

* Définition et Origine

        PHPMailer est une bibliothèque de code pour transporter des emails en toute sécurité et facilement via du code PHP depuis un serveur web. Initialement écrit en 2001 par Brent R. Matzelle en tant que projet SourceForge. L’utilisation de la fonction PHP  mail() fait appel au programme Sendmail, généralement configuré par l’administrateur système, qui permet d’envoyer des emails. 

    La fonction PHPmail()envoie généralement via un serveur de messagerie local, généralement dirigé par un sendmail binaire sur les plates-formes Linux, BSD et macOS, cependant, Windows n'inclut généralement pas de serveur de messagerie local ; Le client SMTP intégré de PHPMailer permet l'envoi d'e-mails sur toutes les plates-formes sans avoir besoin d'un serveur de messagerie local. Sachez cependant que la mail()fonction doit être évitée dans la mesure du possible ; il est à la fois plus rapide et plus sûr d'utiliser SMTP vers localhost.

    Il existe d'autres bibliothèques de code d'envoi d'emails. Il s'agit entre autres de SwiftMailer, Laminas-Mail, Zzetacomponents/Mail, ect...

* Caractéristiques

• Probablement le code le plus populaire au monde pour envoyer des e-mails depuis PHP !
• Utilisé par de nombreux projets open source : WordPress, Drupal, 1CRM, SugarCRM, Yii, Joomla ! et beaucoup plus
• Prise en charge SMTP intégrée - envoi sans serveur de messagerie local
• Envoyez des e-mails avec plusieurs adresses À, CC, CCI et Répondre à
• E-mails en plusieurs parties/alternatifs pour les clients de messagerie qui ne lisent pas les e-mails HTML
• Ajouter des pièces jointes, y compris en ligne
• Prise en charge du contenu UTF-8 et des encodages 8 bits, base64, binaires et imprimables entre guillemets
• Authentification SMTP avec les mécanismes LOGIN, PLAIN, CRAM-MD5 et XOAUTH2 sur les transports SMTPS et SMTP+STARTTLS
• Valide automatiquement les adresses e-mail
• Protège contre les attaques par injection d'en-tête
• Messages d'erreur dans plus de 50 langues !
• Prise en charge de la signature DKIM et S/MIME
• Compatible avec PHP 5.5 et versions ultérieures, y compris PHP 8.1
• ...

* Installations

    ** Partie 1

    

    La méthode recommandée pour utiliser PHPMailer est d'ajouter ce bout de code dans votre fichier composer.json :

"phpmailer/phpmailer": "^6.5"

Vous pouvez aussi installer les composants de PHPMailer avec l'utilisation de NPM et NodeJS :

composer require phpmailer/phpmailer

Voulez-vous en savoir plus sur composer ? Lisez la Documentation.

Dans le dossier vendor , le fichier script vendor/autoload.php est automatiquement généré par Composer et ne fait pas partir PHPMailer.

Si vous souhaitez utiliser la classe d'authentification Gmail XOAUTH2, vous devrez également ajouter une dépendance au league/oauth2-client package dans votre fichier composer.json. Vous pouvez télécharger PHPMailer sous forme de fichier zip | ou le cloner, puis copiez le contenu du dossier PHPMailer dans l'un des répertoires spécifiés dans votre Configuration PHP et chargez chaque fichier de classe manuellement :

<?php

use PHPMailer\PHPMailer\PHPMailer;

use PHPMailer\PHPMailer\Exception;

require 'path/to/PHPMailer/src/Exception.php';

require 'path/to/PHPMailer/src/PHPMailer.php';

require 'path/to/PHPMailer/src/SMTP.php';

Même si vous n'utilisez pas la classe `SMTP`, vous devez toujours charger la classe

`Exception` car elle est utilisée en interne.

        ** Partie 2

    Bien que l'utilisation de l'ensemble du package manuellement ou avec 'Composer' soit simple, pratique et fiable, il est possible que vous souhaitiez inclure que les fichiers dont vous avez besoins pour votre projet. Au minimum, vous aurez de besoin de src/PHPMailer.php.

• Si vous utilisez SMTP, vous aurez besoin de src/SMTP.php ;
• Si vous utilisez POP avant SMTP ( très peu probable !), vous aurez besoin de src/POP3.php ;
• Si vous avez utilisez XOAUTH2, vous aurez besoin de src/OAuth.php ainsi que des dépendances 'Composer' pour les services avec lesquels vous souhaitez vous authentifier. Il est beaucoup plus simple d'utiliser 'Composer'. Je vous le conseil vivement !

 ** Exemple de code que vous pouvez utiliser

<?php

//Importer les classes PHPMailer dans l'espace de noms global

//Celles-ci doivent être en haut de votre script, pas à l'intérieur d'une fonction

use PHPMailer\PHPMailer\PHPMailer;

use PHPMailer\PHPMailer\SMTP;

use PHPMailer\PHPMailer\Exception;

//Le chargeur automatique de Load Composer

require 'vendor/autoload.php';

//Créer une instance ; passer `true` active les exceptions

$mail = new PHPMailer(true);

try {

    //Paramètres du serveur

    $mail->SMTPDebug = SMTP::DEBUG_SERVER;                      // Activer la sortie de débogage détaillée

    $mail->isSMTP();                                            // Envoi via SMTP

    $mail->Host       = 'smtp.example.com';                     //Définir le serveur SMTP pour envoyer via

    $mail->SMTPAuth   = true;                                   //Activer l'authentification SMTP

    $mail->Username   = 'user@example.com';                     //nom d'utilisateur SMTP

    $mail->Password   = 'secret';                               // Mot de passe SMTP

    $mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS;            //Activer le chiffrement TLS implicite

    $mail->Port       = 465;                                    //Port TCP auquel se connecter ;

utilisez 587 si vous avez défini `SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS`

    //Destinataires

    $mail->setFrom('from@example.com', 'Mailer');

    $mail->addAddress('louis@example.net', 'Louis Japheth Kouassi');     //Ajouter un destinataire

    $mail->addAddress('japheth@example.com');               //Le nom est facultatif

    $mail->addReplyTo('info@example.com', 'Information');

    $mail->addCC('cc@example.com');

    $mail->addBCC('bcc@example.com');

     //Pièces jointes

    $mail->addAttachment('/var/tmp/file.tar.gz');         //Ajouter des pièces jointes

    $mail->addAttachment('/tmp/image.jpg', 'new.jpg');    //Le nom est facultatif

    //Contenu

    $mail->isHTML(true);                                  // Définissez le format de l'e-mail sur HTML

    $mail->Subject = 'Sujet';

    $mail->Body    = 'Ceci est le corps du message HTML <b>en gras !</b>';

    $mail->AltBody = 'Ceci est le corps en texte brut pour les clients de messagerie non-HTML';

    $mail->send();

    echo 'Votre message a bien été envoyé';

} catch (Exception $e) {

    echo "Votre message n'a pas pu être envoyé. Erreur Mailer : {$mail->ErrorInfo}";

}

PHPMailer est par défaut en anglais, mais dans le dossier de langue , vous trouverez de nombreuses traductions pour les messages d'erreur PHPMailer que vous pourriez rencontrer. Pour spécifier une langue, vous devez indiquer à PHPMailer laquelle utiliser, comme ceci :

$mail->setLanguage('fr', '/optional/path/to/language/directory/');

Grosso modo, voici comment vous pouvez utilisez PHPMailer pour envoyer des mails ou utiliser dans vos fromulaires de contacts. A vous de jouer 😉 !

Mon GitHub !