Utilisation de la classe MailWiki

Dans vos développements, vous allez peut être avoir besoin d'envoyer des emails.

PHPBoost intègre une solution simple et complète pour l'envoi de mail et nous allons voir dans cet article son utilisation.

Vérifier qu'une adresse email est bien valide

Vous pouvez vérifier qu'une adresse email est bien valide de cette manière :

Code PHP :

AppContext::get_mail_service()->is_mail_valid('adresse email à vérifier');

La fonction renvoi true ou false selon sa validité.

Envoyer un email

Pour envoyer un email il faut dans un premier temps initialiser la classe Mail :

Code PHP :

$mail = new Mail();

Vous allez ensuite pouvoir utiliser plusieurs de ces fonctions pour pouvoir définir un contenu, l'email d’expédition, etc.

Définir l'adresse et le nom de l'expéditeur

Vous pouvez définir l'expéditeur avec la fonction set_sender :

Code PHP :

$mail->set_sender('email_expediteur');

Vous pouvez également ajouter un deuxième paramètre pour personnaliser le nom sous lequel l'expéditeur apparaîtra dans l'email.

La fonction accepte trois valeurs :

```
Mail::SENDER_ADMIN
```
: Affiche comme nom de l'expéditeur : Nom du site - Administrateur
```
Mail::SENDER_USER
```
: Affiche comme nom de l'expéditeur : Nom du site - Utilisateur
```
Du texte personnalisé
```
: Affiche comme nom de l'expéditeur : Nom du site - Votre texte

Ajouter un destinataire

Code PHP :

$mail->add_recipient('email_destinataire');

Vous pouvez ajouter le nom du destinataire éventuellement en deuxième paramètre.

--- Vider la liste des destinataires ----

Code PHP :

$mail->clear_recipients();

Définir l'objet du mail

Code PHP :

$mail->set_subject('Sujet de votre mail');

Définir le contenu

Code PHP :

$mail->set_content('Contenu du mail');

Si votre contenu est au format HTML, vous devez utiliser la fonction set_is_html :

Code PHP :

$mail->set_is_html(true);

Une fois tous les éléments définis vous pouvez envoyer le mail de cette manière :

Code PHP :

AppContext::get_mail_service()->try_to_send(Mail $mail);