Фабричный метод

<?php
/**
* Класс Создатель объявляет фабричный метод, который должен возвращать
* объект класса Продукт. Подклассы Создателя обычно предоставляют
* реализацию этого метода.
*/
abstract class Creator
{
    /**
    * Обратите внимание, что Создатель может также обеспечить
    * реализацию фабричного метода по умолчанию.
    */
    abstract public function factoryMethod(): Product;

    /**
    * Также заметьте, что, несмотря на название, основная обязанность Создателя
    * не заключается в создании продуктов. Обычно он содержит некоторую базовую
    * бизнес-логику, которая основана на объектах Продуктов, возвращаемых
    * фабричным методом. Подклассы могут косвенно изменять эту бизнес-логику,
    * переопределяя фабричный метод и возвращая из него другой тип продукта.
    */

    public function someOperation(): string
    {
        // Вызываем фабричный метод, чтобы получить объект-продукт.
        $product = $this->factoryMethod();
        // Далее, работаем с этим продуктом.
        $result = "Creator: The same creator's code has just worked with " .
        $product->operation();
        return $result;
    }
}

/**
* Конкретные Создатели переопределяют фабричный метод для того, чтобы изменить
* тип результирующего продукта.
*/
class ConcreteCreator1 extends Creator
{
    /**
    * Обратите внимание, что сигнатура метода по-прежнему использует тип
    * абстрактного продукта, хотя фактически из метода возвращается конкретный
    * продукт. Таким образом, Создатель может оставаться независимым от
    * конкретных классов продуктов.
    */
    public function factoryMethod(): Product
    {
        return new ConcreteProduct1();
    }
}

class ConcreteCreator2 extends Creator
{
    public function factoryMethod(): Product
    {
        return new ConcreteProduct2();
    }
}

/**
* Интерфейс Продукта объявляет операции, которые должны выполнять все
* конкретные продукты.
*/
interface Product
{
    public function operation(): string;
}

/**
* Конкретные Продукты предоставляют различные реализации интерфейса Продукта.
*/
class ConcreteProduct1 implements Product
{
    public function operation(): string
    {
        return "{Result of the ConcreteProduct1}";
    }
}

class ConcreteProduct2 implements Product
{
    public function operation(): string
    {
        return "{Result of the ConcreteProduct2}";
    }
}

/**
* Клиентский код работает с экземпляром конкретного создателя, хотя и через его
* базовый интерфейс. Пока клиент продолжает работать с создателем через базовый
* интерфейс, вы можете передать ему любой подкласс создателя.
*/
function clientCode(Creator $creator)
{
    // ...
    echo "Client: I'm not aware of the creator's class, but it still works.\n"
    . $creator->someOperation();
    // ...
}

/**
* Приложение выбирает тип создателя в зависимости от конфигурации или среды.
*/
echo "App: Launched with the ConcreteCreator1.\n";
clientCode(new ConcreteCreator1());
echo "\n\n";
echo "App: Launched with the ConcreteCreator2.\n";
clientCode(new ConcreteCreator2());

<?php
/**
* Создатель объявляет фабричный метод, который может быть использован вместо
* прямых вызовов конструктора продуктов, например:
*
* - До: $p = new FacebookConnector();
* - После: $p = $this->getSocialNetwork;
*
* Это позволяет подклассам SocialNetworkPoster изменять тип создаваемого
* продукта.
*/

abstract class SocialNetworkPoster
{
    /**
    * Фактический фабричный метод. Обратите внимание, что он возвращает
    * абстрактный коннектор. Это позволяет подклассам возвращать любые
    * конкретные коннекторы без нарушения контракта суперкласса.
    */

    abstract public function getSocialNetwork(): SocialNetworkConnector;

    /**
    * Когда фабричный метод используется внутри бизнес-логики Создателя,
    * подклассы могут изменять логику косвенно, возвращая из фабричного метода
    * различные типы коннекторов.
    */
    public function post($content): void
    {
        // Вызываем фабричный метод для создания объекта Продукта...
        $network = $this->getSocialNetwork();
        // ...а затем используем его по своему усмотрению.
        $network->logIn();
        $network->createPost($content);
        $network->logout();
    }
}

/**
* Этот Конкретный Создатель поддерживает Facebook. Помните, что этот класс
* также наследует метод post от родительского класса. Конкретные Создатели —
* это классы, которые фактически использует Клиент.
*/

class FacebookPoster extends SocialNetworkPoster
{
    private $login, $password;

    public function __construct(string $login, string $password)
    {
        $this->login = $login;
        $this->password = $password;
    }

    public function getSocialNetwork(): SocialNetworkConnector
    {
        return new FacebookConnector($this->login, $this->password);
    }
}

/**
* Этот Конкретный Создатель поддерживает LinkedIn.
*/

class LinkedInPoster extends SocialNetworkPoster
{
    private $email, $password;

    public function __construct(string $email, string $password)
    {
        $this->email = $email;
        $this->password = $password;
    }

    public function getSocialNetwork(): SocialNetworkConnector
    {
        return new LinkedInConnector($this->email, $this->password);
    }
}

/**
* Интерфейс Продукта объявляет поведения различных типов продуктов.
*/
interface SocialNetworkConnector
{
    public function logIn(): void;

    public function logOut(): void;

    public function createPost($content): void;
}

/**
* Этот Конкретный Продукт реализует API Facebook.
*/
class FacebookConnector implements SocialNetworkConnector
{
    private $login, $password;

    public function __construct(string $login, string $password)
    {
        $this->login = $login;
        $this->password = $password;
    }

    public function logIn(): void
    {
        echo "Send HTTP API request to log in user $this->login with " .
        "password $this->password\n";
    }

    public function logOut(): void
    {
        echo "Send HTTP API request to log out user $this->login\n";
    }

    public function createPost($content): void
    {
        echo "Send HTTP API requests to create a post in Facebook timeline.\n";
    }
}

/**
* А этот Конкретный Продукт реализует API LinkedIn.
*/
class LinkedInConnector implements SocialNetworkConnector
{
    private $email, $password;

    public function __construct(string $email, string $password)
    {
        $this->email = $email;
        $this->password = $password;
    }

    public function logIn(): void
    {
        echo "Send HTTP API request to log in user $this->email with " .
        "password $this->password\n";
    }

    public function logOut(): void
    {
        echo "Send HTTP API request to log out user $this->email\n";
    }

    public function createPost($content): void
    {
        echo "Send HTTP API requests to create a post in LinkedIn timeline.\n";
    }
}

/**
* Клиентский код может работать с любым подклассом SocialNetworkPoster, так как
* он не зависит от конкретных классов.
*/

function clientCode(SocialNetworkPoster $creator)
{
    // ...
    $creator->post("Hello world!");
    $creator->post("I had a large hamburger this morning!");
    // ...
}

/**
* На этапе инициализации приложение может выбрать, с какой социальной сетью оно
* хочет работать, создать объект соответствующего подкласса и передать его
* клиентскому коду.
*/

echo "Testing ConcreteCreator1:\n";
clientCode(new FacebookPoster("john_smith", "******"));
echo "\n\n";

echo "Testing ConcreteCreator2:\n";
clientCode(new LinkedInPoster("john_smith@example.com", "******"));

<?php
// Без паттерна — создание объектов через if/else
class EmailNotification {
    public function __construct(private string $address) {}

    public function send(string $message): void {
        echo "Email → {$this->address}: {$message}\n";
    }
}

class SmsNotification {
    public function __construct(private string $phone) {}

    public function send(string $message): void {
        echo "SMS → {$this->phone}: {$message}\n";
    }
}

class PushNotification {
    public function __construct(private string $deviceToken) {}

    public function send(string $message): void {
        echo "Push → {$this->deviceToken}: {$message}\n";
    }
}

function notify(string $channel, string $target, string $message): void {
    if ($channel === 'email') {
        $n = new EmailNotification($target);
    } elseif ($channel === 'sms') {
        $n = new SmsNotification($target);
    } elseif ($channel === 'push') {
        $n = new PushNotification($target);
    } else {
        throw new InvalidArgumentException("Неизвестный канал: $channel");
    }
    $n->send($message);
}

notify('email', 'user@example.com', 'Ваш заказ подтверждён');
notify('sms', '+79001234567', 'Код подтверждения: 1234');

<?php
// Без паттерна
class PdfReport {
    public function generate(array $data): string {
        return "[PDF] Отчёт: " . json_encode($data);
    }
}

class ExcelReport {
    public function generate(array $data): string {
        return "[Excel] Отчёт: " . json_encode($data);
    }
}

class CsvReport {
    public function generate(array $data): string {
        return "[CSV] Отчёт: " . json_encode($data);
    }
}

class ReportManager {
    public function __construct(private string $format) {}

    public function export(array $data): string {
        if ($this->format === 'pdf') {
            $generator = new PdfReport();
        } elseif ($this->format === 'excel') {
            $generator = new ExcelReport();
        } elseif ($this->format === 'csv') {
            $generator = new CsvReport();
        } else {
            throw new InvalidArgumentException("Неизвестный формат: {$this->format}");
        }
        return $generator->generate($data);
    }
}

$manager = new ReportManager('pdf');
echo $manager->export(['title' => 'Продажи Q1', 'total' => 150000]);

<?php
// Интерфейс парсера
interface Parser {
    public function parse(string $raw): array;
}

class JsonParser implements Parser {
    public function parse(string $raw): array {
        return json_decode($raw, true);
    }
}

class CsvParser implements Parser {
    public function parse(string $raw): array {
        $lines = explode("\n", trim($raw));
        $headers = str_getcsv(array_shift($lines));
        return array_map(fn($l) => array_combine($headers, str_getcsv($l)), $lines);
    }
}

class XmlParser implements Parser {
    public function parse(string $raw): array {
        $xml = simplexml_load_string($raw);
        return json_decode(json_encode($xml), true);
    }
}

// TODO: реализовать абстрактный DataImporter с фабричным методом createParser()
// и конкретные подклассы JsonImporter, CsvImporter, XmlImporter

<?php
// Интерфейс продукта
interface DatabaseConnection {
    public function connect(): void;
    public function query(string $sql): array;
    public function disconnect(): void;
}

// TODO: реализовать конкретные подключения:
// MySQLConnection, PostgreSQLConnection, SQLiteConnection

// TODO: реализовать абстрактный DatabaseFactory с фабричным методом
// createConnection() и конкретные фабрики для каждой СУБД

// Клиентский код (не должен меняться при добавлении новой СУБД)
function runReport(DatabaseFactory $factory): array {
    $conn = $factory->createConnection();
    $conn->connect();
    $results = $conn->query("SELECT * FROM orders WHERE status = 'new'");
    $conn->disconnect();
    return $results;
}

<?php
// Без паттерна
class StripeGateway {
    public function pay(float $amount, string $currency): string {
        return "Stripe: списано {$amount} {$currency}";
    }

    public function refund(string $transactionId): string {
        return "Stripe: возврат по транзакции {$transactionId}";
    }
}

class PayPalGateway {
    public function pay(float $amount, string $currency): string {
        return "PayPal: списано {$amount} {$currency}";
    }

    public function refund(string $transactionId): string {
        return "PayPal: возврат по транзакции {$transactionId}";
    }
}

class YookassaGateway {
    public function pay(float $amount, string $currency): string {
        return "ЮKassa: списано {$amount} {$currency}";
    }

    public function refund(string $transactionId): string {
        return "ЮKassa: возврат по транзакции {$transactionId}";
    }
}

class Shop {
    public function __construct(private string $paymentSystem) {}

    public function checkout(float $amount, string $currency = 'RUB'): string {
        if ($this->paymentSystem === 'stripe') {
            $gateway = new StripeGateway();
        } elseif ($this->paymentSystem === 'paypal') {
            $gateway = new PayPalGateway();
        } elseif ($this->paymentSystem === 'yookassa') {
            $gateway = new YookassaGateway();
        } else {
            throw new InvalidArgumentException("Неизвестная система: {$this->paymentSystem}");
        }
        return $gateway->pay($amount, $currency);
    }
}

$shop = new Shop('stripe');
echo $shop->checkout(4990.0) . "\n";