УРОК · Паттерны без лишних абстракций

Strategy и Adapter

Опубликовано Автор: Соловьёва Мария Андреевна

Поиск по названию сейчас выполняется одним способом в public/index.php. Разберём, когда понадобился бы другой алгоритм или перевод чужого формата.

Разберём по шагам

Strategy — выбор между взаимозаменяемыми способами одного действия. Сейчас у каталога только фильтр mb_stripos по маленькому списку; вводить переключаемые классы без второго требования незачем. Adapter нужен, если данные приходят в чужом формате. В приложении нет внешнего API, поэтому пример ниже — отдельный учебный файл, который переводит придуманные поля name/text в существующие title/body. Он различает пустой список и испорченную запись. Веб-приложение не подключает этот файл и не делает сетевых запросов.

Слова, которые пригодятся

Strategy
Способ выбирать между несколькими реализациями одного действия по общему контракту. В нынешнем каталоге второй реализации поиска нет, поэтому отдельный Strategy не создаётся.
Adapter
Код, который переводит чужой формат в формат приложения. Учебная функция превращает name/text в title/body, но не подключена к сайту.
Контракт результата
Согласованная форма успешных данных и ошибок. Пустой список означает, что совпадений нет, а исключение означает, что источник вернул непригодную запись.

У Strategy должен быть смысловой выбор: два работающих способа с одинаковым контрактом и известной причиной переключения. Для нынешней маленькой SQLite достаточно одного фильтра; SQL-поиск мог бы понадобиться при росте данных, но его нельзя объявлять равным по Unicode-поведению без проверки. Никакого переключателя в public/index.php сейчас не добавляем.

Adapter меняет форму данных на границе чужого интерфейса: учебные name и text становятся title и body. Если запись повреждена, исключение сохраняет смысл сбоя. Возврат [] вместо ошибки ложно сообщил бы «заметок нет». Демонстрационный файл не должен выдаваться за интеграцию с API; до такой интеграции нужны реальный источник, протокол и проверки отказов.

Рабочий пример

<?php
// Полный отдельный файл notes-php/examples/search-adapter-demo.php
declare(strict_types=1);
function adaptExampleRows(array $rows): array
{
    $notes = [];
    foreach ($rows as $row) {
        if (!is_array($row) || !isset($row['id'], $row['name'], $row['text'])
            || !is_int($row['id']) || !is_string($row['name']) || !is_string($row['text'])) {
            throw new InvalidArgumentException('Неверный формат внешней записи');
        }
        $notes[] = ['id' => $row['id'], 'title' => $row['name'], 'body' => $row['text']];
    }
    return $notes;
}
echo json_encode(adaptExampleRows([['id' => 7, 'name' => 'Пример', 'text' => 'Текст']]), JSON_UNESCAPED_UNICODE), PHP_EOL;
echo 'Пусто: ', count(adaptExampleRows([])), PHP_EOL;
try {
    adaptExampleRows([['id' => 7]]);
} catch (InvalidArgumentException $e) {
    echo 'Ошибка: ', $e->getMessage(), PHP_EOL;
}

Практика

Сравните настоящий пустой поиск с ошибкой формата в отдельном примере. Так станет ясно, когда нужны Strategy или Adapter и почему второй источник нельзя имитировать внутри рабочего каталога.

  1. В Visual Studio Code откройте notes-php/public/index.php после прошлого урока и найдите mb_stripos в строках поиска. Из корня проекта запустите php -S localhost:8000 -t public; во втором терминале PowerShell выполните curl.exe -i -G --data-urlencode "q=нет-такого-названия" http://localhost:8000/: текущая работающая версия даёт 200 и «Ничего не найдено.». Остановите сервер Ctrl+C. Это пустой результат, а не сбой внешнего сервиса.
  2. В панели файлов Visual Studio Code создайте в корне папку examples, а в ней search-adapter-demo.php. Вставьте полный пример, сохраните Ctrl+S. Выполните php -l examples/search-adapter-demo.php, затем php examples/search-adapter-demo.php: ожидайте JSON с id, title, body, строку Пусто: 0 и отдельную строку Ошибка: Неверный формат внешней записи. Никакой URL или настоящий внешний сервис для этого опыта не нужен.
  3. В корне notes-php создайте search-contract.md рядом с pattern-decision.md. Запишите: «Сейчас — один фильтр mb_stripos, вход q до 100 символов, результат — список id/title/body»; «Пустой результат — [], ошибка чужого формата — отдельная ошибка»; «Другой алгоритм, например SQL-поиск, потребует повторной проверки русских букв и порядка»; «Внешний API пока отсутствует; учебный Adapter не подключён к сайту». Сохраните Ctrl+S. Выполните git status --short и git diff --check: новые файлы должны быть видны, а действующий поиск не должен измениться.

Как проверить себя

Рабочий поиск по-прежнему возвращает пустой результат без ошибки. Отдельный пример переводит поля, различает [] и повреждённую запись; search-contract.md честно отмечает, что второй источник и Strategy в приложении не реализованы.

Если не получилось
  • php -l сообщает об ошибке? Проверьте, что весь пример сохранён в examples/search-adapter-demo.php и кавычки не заменены редактором на типографские.
  • Вместо Ошибка: программа оборвалась? Убедитесь, что вызов с неполной записью находится внутри try, а catch перехватывает InvalidArgumentException.
  • curl.exe не подключился? Проверьте запуск сервера из notes-php и порт 8000; для русских букв используйте --data-urlencode, как в Workflow2.