Patrón Factory

Parte de la sección Programación Orientada a Objetos del Journey de PHP de Coddy. Lección 72 de 91.

El patrón Factory es un patrón de diseño creacional que delega la creación de objetos a una clase o método independiente. En lugar de usar new directamente en todo tu código, le pides a una fábrica que cree los objetos por ti.

Este patrón es especialmente útil cuando tienes varias clases relacionadas que comparten una interfaz común y quieres decidir cuál instanciar en función de alguna condición. Considera un sistema de notificaciones que puede enviar mensajes a través de distintos canales:

<?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";
    }
}

Sin una fábrica, dispersarías instrucciones if y llamadas a new por todas partes. La fábrica centraliza esta lógica:

<?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!');

Salida:

Email: Hello!

El beneficio clave es que tu código depende de la interfaz Notification, no de clases concretas. Si más adelante añades una clase PushNotification, solo actualizas la fábrica. Todo el código que utiliza la fábrica obtiene automáticamente acceso al nuevo tipo sin modificaciones.

Desafío

Fácil

Construyamos un sistema generador de documentos utilizando el patrón Factory. Los distintos tipos de documentos (PDF, HTML, texto sin formato) comparten una interfaz común, pero producen resultados diferentes: un escenario perfecto para centralizar la creación de objetos en una fábrica.

Organizarás tu código en cuatro archivos:

Document.php: Crea una interfaz Document que define el contrato que deben seguir todos los tipos de documentos. Debe tener un único método render(string $content): string que recibe contenido y devuelve el resultado del documento con formato.
Documents.php: Incluye la interfaz Document y crea tres clases que la implementen:
- PdfDocument: Su método render() devuelve "PDF: [content]"
- HtmlDocument: Su método render() devuelve "<html>[content]</html>"
- TextDocument: Su método render() devuelve "TXT: [content]"
DocumentFactory.php: Incluye el archivo Documents y crea una clase DocumentFactory con un método estático create(string $type): Document. Este método debe usar match para devolver el objeto de documento adecuado según el tipo:
- "pdf" devuelve un nuevo PdfDocument
- "html" devuelve un nuevo HtmlDocument
- "text" devuelve un nuevo TextDocument
- Cualquier otro tipo debe lanzar una InvalidArgumentException con el mensaje "Unknown document type: [type]"
main.php: Incluye el archivo DocumentFactory. Recibirás dos entradas: un tipo de documento y el contenido que se va a renderizar.
Usa la fábrica para crear el tipo de documento adecuado, después llama a su método render() con el contenido e imprime el resultado.

En una línea nueva, imprime "Factory benefit: Adding new types only requires updating the factory" para destacar por qué este patrón es valioso.

El patrón Factory mantiene tu código flexible; cuando necesites añadir posteriormente un MarkdownDocument, solo tendrás que actualizar la fábrica, mientras que todo el código existente seguirá funcionando sin cambios.

Pruébalo tú mismo

<?php
require_once 'DocumentFactory.php';

// Leer la entrada
$type = trim(fgets(STDIN));
$content = trim(fgets(STDIN));

// TODO: Usa DocumentFactory para crear el tipo de documento apropiado
// TODO: Llama al método render() con el contenido e imprime el resultado
// TODO: On a new line, print "Factory benefit: Adding new types only requires updating the factory"

?>