Patron Adaptateur

Fait partie de la section Programmation Orientée Objet du Journey PHP de Coddy. Leçon 76 sur 91.

Le pattern Adaptateur est un patron de conception structurel qui permet à des objets dotés d’interfaces incompatibles de fonctionner ensemble. Il agit comme un pont entre deux interfaces, en traduisant les appels d’un format à un autre.

Imaginez que vous construisiez une application qui traite des paiements et que vous deviez intégrer une bibliothèque de paiement tierce. La bibliothèque fonctionne parfaitement, mais son interface ne correspond pas à ce que votre code attend. Au lieu de réécrire toute votre application, vous créez un adaptateur qui assure la traduction entre les deux.

<?php
// L'interface que votre application attend
interface PaymentProcessor {
    public function pay(float $amount): string;
}

// Bibliothèque tierce avec une interface différente
class StripeAPI {
    public function createCharge(int $cents, string $currency): string {
        return "Charged {$cents} {$currency} via Stripe";
    }
}

L’adaptateur implémente l’interface attendue tout en utilisant en interne la classe tierce :

<?php
class StripeAdapter implements PaymentProcessor {
    public function __construct(private StripeAPI $stripe) {}
    
    public function pay(float $amount): string {
        $cents = (int)($amount * 100);
        return $this->stripe->createCharge($cents, 'USD');
    }
}

$stripe = new StripeAPI();
$processor = new StripeAdapter($stripe);
echo $processor->pay(29.99);

Sortie :

Charged 2999 USD via Stripe

L’adaptateur convertit les dollars en centimes et appelle la méthode appropriée. Le code de votre application ne connaît que PaymentProcessor, sans avoir à se préoccuper des exigences spécifiques de Stripe. Si vous passez plus tard à un autre prestataire de paiement, il vous suffit de créer un nouvel adaptateur sans modifier votre code existant.

Défi

Facile

Construisons un système de conversion de température à l’aide du modèle Adaptateur. Vous disposez d’un capteur de température obsolète qui fournit des relevés en Fahrenheit, tandis que votre application météo moderne attend toutes les températures en Celsius. Au lieu de modifier l’un ou l’autre système, vous allez créer un adaptateur qui fera le lien.

Vous allez organiser votre code dans quatre fichiers :

TemperatureSensor.php : Définissez une interface TemperatureSensor que votre application météo attend. Elle doit posséder une méthode getTemperature(): float qui renvoie la température en Celsius.
LegacySensor.php : Créez une classe LegacySensor qui simule l’ancien matériel. Cette classe possède une interface différente de celle dont votre application a besoin :
- Elle reçoit un relevé Fahrenheit dans son constructeur (utilisez la promotion du constructeur)
- Elle possède une méthode readFahrenheit(): float qui renvoie la valeur Fahrenheit stockée
LegacySensorAdapter.php : Incluez à la fois l’interface TemperatureSensor et la classe LegacySensor. Créez une classe LegacySensorAdapter qui implémente TemperatureSensor et encapsule un LegacySensor. Votre adaptateur doit :
- Accepter un LegacySensor dans son constructeur
- Implémenter getTemperature() en lisant la valeur Fahrenheit depuis le capteur obsolète et en la convertissant en Celsius à l’aide de la formule : (fahrenheit - 32) * 5 / 9
main.php : Incluez le fichier LegacySensorAdapter. Vous recevrez une entrée : une température en Fahrenheit.
Créez un LegacySensor avec la température saisie, puis encapsulez-le dans un LegacySensorAdapter. Appelez getTemperature() sur l’adaptateur et affichez le résultat arrondi à deux décimales.

Le format de sortie doit être : Temperature: [celsius]C

Ce défi montre comment le modèle Adaptateur vous permet d’intégrer des interfaces incompatibles sans modifier le code existant. Votre application météo fonctionne exclusivement avec l’interface TemperatureSensor, sans savoir que les relevés réels proviennent d’un capteur Fahrenheit obsolète.

Essayez vous-même

<?php
require_once 'LegacySensorAdapter.php';

// Lire l'entrée
$fahrenheit = floatval(trim(fgets(STDIN)));

// TODO: Créer un LegacySensor avec la température d'entrée
// TODO: L'envelopper dans un LegacySensorAdapter
// TODO: Appeler getTemperature() sur l'adaptateur
// TODO: Afficher le résultat arrondi à deux décimales
// Format de sortie : Temperature: [celsius]C

?>