PHPTime

Шпаргалка по SOLID с примерами на PHP 8

SOLID помогает понять, где провести границу между расчётом и отправкой письма, какой контракт обещает интерфейс и что придётся менять при добавлении новой функции. Разберём пять принципов на коротких примерах для PHP 8.3–8.5. Для каждого принципа покажем типичную ошибку, её последствия и способ исправить код.

1. SRP — принцип единственной ответственности

У модуля должна быть одна причина для изменения. Чтобы найти границу ответственности, спросите, какие требования меняются независимо. Правила расчёта заказа, формат письма и способ доставки письма живут по разным правилам и могут меняться в разных задачах.

Типичная ошибка

Метод Order::total() считает стоимость, формирует письмо и отправляет его. Вызов метода из корзины или фоновой задачи неожиданно уведомляет клиента. Чтобы проверить сумму, приходится отключать отправку или подменять почтовый клиент.

Пример на PHP

PHP
<?php
declare(strict_types=1);

final readonly class OrderLine
{
    public function __construct(
        public int $unitPriceKopecks,
        public int $quantity,
    ) {}
}

final class OrderTotal
{
    public function calculate(OrderLine ...$lines): int
    {
        // Считаем в копейках, чтобы не округлять дробные суммы.
        $total = 0;
        foreach ($lines as $line) {
            $total += $line->unitPriceKopecks * $line->quantity;
        }

        return $total;
    }
}

$total = new OrderTotal();
echo $total->calculate(new OrderLine(12900, 2)); // 25800

Расчёт можно вызывать из корзины, команды CLI и теста. Отправку письма запускайте в сценарии оформления заказа, когда заказ сохранён. Несколько методов в одном классе вполне уместны, если все они обслуживают одну ответственность.

2. OCP — принцип открытости и закрытости

Открытость к расширению означает, что новый вариант поведения можно добавить через предусмотренный контракт. Закрытость к изменению означает, что при этом стабильный код, который использует контракт, остаётся прежним.

Типичная ошибка

Добавление самовывоза требует править одинаковые ветки match в корзине, API и оформлении заказа. Если забыть одну ветку, клиент увидит разные суммы на разных этапах. Сам match хорошо подходит для небольшого закрытого набора вариантов в одном месте. Проблема возникает, когда одно правило размножается по системе.

Пример на PHP

PHP
<?php
declare(strict_types=1);

interface DeliveryRate
{
    /** Стоимость в копейках для положительного веса в граммах. */
    public function price(int $weightGrams): int;
}

final class CourierRate implements DeliveryRate
{
    public function price(int $weightGrams): int
    {
        return $weightGrams <= 5000 ? 49000 : 79000;
    }
}

final class PickupRate implements DeliveryRate
{
    public function price(int $weightGrams): int
    {
        return 0;
    }
}

function checkoutTotal(int $subtotal, int $weightGrams, DeliveryRate $rate): int
{
    // Оформление заказа одинаково для всех способов доставки.
    return $subtotal + $rate->price($weightGrams);
}

echo checkoutTotal(120000, 6000, new CourierRate()); // 199000

Чтобы подключить тариф постамата, добавьте реализацию DeliveryRate и зарегистрируйте её там, где приложение выбирает способ доставки. Формулу итоговой суммы менять не потребуется. Выделяйте такую точку расширения, когда уже видны варианты поведения и понятно, какой контракт у них общий.

3. LSP — принцип подстановки Барбары Лисков

Код, работающий с базовым типом, должен сохранять корректность при подстановке любой реализации. Совместимость сигнатур проверяет PHP. Совместимость поведения зависит от того, какие входные данные, результаты и исключения обещает контракт.

Типичная ошибка

Интерфейс хранилища обещает возвращать null, если товар отсутствует. Одна реализация при отсутствии товара бросает исключение. Контроллер, который рассчитывал вернуть 404 после проверки на null, теперь может вернуть 500. Ошибка соединения с хранилищем при этом остаётся отдельной ситуацией.

Пример на PHP

PHP
<?php
declare(strict_types=1);

final readonly class Product
{
    public function __construct(public int $id, public string $name) {}
}

interface ProductLookup
{
    /** Возвращает null, если товара с таким ID нет. */
    public function find(int $id): ?Product;
}

final readonly class InMemoryProductLookup implements ProductLookup
{
    /** @param array<int, Product> $products Товары по ID. */
    public function __construct(private array $products) {}

    public function find(int $id): ?Product
    {
        return $this->products[$id] ?? null;
    }
}

$products = new InMemoryProductLookup([7 => new Product(7, 'Кружка')]);
echo $products->find(8)?->name ?? 'Товар не найден';

Для реализации с БД закрепите такое же поведение при пустом результате. Прогоняйте одинаковые проверки контракта для каждой реализации. Поиск по существующему ID возвращает нужный товар, поиск по отсутствующему возвращает null. Если реализация требует дополнительных условий от вызывающего кода или ослабляет обещанный результат, её нельзя безопасно подставить.

4. ISP — принцип разделения интерфейсов

Клиент должен зависеть только от операций, которыми пользуется. Границы интерфейса удобнее искать по сценариям. Публичному каталогу нужны операции чтения, редактору нужны операции записи.

Типичная ошибка

Интерфейс Catalog объединяет find(), save() и delete(). Адаптер каталога из файла может читать данные, а ради совместимости вынужден объявлять методы записи и бросать из них исключения. Потребители такого интерфейса видят доступную операцию, которую конкретный адаптер выполнить не может.

Пример на PHP

PHP
<?php
declare(strict_types=1);

interface CatalogReader
{
    public function findName(int $id): ?string;
}

interface CatalogWriter
{
    public function saveName(int $id, string $name): void;
}

final readonly class ArrayCatalog implements CatalogReader
{
    /** @param array<int, string> $names Названия по ID. */
    public function __construct(private array $names) {}

    public function findName(int $id): ?string
    {
        return $this->names[$id] ?? null;
    }
}

function catalogHeading(CatalogReader $catalog, int $id): string
{
    // Для заголовка достаточно доступа на чтение.
    return $catalog->findName($id) ?? 'Товар не найден';
}

echo catalogHeading(new ArrayCatalog([7 => 'Кружка']), 7);

Адаптер базы данных может реализовать оба интерфейса, а экран каталога по-прежнему принимает только CatalogReader. Если клиенты всегда используют группу методов вместе, оставьте их в одном интерфейсе. Смысл разделения в потребностях клиента, а число методов само по себе ничего не решает.

5. DIP — принцип инверсии зависимостей

Сценарий приложения задаёт контракт для нужной ему операции, а инфраструктурный адаптер реализует этот контракт. Так бизнес-правило можно использовать с разными источниками данных и проверять отдельно от инфраструктуры.

Типичная ошибка

Сценарий регистрации открывает соединение через PDO и выполняет SQL внутри register(). Проверка даже простого правила о возрасте требует поднять БД. Передача PDO через конструктор убирает создание соединения из сценария, но сценарий всё ещё знает о SQL и схеме хранения.

Пример на PHP

PHP
<?php
declare(strict_types=1);

interface UserStore
{
    public function add(string $email, int $age): void;
}

final readonly class RegisterUser
{
    public function __construct(private UserStore $users) {}

    public function register(string $email, int $age): void
    {
        if ($age < 18) {
            throw new InvalidArgumentException('Регистрация доступна с 18 лет.');
        }

        $this->users->add($email, $age);
    }
}

// В тесте сохраняем данные в память. В приложении сюда передают адаптер БД.
$store = new class implements UserStore {
    public array $users = [];

    public function add(string $email, int $age): void
    {
        $this->users[] = ['email' => $email, 'age' => $age];
    }
};

(new RegisterUser($store))->register('anna@example.test', 24);
echo count($store->users); // 1

Выбирайте реализацию при сборке приложения, вручную или через DI-контейнер. Передача объекта через конструктор — это внедрение зависимости. Инверсию здесь даёт направление зависимости в коде. RegisterUser работает с контрактом UserStore, а адаптер БД подстраивается под него.

Чек-лист SOLID для ревью PHP-кода

  • SRP. Можно ли изменить расчёт или уведомление по отдельности? Есть ли у метода побочный эффект, которого вызывающий код не ожидает?
  • OCP. Сколько мест придётся править при добавлении нового тарифа? Начните с устранения дублирующихся правил.
  • LSP. Одинаково ли все реализации обрабатывают пограничные случаи, отсутствие данных и исключения? Зафиксируйте эти ожидания тестами контракта.
  • ISP. Приходится ли адаптеру объявлять операции, которых он не поддерживает? Посмотрите, какие методы нужны каждому клиенту.
  • DIP. Можно ли проверить бизнес-правило без подключения к БД, сети или файловой системе? Поместите инфраструктурные детали за контрактом сценария.

Каждый пример можно сохранить в отдельный PHP-файл и запустить. declare(strict_types=1) в начале файла включает строгую проверку скалярных аргументов при вызовах из этого файла. Для значений из HTTP, CLI и БД всё равно нужны явное преобразование и валидация на границе приложения. При рефакторинге начните с одного сценария, где изменения уже задевают лишний код, и сначала закрепите его текущее поведение тестом.

Частые вопросы

Нужен ли интерфейс для каждого класса в PHP?

Нет. Интерфейс полезен, когда клиенту нужен самостоятельный контракт, например для разных тарифов или для отделения бизнес-логики от хранилища. Класс с простой конкретной ролью можно использовать напрямую.

Чем OCP отличается от DIP?

OCP отвечает за то, где добавить новый вариант поведения, сохранив стабильный код. DIP отвечает за направление зависимостей. Например, сценарий регистрации задаёт контракт хранилища, а адаптер базы данных его реализует.

Можно ли применять SOLID без фреймворка и DI-контейнера?

Да. PHP умеет проверять типы и интерфейсы без дополнительных библиотек. Создайте нужные объекты в точке входа и передайте зависимости через конструкторы. Контейнер может автоматизировать сборку, когда зависимостей станет много.

Справка по теме

Ещё в разделе «Возможности PHP»

Проблема модификации даты через strtotime в PHP

Почему strtotime('-1 month') возвращает не тот месяц, как корректно вычитать и прибавлять месяцы в PHP 8.3–8.5 и какие современные альтернативы использовать.

6 мин

Релиз PHP 7: что изменилось и как перейти на PHP 8

Что изменилось в PHP 7: производительность, скалярные типы, типы возврата, операторы ?? и <=>. План перехода с PHP 7.x на PHP 8.3–8.5 с проверкой совместимости.

7 мин

Возможности PHP 5.6 и их развитие в PHP 8.x

Разбираем ключевые возможности PHP 5.6: variadic-функции, оператор **, импорт функций и константные выражения. Как это работает в PHP 8.3–8.5.

6 мин

Принцип открытости/закрытости в PHP

Как применять принцип открытости/закрытости в PHP. Сравнение наследования и композиции, абстракции и интерфейсы, типизированные коллекции, стратегии.

9 мин