Гостьова книга, крок 6: валідація і захист від XSS
Мета
Захистити гостьову книгу від хибних і небезпечних даних. Сервер сам перевіряє кожне поле нового запису — довжину імені й тексту через mb_strlen(), оцінку через filter_var(), — бо браузерну перевірку легко обійти. Помилки з'являються біля своїх полів, а введене лишається у формі. Кожен рядок на сторінці виводиться через хелпер e(), тож скрипт, вписаний в ім'я, стає звичайним текстом. Знаходити типові помилки перевірки й виведення: strlen() замість mb_strlen(), if (!$x) після filter_var() і вивід без екранування.
Завдання
Продовжуємо проєкт із кроку 5 — практики «Гостьова книга, крок 5: пошук і форма нового запису». Сторінка вже приймає форму нового запису, але приймає все: порожнє ім'я, текст з однієї літери, оцінку 9. Браузер такої форми не надішле — заважають required і список оцінок, — проте curl надсилає що завгодно. У цьому кроці сервер навчиться відмовляти, а виведення стане безпечним.
Має вийти:
- функція
validateEntry(array $input): arrayуfunctions.phpповертає помилки за полями: ім'я — від 2 до 50 символів післяtrim(), текст запису — від 5 до 500, оцінка — ціле число від 1 до 5. Порожній масив — помилок немає; - без помилок запис додається, як у кроці 5. З помилками запис не додається: над записами — «Запис не додано», біля кожного хибного поля — його повідомлення, а введені значення лишаються у формі;
- хелпер
e(string $value): string—htmlspecialchars($value, ENT_QUOTES, 'UTF-8')— виводить кожен рядок сторінки: записи, запит у полі пошуку, значення й помилки форми, привітання в шапці; - запис з ім'ям
<script>alert(1)</script>показується текстом, адреса?q=<script>— теж: тегу<script>немає в жодній відповіді; - запит повз браузерну перевірку (
curl -d …) отримує ті самі помилки, що й форма.
intita-php/
└── src/
├── guestbook/
│ ├── functions.php ← + e() і validateEntry()
│ ├── data.php
│ └── templates/
│ ├── header.php ← привітання через e()
│ └── footer.php
└── public/
├── bugs-validation.php ← нове: вправа з кроку 9
└── guestbook/
├── index.php ← перевірка POST, помилки біля полів, e()
└── style.css ← стилі помилок
Теорія — у лекціях «Перевірка даних форми» і «XSS і htmlspecialchars». Новий запис, як і в кроці 5, живе лише в одній відповіді: зберігати записи навчимося в модулі 12 «Сесії та cookies» і модулі 13 «Файли та JSON».
Кроки
-
Старт: сервер приймає все. Запустіть робочий проєкт
intita-php(docker compose up -d) і відкрийтеhttp://localhost:8080/guestbook/— сторінка має працювати так, як після кроку 5. Тепер надішліть форму повз браузер — без імені, з текстом з однієї літери й оцінкою 9:curl -s -d "name=&message=Х&rating=9" http://localhost:8080/guestbook/ | grep -A4 'id="entry-8"'<article class="entry" id="entry-8"> <h2></h2> <p class="date">2026-10-06 04:14</p> <p>Х</p> <p class="rating rating-none"><span class="stars">★★★★★</span> Оцінка: 9 — Без оцінки</p>Сервер додав запис з порожнім заголовком, п'ятьма зірками й оцінкою «9 — Без оцінки» (час у вас — свій).
curlне знає ні проrequired, ні про список оцінок: як показала лекція «Перевірка даних форми», браузерна перевірка сервер не захищає. Вindex.phpзамініть коментар підdeclareна// Гостьова книга, крок 6: валідація і захист від XSS. -
Хелпер
e(). У кінецьfunctions.phpдодайте функцію екранування — ту саму, що в розділі «Хелпер e()» лекції:/** * Рядок, безпечний для HTML: & < > " ' стають сутностями — і в тексті, і в значенні атрибута. */ function e(string $value): string { return htmlspecialchars($value, ENT_QUOTES, 'UTF-8'); }ENT_QUOTESекранує обидві лапки:"стає", а'—'. Без нього апостроф з «O'Neil» закрив би значення атрибута в одинарних лапках.'UTF-8'— кодування сторінки, як<meta charset="UTF-8">у шапці. Обидва аргументи пишемо явно: так результат не залежить від версії PHP і її налаштувань.- Коротке ім'я — щоб екранування не забували:
<?= e($q) ?>ненабагато довше за<?= $q ?>.
-
Усе виведення — через
e(). Правило з лекції: безe()на сторінку потрапляють хіба числа. Вindex.phpзамініть коженhtmlspecialchars(…)наe(…)і огорнітьe()решту рядків шаблону. Ось рядки після заміни — у тому порядку, в якому вони стоять у шаблоні; відступи й решта шаблону не змінюються:<p class="banner <?= $isOpen ? 'banner-open' : 'banner-closed' ?>"><?= e($bannerText) ?></p> <p class="count"><?= e(pluralEntries($entriesCount)) ?>, середня оцінка <?= e(number_format($averageRating, 1, ',', '')) ?></p> <input type="search" id="q" name="q" value="<?= e($q) ?>"> <p class="count">Знайдено <?= e(pluralEntries($foundCount)) ?></p> <h2><?= e($entry['name']) ?></h2> <p class="date"><?= e($entry['created_at']) ?></p> <p><?= e($entry['message']) ?></p> <p class="rating <?= e(ratingClass($entry['rating'])) ?>"><span class="stars"><?= e(stars($entry['rating'])) ?></span> Оцінка: <?= $entry['rating'] ?> — <?= e(ratingLabel($entry['rating'])) ?></p> <a href="?page=<?= $pageNumber ?><?= e($searchParam) ?>"><?= $pageNumber ?></a>А в шаблоні
templates/header.php— привітання:<p class="greeting"><?= e($greeting) ?>! Залиште кілька слів на згадку.</p>- Без
e()лишаються числа —$entry['id'],$entry['rating'],$pageNumber— і шматки розмітки, написані прямо в шаблоні, як'banner-open'.e()чекає рядок: число в ній зіdeclare(strict_types=1)зупинить сторінку зTypeError. - Привітання, підпис оцінки чи кількість записів сторінка формує сама, і небезпечних символів у них немає. Але правило «кожен рядок — через
e()» простіше за «щоразу вирішуй, звідки взявся рядок»: дані, які сьогодні пише код, завтра можуть прийти з файлу чи бази даних. - Шапка бачить
e(), боindex.phpпідключаєfunctions.phpраніше за шаблон.
Перевірте: на адресі
http://localhost:8080/guestbook/?q=<script>поле пошуку показує текст<script>, а підпис — «Нічого не знайдено».Ctrl+U: у коді сторінки —value="<script>". Такe()зупиняє відбитий XSS з лекції «XSS і htmlspecialchars». - Без
-
Функція
validateEntry(). У кінецьfunctions.phpдодайте перевірку полів нового запису:/** * Помилки полів нового запису: ключ — ім'я поля, значення — повідомлення; порожній масив — помилок немає. * Поля $input — рядки, вже обрізані trim(): 'name' — 2–50 символів, 'message' — 5–500, 'rating' — ціле 1–5. */ function validateEntry(array $input): array { $errors = []; // Довжину рахує mb_strlen(): кирилична літера — один символ, хоч і два байти $nameLength = mb_strlen($input['name']); if ($nameLength === 0) { $errors['name'] = "Вкажіть ім'я"; } elseif ($nameLength < 2 || $nameLength > 50) { $errors['name'] = "Ім'я — від 2 до 50 символів"; } $messageLength = mb_strlen($input['message']); if ($messageLength === 0) { $errors['message'] = "Напишіть текст запису"; } elseif ($messageLength < 5 || $messageLength > 500) { $errors['message'] = "Текст запису — від 5 до 500 символів"; } // filter_var() повертає ціле число або false, тож помилка — лише === false $range = ['options' => ['min_range' => 1, 'max_range' => 5]]; if (filter_var($input['rating'], FILTER_VALIDATE_INT, $range) === false) { $errors['rating'] = "Оцінка — ціле число від 1 до 5"; } return $errors; }- Функція повертає масив помилок за іменами полів, як
$errorsу розділі «Масив помилок і помилки біля полів» лекції: ключ — поле, значення — повідомлення. Порожній масив — помилок немає. Перевіряються всі три поля, тож людина одразу бачить усі помилки, а не лише першу. - Поля приходять уже без пробілів по краях:
trim()зробитьindex.phpу наступному кроці. Ім'я з трьох пробілів стане порожнім рядком і отримає «Вкажіть ім'я». - Довжину рахує
mb_strlen():strlen()рахує байти, а кирилична літера займає два, тож ім'я з 26 літер (52 байти) «не вмістилося» б у 50. filter_var()зFILTER_VALIDATE_INTіmin_range/max_rangeприймає лише запис цілого числа від 1 до 5:"4"даєint(4), а"9","abc","4.5"і""—false. Помилку перевіряємо строго,=== false, як радить лекція.- Повідомлення про ім'я — у подвійних лапках: в «Ім'я» є апостроф.
- Функція повертає масив помилок за іменами полів, як
-
Перевірка перед додаванням. В
index.phpзамініть блок обробки POST з кроку 5 — від коментаря// Новий запис із POST-форми…до закривної}— таким:// Поля форми нового запису — рядки, як їх надсилає браузер; порожня форма пропонує оцінку 5 $emptyForm = ['name' => '', 'message' => '', 'rating' => '5']; $form = $emptyForm; $errors = []; // Новий запис із POST-форми — лише якщо поля пройшли перевірку; у кінець масиву, тож на сторінці він перший. // Зберігати його ніде: він живе лише в цій відповіді, наступний запит знову почне з data.php $isAdded = false; if ($_SERVER['REQUEST_METHOD'] === 'POST') { $form = [ 'name' => trim($_POST['name'] ?? ''), 'message' => trim($_POST['message'] ?? ''), 'rating' => trim($_POST['rating'] ?? ''), ]; $errors = validateEntry($form); if (count($errors) === 0) { $entries[] = [ 'id' => nextId($entries), 'name' => $form['name'], 'message' => $form['message'], 'rating' => (int) $form['rating'], 'created_at' => date('Y-m-d H:i'), ]; $isAdded = true; // Запис додано — форма знову порожня, щоб його не надіслали вдруге $form = $emptyForm; } }$form— значення полів для шаблону: на GET — порожня форма$emptyFormз оцінкою'5', на POST — те, що надіслали, вже післяtrim(). Тому рядки// Оцінка, обрана у формі нового запису за замовчуваннямі$defaultRating = 5;нижче більше не потрібні — видаліть їх.- Оцінка в
$formлишається рядком, як прийшла:(int)зробив би зabcнуль ще до перевірки. Числом вона стає лише в записі — післяvalidateEntry(), коли відомо, що це ціле від 1 до 5. $errorsзадано доif, як змінні полів у лекції: шаблон працює і на GET.- Запис додається, лише коли
count($errors) === 0. Після цього форма знову порожня: інакше щойно доданий запис лишився б у полях, і друге натискання «Додати запис» додало б його ще раз.
-
Помилки біля полів і введені значення. Під повідомленням
$isAddedпокажіть, що запис не додано:<?php if (count($errors) > 0): ?> <p class="notice notice-error">Запис не додано: <a href="#new-entry">виправте поля форми</a>.</p> <?php endif; ?>Форму нового запису замініть повністю — тепер вона показує введене й помилки:
<form class="new-entry" id="new-entry" method="post" action="/guestbook/"> <h2>Новий запис</h2> <label for="name">Ім'я</label> <input type="text" id="name" name="name" value="<?= e($form['name']) ?>" required minlength="2" maxlength="50"> <?php if (isset($errors['name'])): ?> <p class="error"><?= e($errors['name']) ?></p> <?php endif; ?> <label for="message">Текст запису</label> <textarea id="message" name="message" rows="4" required minlength="5" maxlength="500"><?= e($form['message']) ?></textarea> <?php if (isset($errors['message'])): ?> <p class="error"><?= e($errors['message']) ?></p> <?php endif; ?> <label for="rating">Оцінка</label> <select id="rating" name="rating"> <?php for ($value = 1; $value <= 5; $value++): ?> <option value="<?= $value ?>"<?= (string) $value === $form['rating'] ? ' selected' : '' ?>><?= $value ?></option> <?php endfor; ?> </select> <?php if (isset($errors['rating'])): ?> <p class="error"><?= e($errors['rating']) ?></p> <?php endif; ?> <button type="submit">Додати запис</button> </form>id="new-entry"— ціль посилання з повідомлення: форма внизу, під записами, і#new-entryпрокручує сторінку до неї.value="<?= e($form['name']) ?>"і текст між тегамиtextareaповертають введене, як у розділі «Введені значення лишаються у формі» лекції модуля 10.e()тут обов'язкова: лапка в імені закрила б атрибутvalue.selectedотримує пункт, що збігається з надісланою оцінкою.$form['rating']— рядок,$value— число з циклу, а===порівнює ще й тип, тому рядком робимо лічильник:(string) $value. Дляrating=6чиabcтакого пункту немає, і список покаже 1 — помилка під ним пояснить чому.- Під кожним полем — його помилка, якщо такий ключ є:
isset($errors['name']). minlengthіmaxlengthповторюють правила сервера в браузері: підказка з'являється одразу, без запиту. Це зручність, а не захист — захищаєvalidateEntry().
-
Стилі. Допишіть у кінець
style.css:.notice-error { background: #ffebe9; color: #cf222e; } .error { margin: 4px 0 0; color: #cf222e; font-size: 14px; }.notice-errorстоїть нижче за.noticeі перекриває лише кольори: повідомлення про помилку — червоне, як закритий банер. -
Перевірка. У браузері:
- додайте запис «Тарас» / «Привіт усім» / 4 — він нагорі, як у кроці 5, а форма знову порожня, з оцінкою 5;
- введіть ім'я «А» — браузер не надішле форму й підкаже, що символів замало. Видаліть у DevTools (Elements) атрибут
minlengthполя «Ім'я» і надішліть ще раз: тепер відповідає сервер — «Запис не додано», біля імені «Ім'я — від 2 до 50 символів», а текст і оцінка лишилися у формі; - додайте запис з ім'ям
<script>alert(1)</script>— вікнаalertнемає, ім'я показується текстом разом із кутовими дужками; - на жодній сторінці немає
Warning,Notice,DeprecatedчиFatal error.
З терміналу — запити повз браузерну перевірку, по одному на кожну помилку:
curl -s -d "name=А&message=Привіт усім&rating=4" http://localhost:8080/guestbook/ | grep -E 'class="error"|name="name"' curl -s -d "name=Тарас&message=Привіт усім&rating=6" http://localhost:8080/guestbook/ | grep 'class="error"' curl -s -d "name=Тарас&message=Привіт усім&rating=abc" http://localhost:8080/guestbook/ | grep 'class="error"' curl -s -d "name=Тарас&message=&rating=4" http://localhost:8080/guestbook/ | grep -E 'class="error"|name="name"' curl -s -d "name=<script>alert(1)</script>&message=Привіт усім&rating=4" http://localhost:8080/guestbook/ | grep 'script' curl -s "http://localhost:8080/guestbook/?q=%3Cscript%3E" | grep 'name="q"'%3Cscript%3E— це<script>, закодований для адреси так, як його кодує браузер. Запит з кроку 1 тепер отримує три помилки й нового запису не додає. У коді відповіді апостроф у повідомленні —': це теж роботаe(), а браузер показує звичайний'. -
Знайди помилку: спершу прогноз. Колега робить сторінку відгуків для іншого сайту, де можна поставити й 0 зірок. Правила: ім'я — від 2 до 50 символів, зірок — ціле число від 0 до 5. Три запити нижче мали дати три відгуки, але в коді три помилки. Створіть тренувальний файл
src/public/bugs-validation.php— не в папціguestbook: це вправа, а не частина книги. Код дослівно:<?php declare(strict_types=1); // Тренувальна сторінка: відгуки із зірками від 0 до 5 $entries = []; $errors = []; if ($_SERVER['REQUEST_METHOD'] === 'POST') { $name = trim($_POST['name'] ?? ''); if (strlen($name) < 2 || strlen($name) > 50) { $errors[] = "Ім'я — від 2 до 50 символів"; } $range = ['options' => ['min_range' => 0, 'max_range' => 5]]; $rating = filter_var($_POST['rating'] ?? '', FILTER_VALIDATE_INT, $range); if (!$rating) { $errors[] = 'Зірок — від 0 до 5'; } if (count($errors) === 0) { $entries[] = ['name' => $name, 'rating' => $rating]; } } ?> <?php foreach ($errors as $error): ?> <p class="error"><?= htmlspecialchars($error, ENT_QUOTES, 'UTF-8') ?></p> <?php endforeach; ?> <?php foreach ($entries as $entry): ?> <p><?= $entry['name'] ?> — зірок: <?= $entry['rating'] ?></p> <?php endforeach; ?> <form method="post"> <input name="name" placeholder="Ім'я" required minlength="2" maxlength="50"> <input type="number" name="rating" placeholder="Зірок, 0–5" required min="0" max="5"> <button>Надіслати</button> </form>Надсилайте запити з терміналу, повз браузерну перевірку, — так видно сирий HTML відповіді:
curl -s -d "name=Анастасія Олександрівна Шевчук&rating=4" http://localhost:8080/bugs-validation.php | grep '<p' curl -s -d "name=Олена&rating=0" http://localhost:8080/bugs-validation.php | grep '<p' curl -s -d "name=<script>alert(1)</script>&rating=5" http://localhost:8080/bugs-validation.php | grep '<p'- перед кожним запитом допишіть у кінці файлу прогноз —
<!-- прогноз 1: … -->, потім<!-- прогноз 2: … -->і<!-- прогноз 3: … -->: які рядки<p>поверне сервер і чому. Кінець файлу — поза<?php, тому прогноз — HTML-коментар; - після запиту допишіть у прогноз
вгадавабоне вгадав: чому …, як у практиці кроку 5; - виправте три помилки, як радять лекції модуля: функцію, що рахує довжину, перевірку результату
filter_var()і виведення імені.e()у цьому файлі немає — він не підключаєfunctions.php, — тож екрануйте так само, як рядок з$error:htmlspecialchars(…, ENT_QUOTES, 'UTF-8').
Після виправлень ті самі три запити дають три відгуки, а в третьому ім'я — текстом. У браузері третій запит до виправлень показав би вікно
alert:curlпояснює чому — тег прийшов у відповідь як є. - перед кожним запитом допишіть у кінці файлу прогноз —
-
Зробіть коміт:
git add src/guestbook src/public/guestbook src/public/bugs-validation.phpіgit commit -m "practice: guestbook validation and XSS protection".
Порада
Документація PHP: filter_var(), фільтри перевірки, mb_strlen(), htmlspecialchars(), trim().
Важливо
Перевірка в браузері — підказка для людини, перевірка на сервері — захист: validateEntry() перевіряє кожен POST, навіть якщо у формі є required і minlength. Кожен рядок на сторінці — лише через e(), а результат filter_var() — лише === false.
Очікуваний результат
Відповідь на запит повз браузерну перевірку з помилками в усіх трьох полях — curl -s -d "name=А&message=Ок&rating=6" http://localhost:8080/guestbook/ (привітання у вас — своє):
Відповіді на запити з кроків 1, 3 і 8:
| Запит | Помилки біля полів | Сторінка й форма |
|---|---|---|
POST name=Тарас&message=Привіт усім&rating=4 |
— | запис з id 8 нагорі, «8 записів, середня оцінка 3,9»; форма порожня, обрано 5 |
POST name=А&message=Привіт усім&rating=4 |
ім'я: «Ім'я — від 2 до 50 символів» | «Запис не додано», «7 записів, середня оцінка 3,9»; у полях А, «Привіт усім», обрано 4 |
POST name=Тарас&message=Привіт усім&rating=6 |
оцінка: «Оцінка — ціле число від 1 до 5» | ім'я й текст у полях; жоден пункт не обрано, список показує 1 |
POST name=Тарас&message=Привіт усім&rating=abc |
оцінка: «Оцінка — ціле число від 1 до 5» | те саме |
POST name=Тарас&message=&rating=4 |
текст: «Напишіть текст запису» | ім'я в полі, обрано 4 |
POST name=&message=Х&rating=9 (крок 1) |
усі три: «Вкажіть ім'я», «Текст запису — від 5 до 500 символів», «Оцінка — ціле число від 1 до 5» | запис не додано, «7 записів» |
POST name=<script>alert(1)</script>&message=Привіт усім&rating=4 |
— | запис з id 8 додано, ім'я показано текстом |
GET /guestbook/?q=<script> |
— | «Нічого не знайдено», у полі пошуку — <script> текстом |
- У жодній відповіді немає тегу
<script>— лише<script>— і немаєWarning,Notice,DeprecatedчиFatal error. - Ім'я «Анастасія Олександрівна Шевчук» — 30 символів, хоч і 58 байтів, — проходить перевірку, а ім'я з 51 літери — ні.
Вивід команд curl з кроку 8 (відступи — з шаблону). Перша команда:
<input type="text" id="name" name="name" value="А" required minlength="2" maxlength="50">
<p class="error">Ім'я — від 2 до 50 символів</p>
Друга й третя дають однаковий рядок:
<p class="error">Оцінка — ціле число від 1 до 5</p>
Четверта:
<input type="text" id="name" name="name" value="Тарас" required minlength="2" maxlength="50">
<p class="error">Напишіть текст запису</p>
П'ята — лише заголовок запису, тегу <script> у відповіді немає:
<h2><script>alert(1)</script></h2>
Шоста:
<input type="search" id="q" name="q" value="<script>">
Сторінка bugs-validation.php до виправлень — звірте з прогнозами. Запит 1:
<p class="error">Ім'я — від 2 до 50 символів</p>
Запит 2:
<p class="error">Зірок — від 0 до 5</p>
Запит 3:
<p><script>alert(1)</script> — зірок: 5</p>
Ті самі три запити після трьох виправлень:
<p>Анастасія Олександрівна Шевчук — зірок: 4</p>
<p>Олена — зірок: 0</p>
<p><script>alert(1)</script> — зірок: 5</p>
Критерії оцінювання
Роботу оцінюють за 10-бальною шкалою:
| Критерій | Бали |
|---|---|
Перевірка (кроки 4–6, 8): validateEntry() з mb_strlen() і filter_var() з === false; кожен невалідний запит з кроку 8 отримує помилку біля свого поля, введені значення лишаються у формі, запис не додається; валідний запис додається, а форма порожніє |
4 |
Екранування (кроки 2, 3, 6): e() з ENT_QUOTES і 'UTF-8'; кожен рядок сторінки — через e(), зокрема значення форми й q; <script>alert(1)</script> показано текстом, тегу <script> у відповідях немає |
3 |
bugs-validation.php (крок 9): прогноз до кожного запиту, позначки вгадав / не вгадав: чому, три виправлення; вивід — як в «Очікуваному результаті» |
2 |
Коміт practice: guestbook validation and XSS protection |
1 |
| Разом | 10 |
Завдання з розділу «Додатково (*)» балів понад 10 не додає: воно може повернути до 2 балів, знятих за критеріями вище, але оцінка не перевищує 10.
Що здати
Посилання на коміт practice: guestbook validation and XSS protection з такими файлами:
src/guestbook/functions.php,src/guestbook/templates/header.php;src/public/guestbook/index.php,src/public/guestbook/style.css;src/public/bugs-validation.php.
Або архів, якщо так домовлено на занятті. Будьте готові пояснити, навіщо сервер перевіряє поля, хоча у формі є required і minlength, чому довжину рахує mb_strlen(), а результат filter_var() порівнюють === false, і що зробив би браузер з ім'ям <script>alert(1)</script> без e().
Додатково (*)
- Підсвітка хибного поля. Полю з помилкою додайте атрибут
aria-invalid="true"— він підказує програмам читання з екрана, що поле заповнено хибно, — і стиль.new-entry [aria-invalid="true"] { border-color: #cf222e; }. Атрибут має з'являтися лише тоді, коли ключ поля є в$errors. - Масив замість рядка. Надішліть
curl -s -d "name[]=Тарас&message=Привіт усім&rating=4" http://localhost:8080/guestbook/: з[]в імені поля PHP складає масив, і сторінка зупиняється зTypeError—trim()чекає рядок. Напишіть функціюformField(string $key): string, яка повертає'', коли поля немає або воно не рядок (is_string()), і читайте нею всі три поля. - Скільки символів зараз. Нехай повідомлення каже й скільки символів уведено: «Ім'я — від 2 до 50 символів, а у вас 51». Число дає
mb_strlen(), а повідомлення, як і раніше, виводиться черезe().