Le Modèle de conception d'adaptateur est un modèle structurel qui permet aux objets dotés d'interfaces incompatibles de fonctionner ensemble. Il agit comme un intermédiaire (ou un adaptateur) entre deux objets, convertissant l'interface d'un objet en l'interface attendue par l'autre. Cela permet à des classes qui seraient autrement incompatibles car elles ont des interfaces différentes de coopérer sans modification de leur code d'origine.

Structure de l'adaptateur

Le modèle Adaptateur est généralement composé de trois éléments principaux :

• Client : la classe qui s'attend à travailler avec des objets d'une interface spécifique.
• Adaptee : La classe qui possède une interface incompatible avec le client, mais dont les fonctionnalités sont nécessaires.
• Adaptateur : classe qui implémente l'interface attendue par le client et convertit les appels vers l'interface Adaptee.

Types d'adaptateurs

1. Adaptateur d'objet : basé sur la composition. L'adaptateur contient une instance de la classe qu'il adapte.
2. Adaptateur de classe : basé sur l'héritage (généralement dans les langages prenant en charge l'héritage multiple).

Quand utiliser l'adaptateur ?

• Lorsque vous souhaitez utiliser une classe existante, mais que son interface ne correspond pas à ce qu'attend le client.
• Pour intégrer de nouvelles fonctionnalités dans un système existant, sans avoir à modifier l'ancien code.

Ce modèle est utile dans les systèmes qui doivent fonctionner avec des bibliothèques ou des API externes, vous permettant d'adapter leurs fonctionnalités sans modifier le code de ces bibliothèques.

Exemple utilisant PHPMailer

Voici un exemple d'utilisation du modèle de conception d'adaptateur pour intégrer PHPMailer à une interface personnalisée.

Situation:

Supposons que votre système s'attend à ce que toute classe d'envoi d'e-mails implémente une interface appelée IMailer, mais que PHPMailer ne suit pas directement cette interface. L'Adaptateur servira à adapter PHPMailer à l'interface attendue par le système.

Installer PHPMailer via Composer

composer require phpmailer/phpmailer

Système d'annuaire

?Adapter
 ┣ ?src
 ┃ ┣ ?Interfaces
 ┃ ┃ ┗ ?IMailer.php
 ┃ ┣ ?Adapters
 ┃ ┃ ┗ ?PHPMailerAdapter.php
 ┃ ┗ ?Services
 ┃   ┗ ?ServicoDeEmail.php
 ┣ ?vendor
 ┣ ?composer.json
 ┗ ?index.php

Chargement automatique

Dans le fichier composer.json (situé à la racine du projet), ajoutez l'espace de noms App pour charger automatiquement les classes :

{
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    },
    "require": {
        "phpmailer/phpmailer": "^6.5"
    }
}

Interface IMailer

namespace App\Interfaces;

interface IMailer {
    public function send($to, $subject, $message);
}

Classe PHPMailerAdapter

namespace App\Adapters;

use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;
use App\Interfaces\IMailer;

class PHPMailerAdapter implements IMailer {
    private $phpMailer;

    public function __construct() {
        $this->phpMailer = new PHPMailer(true);

        // Basic PHPMailer configuration
        $this->phpMailer->isSMTP();
        $this->phpMailer->Host = 'smtp.example.com';
        $this->phpMailer->SMTPAuth = true;
        $this->phpMailer->Username = '[email protected]';
        $this->phpMailer->Password = 'password';
        $this->phpMailer->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
        $this->phpMailer->Port = 587;
        $this->phpMailer->setFrom('[email protected]', 'Your Name');
    }
}

• Méthode d'envoi

public function send($to, $subject, $message) {
    try {
        $this->phpMailer->addAddress($to);
        $this->phpMailer->Subject = $subject;
        $this->phpMailer->Body = $message;
        $this->phpMailer->send();
        echo 'Email sent successfully!';
    } catch (Exception $e) {
        echo "Failed to send email: {$this->phpMailer->ErrorInfo}";
    }
}

Service de messagerie de classe

namespace App\Services;

use App\Interfaces\IMailer;

class EmailService {
    private $mailer;

    public function __construct(IMailer $mailer) {
        $this->mailer = $mailer;
    }
}

• Méthode sendEmailToClient

public function sendEmailToClient($to, $subject, $message) {
    $this->mailer->send($to, $subject, $message);
}

Fichier index.php

require 'vendor/autoload.php';

use App\Adapters\PHPMailerAdapter;
use App\Services\EmailService;

// Creating the PHPMailer Adapter
$mailer = new PHPMailerAdapter();

// Using the email service with the IMailer interface
$emailService = new EmailService($mailer);

// Sending an email
$emailService->sendEmailToClient('[email protected]', 'Email Subject', 'Message content.');

Explication de la structure

• IMailer.php : définit l'interface IMailer que tout système de messagerie doit implémenter.
• PHPMailerAdapter.php : adapte PHPMailer à l'interface IMailer.
• EmailService.php : service de messagerie qui utilise l'interface IMailer pour envoyer des e-mails.
• index.php : fichier principal qui utilise le service de messagerie pour envoyer un message.