Расширенные примеры с интерфейсами

Пример 1. Разделение по функциональности: несколько реализаций одного интерфейса

Интерфейс PaymentInterface и две реализации - CreditCardPayment и PayPalPayment. Каждая реализация находится в отдельном файле.

// src/Contracts/PaymentInterface.php
<?php

namespace App\Contracts;

interface PaymentInterface
{
    public function process(float $amount): bool;
    public function refund(string $transactionId): bool;
}

// src/Services/CreditCardPayment.php
<?php

namespace App\Services;

use App\Contracts\PaymentInterface;

class CreditCardPayment implements PaymentInterface
{
    public function process(float $amount): bool
    {
        // имитация списания с карты
        return true;
    }

    public function refund(string $transactionId): bool
    {
        // имитация возврата
        return true;
    }
}

// src/Services/PayPalPayment.php
<?php

namespace App\Services;

use App\Contracts\PaymentInterface;

class PayPalPayment implements PaymentInterface
{
    public function process(float $amount): bool
    {
        // вызов PayPal API
        return true;
    }

    public function refund(string $transactionId): bool
    {
        // вызов PayPal API
        return true;
    }
}

Результат: код, работающий с PaymentInterface, не зависит от конкретной реализации. Это облегчает переключение между платёжными провайдерами.

Пример 2. Интерфейсы и Dependency Injection (DI)

Сервис заказов получает логгер через конструктор, используя тип LoggerInterface. Файлы:

// src/Contracts/LoggerInterface.php (уже описан ранее)

// src/Services/OrderService.php
<?php

namespace App\Services;

use App\Contracts\LoggerInterface;

class OrderService
{
    private LoggerInterface $logger;

    public function __construct(LoggerInterface $logger)
    {
        $this->logger = $logger;
    }

    public function createOrder(array $data): void
    {
        // ... логика
        $this->logger->log('Order created', ['data' => $data]);
    }
}

// index.php (входная точка)
<?php

require_once 'vendor/autoload.php';

use App\Services\OrderService;
use App\Services\FileLogger;

$logger = new FileLogger();
$orderService = new OrderService($logger);
$orderService->createOrder(['product' => 'book', 'price' => 15.99]);

Результат: логгер можно легко заменить на другой (например, DatabaseLogger), не меняя код OrderService.

Пример 3. Комбинация интерфейсов и трейтов

Если несколько реализаций одного интерфейса имеют одинаковую логику, её можно вынести в трейт. Пример:

// src/Contracts/NotifiableInterface.php
<?php

namespace App\Contracts;

interface NotifiableInterface
{
    public function notify(string $message): void;
}

// src/Traits/ConsoleNotifyTrait.php
<?php

namespace App\Traits;

trait ConsoleNotifyTrait
{
    public function notify(string $message): void
    {
        echo "[NOTIFY] $message" . PHP_EOL;
    }
}

// src/Services/UserNotifier.php
<?php

namespace App\Services;

use App\Contracts\NotifiableInterface;
use App\Traits\ConsoleNotifyTrait;

class UserNotifier implements NotifiableInterface
{
    use ConsoleNotifyTrait;

    // дополнительная логика
}

// src/Services/AdminNotifier.php
<?php

namespace App\Services;

use App\Contracts\NotifiableInterface;
use App\Traits\ConsoleNotifyTrait;

class AdminNotifier implements NotifiableInterface
{
    use ConsoleNotifyTrait;

    public function notify(string $message): void
    {
        parent::notify("[ADMIN] $message"); // вызов трейта
    }
}

Результат: трейт предоставляет реализацию по умолчанию, но при необходимости её можно переопределить.

Пример 4. Автозагрузка без Composer с собственным неймспейсом

Создаётся автозагрузчик для всех классов проекта. Файловая структура:

project/
  lib/
    App/
      Contracts/
        RendererInterface.php
      Services/
        HtmlRenderer.php
  autoload.php
  index.php

// autoload.php
<?php

spl_autoload_register(function ($class) {
    $root = __DIR__ . '/lib';
    $file = $root . '/' . str_replace('\\', '/', $class) . '.php';
    if (file_exists($file)) {
        require $file;
    }
});

// index.php
<?php

require_once 'autoload.php';

use App\Contracts\RendererInterface;
use App\Services\HtmlRenderer;

$renderer = new HtmlRenderer();
echo $renderer->render('
Hello
'); // работает

Hello

Результат: автозагрузка срабатывает без Composer, но требует, чтобы корневой неймспейс совпадал с именем папки.

Пример 5. Интерфейсы с наследованием

Интерфейс может расширять другой. Пример:

// src/Contracts/SimpleLoggerInterface.php
<?php

namespace App\Contracts;

interface SimpleLoggerInterface
{
    public function log(string $message): void;
}

// src/Contracts/ExtendedLoggerInterface.php
<?php

namespace App\Contracts;

interface ExtendedLoggerInterface extends SimpleLoggerInterface
{
    public function logWithContext(string $message, array $context): void;
}

// src/Services/AdvancedLogger.php
<?php

namespace App\Services;

use App\Contracts\ExtendedLoggerInterface;

class AdvancedLogger implements ExtendedLoggerInterface
{
    public function log(string $message): void
    {
        echo $message;
    }

    public function logWithContext(string $message, array $context): void
    {
        echo $message . ' ' . json_encode($context);
    }
}

Результат: класс, реализующий дочерний интерфейс, обязан реализовать все методы цепочки наследования.