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

Границы и зависимости

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

В public/index.php смешаны проверка названия и работа с базой. Вынесем одно правило без изменения поведения формы.

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

Сейчас public/index.php проверяет длину названия и через PDO записывает строку в SQLite. Для проверки самого названия база не нужна: функция может получить только значение из формы и ответить true или false. Создадим её в src/note-rules.php, затем подключим к существующему POST. Новые классы для заметки и хранилища пока не создаём: для этого шага достаточно функции.

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

Зависимость
То, что нужно коду для работы. INSERT зависит от подключения PDO, а функция проверки названия от базы не зависит.
Граница
Место, где разделяются разные задачи кода. src/note-rules.php будет отвечать только за правило названия, а public/index.php — за запрос и ответ.
Чистая функция
Функция, которая при одинаковом входе возвращает одинаковый ответ и не меняет внешнее состояние. isValidTitle возвращает true или false и не пишет в SQLite.
mixed
Тип PHP для значения, которое заранее может иметь разный вид. Здесь он позволяет проверить строку и безопасно отклонить массив title[] из HTTP-запроса.

Зависимость — вещь, без которой код не может выполнить свою задачу. Для INSERT нужен PDO, а для ответа «название подходит?» достаточно самого входного значения и mbstring. Функция isValidTitle не подключает базу, не меняет файл и не отправляет HTTP-ответ; это граница, которую можно проверить отдельно.

Тип mixed означает, что из запроса может прийти строка, массив или другое значение. Функция сначала проверяет is_string, затем убирает пробелы по краям и считает символы в UTF-8, включая русские буквы. В public/index.php остаются нормализация $title для записи, проверка $body, INSERT и редирект. Если позднее изменить способ хранения, правило названия не обязано меняться.

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

<?php
// notes-php/src/note-rules.php
declare(strict_types=1);
function isValidTitle(mixed $rawTitle): bool
{
    if (!is_string($rawTitle)) {
        return false;
    }
    $title = trim($rawTitle);
    return $title !== '' && mb_strlen($title, 'UTF-8') <= 200;
}

Практика

Вы сможете проверить правило названия без базы четырьмя входами, а затем подключить его к той же форме. Результат для посетителя останется прежним.

  1. В Visual Studio Code в уже открытом notes-php создайте файл src/note-rules.php рядом с db.php. Вставьте полный пример, сохраните Ctrl+S. Из корня проекта выполните php -l src/note-rules.php и php -m; ожидайте отсутствие синтаксических ошибок и mbstring в списке.
  2. Во втором терминале PowerShell из корня notes-php выполните php -r 'require "src/note-rules.php"; foreach (["Note", "", [], str_repeat("x", 201)] as $value) { echo (isValidTitle($value) ? "true" : "false") . PHP_EOL; }'. Ожидайте четыре строки: true, false, false, false. Команда не открывает src/db.php и работает без базы.
  3. Откройте public/index.php. Сразу после declare(strict_types=1); вставьте строку require_once dirname(__DIR__) . '/src/note-rules.php';. В POST-ветке замените только условие $title === '' || mb_strlen($title) > 200 || !is_string($rawBody) на !isValidTitle($rawTitle) || !is_string($rawBody). Присваивания $title и $body, текст ошибки, INSERT и остальной файл оставьте. Сохраните Ctrl+S, выполните php -l public/index.php.
  4. Оставьте сервер из первого урока работающим или запустите php -S localhost:8000 -t public из корня. Выполните curl.exe -i --data "title=Rule&body=Check" http://localhost:8000/: ожидайте 303 и Location: /. Затем отправьте curl.exe -i --data "title=&body=" http://localhost:8000/: ожидайте 200 с ошибкой. Повторите проверку массива curl.exe -i --data "title[]=x&body=" http://localhost:8000/; новая запись не должна появиться.

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

Отдельная функция даёт true, false, false, false без PDO; после подключения допустимый POST по-прежнему даёт 303, а пустой и нестроковый ввод остаются на форме без INSERT.

Если не получилось
  • undefined function mb_strlen при отдельной проверке? Выполните php -m в этом терминале и включите mbstring в загруженном php.ini из предыдущего PHP-блока.
  • undefined function isValidTitle на странице? Сверьте строку require_once после declare(strict_types=1);, путь src/note-rules.php и сохранение обоих файлов.
  • Успешный POST перестал давать 303? Убедитесь, что заменили только условие if, а $title, $body, подготовленный INSERT и header('Location: /', true, 303) остались на месте.