Модель данных и инварианты
Форма уже использует isValidTitle. Проверим, защищает ли это правило все пути изменения заметки.
Разберём по шагам
Для названия мы хотим одно правило: после trim строка содержит от 1 до 200 символов. POST / теперь вызывает isValidTitle, но отдельный учебный change-note.php из SQLite3 выполняет UPDATE напрямую. В setup.php поле title объявлено обязательным, но это не запрещает пустую строку. Поэтому желаемое правило пока не гарантировано для всей базы. Сначала зафиксируем доказательство и обход, не изменяя рабочие данные.
Слова, которые пригодятся
- Инвариант
- Правило, которое должно выполняться для каждой записи независимо от способа её создания или изменения. Для
titleэто непустой текст длиной не более 200 символов послеtrim. - Обход правила
- Путь изменения данных, который не вызывает общую проверку. Учебный
change-note.phpможет выполнитьUPDATEбезisValidTitle. - NOT NULL
- Ограничение таблицы, которое не позволяет сохранить отсутствующее значение
NULL. Пустая строка''при этом остаётся допустимой. - Владелец записи
- Пользователь, которому разрешено менять конкретную запись после входа. В нынешнем одноавторском проекте владельцы не определяются.
Инвариант называют правилом, которое должно оставаться верным при любом способе записи. Здесь это цель, а не уже доказанное свойство: веб-форма проверяет название, CLI-скрипт может его обойти. NOT NULL в SQL защищает только от NULL, поэтому открытие setup.php и change-note.php нужно для честной карты риска.
В каталоге нет входа, столбца user_id или проверки владельца. Сообщение 403 для чужой записи нельзя получить из нынешнего приложения. Запишите эти вещи как будущую задачу, не добавляя воображаемого пользователя в текущие проверки.
| Правило | Состояние | Доказательство |
|---|---|---|
| title от 1 до 200 после trim | Проверяется в POST / | Пустой POST не добавляет строку |
| То же правило для CLI UPDATE | Есть обход | change-note.php не вызывает isValidTitle |
| Права владельца | Будущий этап после входа | user_id и вход пока отсутствуют |
Рабочий пример
Цель: title — строка длиной 1–200 после trim.
Сейчас: POST / вызывает isValidTitle($rawTitle).
Обход: change-note.php содержит UPDATE без isValidTitle.
Позже: вход, user_id и проверка владельца; сейчас их нет.
Практика
Составьте документ, который отделяет доказанную защиту формы от обхода через CLI. Он поможет выбрать следующую правку, не выдавая будущие права доступа за работающую функцию.
- В Visual Studio Code откройте
public/index.php,src/note-rules.php,change-note.phpиsetup.php. В корнеnotes-phpсоздайтеarchitecture-notes.mdрядом сrequest-flow.md, перенесите четыре строки примера и сохранитеCtrl+S. В строке «Сейчас» укажите вызовisValidTitle($rawTitle)из POST; в строке «Обход» — веткуUPDATEвchange-note.php, где вызова нет. - Оставьте сервер из Architecture2 работающим. Во втором терминале PowerShell из корня
notes-phpвыполнитеphp -r '$p = require "src/db.php"; echo $p->query("SELECT COUNT(*) FROM notes")->fetchColumn(), PHP_EOL;', затемcurl.exe -i --data "title=&body=" http://localhost:8000/и снова ту же команду подсчёта. Ожидайте200с ошибкой и одинаковое число строк до и после. - В
architecture-notes.mdдопишите, чтоtitle TEXT NOT NULLвsetup.phpне запрещает пустой текст, аchange-note.phpпока обходится безisValidTitle; исправление этого CLI-входа — отдельная будущая правка. Отдельным абзацем пометьте план, не текущую функцию: после появления входа понадобятсяuser_idи серверная проверка владельца перед изменением. Сохраните файл; чужойidи403сейчас проверять негде.
Как проверить себя
architecture-notes.md отличает действующий POST, обход через CLI-UPDATE и будущие права. Пустой POST показывает ошибку без новой строки, но правило не объявлено уже обеспеченным для всех входов.
Если не получилось
- Число строк выросло после пустого POST? Проверьте, что сервер использует обновлённый
public/index.phpиз Architecture2 и условие вызываетisValidTitle($rawTitle). - Не находите
UPDATE? Вchange-note.phpиз SQLite3 найдите ветку$action === 'update'; запускать скрипт для этой проверки не нужно. - В таблице нет
user_id? Это ожидаемо: вход и проверка владельца здесь записаны только как план.
Чтобы сохранять прогресс, войдите или зарегистрируйтесь.
Следующий материал ↗