УРОК · Архитектура приложения

Модель данных и инварианты

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

Форма уже использует 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. Он поможет выбрать следующую правку, не выдавая будущие права доступа за работающую функцию.

  1. В 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, где вызова нет.
  2. Оставьте сервер из 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 с ошибкой и одинаковое число строк до и после.
  3. В 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? Это ожидаемо: вход и проверка владельца здесь записаны только как план.