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 и почему второй источник нельзя имитировать внутри рабочего каталога.
- В 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. Это пустой результат, а не сбой внешнего сервиса. - В панели файлов 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 или настоящий внешний сервис для этого опыта не нужен. - В корне
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.
Чтобы сохранять прогресс, войдите или зарегистрируйтесь.
Следующий материал ↗