Patron Factory

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

Le Factory Pattern est un patron de conception créationnel qui délègue la création d’objets à une classe ou une méthode distincte. Au lieu d’utiliser directement new dans tout votre code, vous demandez à une fabrique de créer les objets pour vous.

Ce modèle est particulièrement utile lorsque vous avez plusieurs classes associées qui partagent une interface commune et que vous souhaitez décider laquelle instancier en fonction d’une condition. Prenons l’exemple d’un système de notifications capable d’envoyer des messages via différents canaux :

<?php
interface Notification {
    public function send(string $message): string;
}

class EmailNotification implements Notification {
    public function send(string $message): string {
        return "Email: $message";
    }
}

class SmsNotification implements Notification {
    public function send(string $message): string {
        return "SMS: $message";
    }
}

Sans fabrique, tu éparpillerais des instructions if et des appels à new partout. La fabrique centralise cette logique :

<?php
class NotificationFactory {
    public static function create(string $type): Notification {
        return match($type) {
            'email' => new EmailNotification(),
            'sms' => new SmsNotification(),
            default => throw new InvalidArgumentException("Unknown type: $type")
        };
    }
}

$notification = NotificationFactory::create('email');
echo $notification->send('Hello!');

Sortie :

Email: Hello!

Le principal avantage est que votre code dépend de l’interface Notification, et non de classes concrètes. Si vous ajoutez ultérieurement une classe PushNotification, il vous suffit de mettre à jour la fabrique. Tout le code utilisant la fabrique accède automatiquement au nouveau type sans modification.

Défi

Facile

Construisons un système de génération de documents à l’aide du pattern Factory. Différents types de documents (PDF, HTML, texte brut) partagent une interface commune, mais produisent des sorties différentes : un scénario idéal pour centraliser la création des objets dans une factory.

Vous organiserez votre code sur quatre fichiers :

Document.php : créez une interface Document qui définit le contrat que tous les types de documents doivent respecter. Elle doit comporter une seule méthode render(string $content): string qui prend le contenu et renvoie le document mis en forme.
Documents.php : incluez l’interface Document et créez trois classes qui l’implémentent :
- PdfDocument : sa méthode render() renvoie "PDF: [content]"
- HtmlDocument : sa méthode render() renvoie "<html>[content]</html>"
- TextDocument : sa méthode render() renvoie "TXT: [content]"
DocumentFactory.php : incluez le fichier Documents et créez une classe DocumentFactory avec une méthode statique create(string $type): Document. Cette méthode doit utiliser match pour renvoyer l’objet document approprié selon le type :
- "pdf" renvoie un nouveau PdfDocument
- "html" renvoie un nouveau HtmlDocument
- "text" renvoie un nouveau TextDocument
- Tout autre type doit lever une InvalidArgumentException avec le message "Unknown document type: [type]"
main.php : incluez le fichier DocumentFactory. Vous recevrez deux entrées : un type de document et le contenu à afficher.
Utilisez la factory pour créer le type de document approprié, puis appelez sa méthode render() avec le contenu et affichez le résultat.

Sur une nouvelle ligne, affichez "Factory benefit: Adding new types only requires updating the factory" pour mettre en évidence la raison pour laquelle ce pattern est utile.

Le pattern Factory permet de conserver la flexibilité de votre code. Lorsque vous aurez besoin d’ajouter ultérieurement un MarkdownDocument, vous ne mettrez à jour que la factory, tandis que tout le code existant continuera de fonctionner sans modification.

Essayez vous-même

<?php
require_once 'DocumentFactory.php';

// Lire l'entrée
$type = trim(fgets(STDIN));
$content = trim(fgets(STDIN));

// TODO: Utiliser DocumentFactory pour créer le type de document approprié
// TODO: Appeler la méthode render() avec le contenu et afficher le résultat
// TODO: On a new line, print "Factory benefit: Adding new types only requires updating the factory"

?>