Modèle de conception PHP : adaptateur

Le Modèle de conception d'adaptateur est un modèle structurel qui permet à des objets avec des 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 pattern 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.
• Adapté : La classe qui a une interface incompatible avec le client, mais dont les fonctionnalités sont nécessaires.
• Adaptateur : La 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 changer 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 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 = 'your-email@example.com';
        $this->phpMailer->Password = 'password';
        $this->phpMailer->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
        $this->phpMailer->Port = 587;
        $this->phpMailer->setFrom('your-email@example.com', '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

composer require phpmailer/phpmailer

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.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!