Паттерн как ответ на проблему
После Workflow3 notes-php уже ищет и сохраняет заметки. Сначала найдём повторяющуюся работу в реальных файлах и решим, какое разделение ей нужно.
Разберём по шагам
В public/index.php и add-note.php отдельно записан один и тот же INSERT INTO notes; change-note.php меняет запись напрямую. Это причина проверить границу работы с данными. Сейчас источник один — SQLite, поэтому небольшой функции для общего INSERT достаточно. Класс Repository с множеством методов и Service с проверкой владельца пока добавили бы обещания, которых приложение не выполняет: входа и владельца здесь нет. Сначала запишем наблюдение и критерий выбора, в следующем уроке вынесем только нужные операции.
Слова, которые пригодятся
- Паттерн
- Повторяемый способ организовать решение определённой проблемы. Например, общий доступ к данным может скрыть одинаковый SQL от двух входов приложения.
- Причина изменения
- Событие, из-за которого приходится править код. Если меняется структура записи заметки, два одинаковых
INSERTсейчас пришлось бы менять по отдельности. - Граница
- Место разделения задач кода. Функция проверки названия не открывает базу, а будущие функции хранения не должны формировать HTML-ответ.
Паттерн — узнаваемый способ устроить код для повторяющейся проблемы. Его название само по себе не улучшает программу. Сейчас простая функция может убрать два одинаковых INSERT; она даст конкретную пользу без новой иерархии классов. Если появится вторая реализация хранения, тогда сравните стоимость её подключения с нынешним решением.
src/note-rules.php проверяет только название, а src/db.php открывает PDO. Ни один из них не является готовым Repository или Service. Запись в pattern-decision.md не меняет поведение приложения; она связывает будущую правку с наблюдаемой причиной.
Рабочий пример
git status --short
Select-String -Path public/index.php,add-note.php,change-note.php -Pattern 'INSERT INTO notes','UPDATE notes','SELECT id, title'
php -r 'require "src/note-rules.php"; echo isValidTitle("Заметка") ? "true" : "false", PHP_EOL;'
Практика
Не добавляйте паттерн по названию. Найдите повторение в текущем каталоге и запишите, какую маленькую правку оно оправдывает.
- В Visual Studio Code откройте существующий
notes-phpпосле Workflow3 черезФайл → Открыть папку. ВТерминал → Создать терминализ корня выполнитеgit status --short: после прошлого урока ожидайте пустой вывод. Затем выполните строкуSelect-Stringиз примера. Найдите дваINSERT INTO notes, вpublic/index.phpиadd-note.php, а такжеUPDATEвchange-note.php. - В том же терминале выполните
php -rиз примера: ожидайтеtrueбез обращения к базе. Откройтеsrc/note-rules.phpи убедитесь, чтоisValidTitleне требует PDO. Это уже существующий удачный пример простой функции: она решает одну задачу без класса. - В панели файлов Visual Studio Code создайте в корне
notes-phpфайлpattern-decision.mdрядом сREADME.md. Запишите четыре строки: «Факт: два INSERT в HTTP и CLI»; «Меняется: место SQL, если изменится запись»; «Остаётся: проверка title и HTTP-ответ»; «Сейчас: две функции доступа к SQLite; класс и Service пока не нужны». Допишите условие пересмотра: второй способ хранения или несколько сценариев с общими правилами. СохранитеCtrl+Sи выполнитеgit status --short: новый документ должен быть виден как?? pattern-decision.md.
Как проверить себя
В pattern-decision.md названы реальные файлы и повторение; команда находит два INSERT, а проверка isValidTitle работает без PDO. Выбор функции обоснован текущим объёмом задачи.
Если не получилось
Select-Stringне нашёл SQL? ПроверьтеGet-Location: терминал должен быть в корнеnotes-phpпосле Workflow3, а не вpublic.php -rсообщает об отсутствииmb_strlen? Проверьтеphp -mи включениеmbstringиз PHP1.- В
git status --shortуже есть чужие изменения? Не смешивайте их с упражнением; сначала разберите статус по правилам Workflow1.
Чтобы сохранять прогресс, войдите или зарегистрируйтесь.
Следующий материал ↗