Перевірка даних форми
Що ви дізнаєтесь
- Чому браузерна перевірка форми не захищає сервер
- Як перевірити обов'язкове поле і довжину тексту з кирилицею
- Як
filter_var()перевіряє ціле число в діапазоні та email - Як зібрати помилки в масив і показати кожну біля свого поля
Сторінки з лекції «Обробка форми в одному файлі» приймали все, що прийшло: (int) мовчки робив з "abc" нуль. Тепер сервер навчиться відмовляти.
Ніколи не довіряй користувачу
Форма запису на екскурсію Львовом перевіряє поля ще в браузері — атрибутами з лекції «HTML-форми»:
<form method="post">
<input name="name" required minlength="2" maxlength="40" placeholder="Ім'я">
<input type="email" name="email" required placeholder="Email">
<input type="number" name="tickets" required min="1" max="5" value="1">
<button>Записатися</button>
</form>
Порожнє ім'я чи 9 квитків браузер не надішле, а покаже підказку біля поля. Але ця перевірка працює на комп'ютері користувача, і її легко обійти:
- DevTools. Elements → виділіть поле → видаліть
requiredабо змінітьmax="5"наmax="500"— і форма надішле що завгодно. - curl. Запит можна надіслати без браузера й форми: сервер не знає, звідки прийшли дані.
curl -s -d "name=Я&email=abc&tickets=500" http://localhost:8080/tour.php
Сторінка, яка лише читає поля, як у модулі 10, запише на екскурсію гостя з ім'ям «Я», адресою abc і 500 квитками. Браузерна перевірка — це зручність: підказка без зайвого запиту. Захищає лише перевірка на сервері, і вона потрібна в кожному обробнику, навіть якщо у формі є required.
Важливо
Будь-яке поле $_GET чи $_POST може бути відсутнім, порожнім, задовгим або не того типу — навіть якщо форма це забороняє.
Текстові поля: trim(), обов'язковість, довжина
<?php
var_dump(trim(" Олена\n")); // string(10) "Олена"
var_dump(trim(" ")); // string(0) ""
var_dump(strlen("Олена"), mb_strlen("Олена")); // int(10) int(5)
var_dump(strlen("Я"), mb_strlen("Я")); // int(2) int(1)
trim() з кроку 5 гостьової книги прибирає пробіли, табуляції й переноси рядків по краях. Тому текст читають так: $name = trim($_POST['name'] ?? '');. ?? '' рятує, коли поля в запиті немає зовсім, а trim() — від імені з трьох пробілів, яке інакше пройшло б перевірку !== ''. Обов'язкове поле — те, що після trim() не порожнє.
Довжину рахує mb_strlen(), а не strlen(): strlen() рахує байти (лекція «Типи даних, рядки і перетворення типів»), а кирилична літера в UTF-8 займає два. Зі strlen() перевірка «від 2 до 40 символів» помилялася б в обидва боки: однолітерне «Я» (2 байти) пройшло б мінімум, а ім'я «Олександра Коваленко-Шевчук» (27 символів, але 52 байти) не вмістилося б у 40.
Числа й email: filter_var()
filter_var() — нова вбудована функція: перевіряє значення за фільтром і повертає його вже потрібного типу або false, якщо значення не підходить.
<?php
$range = ['options' => ['min_range' => 1, 'max_range' => 5]];
var_dump(filter_var("3", FILTER_VALIDATE_INT, $range)); // int(3)
var_dump(filter_var("9", FILTER_VALIDATE_INT, $range)); // bool(false): поза діапазоном
var_dump(filter_var("5abc", FILTER_VALIDATE_INT, $range)); // bool(false): не ціле число
var_dump((int) "5abc"); // int(5)
var_dump(filter_var("olena@example.com", FILTER_VALIDATE_EMAIL)); // string(17) "olena@example.com"
var_dump(filter_var("olena@", FILTER_VALIDATE_EMAIL)); // bool(false)
FILTER_VALIDATE_INTприймає лише запис цілого числа:"3"стаєint(3), а"5abc","2.5"чи порожній рядок —false.(int)з"5abc"мовчки робить 5, аfilter_var()каже: це не число.- Третій аргумент — масив налаштувань:
min_rangeіmax_rangeзадають діапазон, межі входять у нього. FILTER_VALIDATE_EMAILперевіряє формат адреси: ім'я скриньки, одна@і домен на кшталтexample.com. Пробіли по краях — уже помилка, тож спершуtrim(). Чи існує скринька, функція не знає: це перевіряють листом із посиланням.
Увага
filter_var() може повернути int(0) — правильне значення, яке if (!$x) вважає хибою. Тому помилку перевіряють строго: === false.
Масив помилок і помилки біля полів
Одна змінна $error показала б лише першу проблему, і про email людина дізналася б тільки з другої спроби. Тому сервер перевіряє всі поля й складає помилки в асоціативний масив: ключ — ім'я поля, значення — повідомлення. Порожній масив — помилок немає.
<?php
// src/public/tour.php
$name = '';
$email = '';
$tickets = '1';
$errors = [];
$isSent = false;
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
$name = trim($_POST['name'] ?? '');
$email = trim($_POST['email'] ?? '');
$tickets = trim($_POST['tickets'] ?? '');
if ($name === '') {
$errors['name'] = "Вкажіть ім'я";
} elseif (mb_strlen($name) < 2 || mb_strlen($name) > 40) {
$errors['name'] = "Ім'я — від 2 до 40 символів";
}
if (filter_var($email, FILTER_VALIDATE_EMAIL) === false) {
$errors['email'] = 'Email на кшталт olena@example.com';
}
$range = ['options' => ['min_range' => 1, 'max_range' => 5]];
if (filter_var($tickets, FILTER_VALIDATE_INT, $range) === false) {
$errors['tickets'] = 'Квитків — від 1 до 5';
}
$isSent = count($errors) === 0;
}
?>
<?php if ($isSent): ?>
<p>Дякуємо, <?= htmlspecialchars($name) ?>! Квитків: <?= (int) $tickets ?></p>
<?php endif; ?>
<form method="post">
<input name="name" value="<?= htmlspecialchars($name) ?>">
<?php if (isset($errors['name'])): ?>
<p class="error"><?= $errors['name'] ?></p>
<?php endif; ?>
<input name="email" value="<?= htmlspecialchars($email) ?>">
<?php if (isset($errors['email'])): ?>
<p class="error"><?= $errors['email'] ?></p>
<?php endif; ?>
<input name="tickets" value="<?= htmlspecialchars($tickets) ?>">
<?php if (isset($errors['tickets'])): ?>
<p class="error"><?= $errors['tickets'] ?></p>
<?php endif; ?>
<button>Записатися</button>
</form>
- Змінні полів задано до
if, як у модулі 10: шаблон працює і на першомуGET. - Під кожним полем — його помилка, якщо такий ключ є:
isset($errors['name']). - Введені значення повертаються в
value, тож виправити треба лише хибне поле.$ticketsлишається рядком: у полі буде те, що ввели, навітьabc. - Дані користувача виводяться через
htmlspecialchars()— чому, розбирає наступна лекція. - Атрибути
required,minіmaxтут опущено, а в справжній сторінці вони лишаються.
Той самий запит з curl, що й на початку лекції, тепер отримує три помилки:
curl -s -d "name=Я&email=abc&tickets=500" http://localhost:8080/tour.php | grep error
<p class="error">Ім'я — від 2 до 40 символів</p>
<p class="error">Email на кшталт olena@example.com</p>
<p class="error">Квитків — від 1 до 5</p>
Підсумок
- Браузерна перевірка (
required,min,max,type="email") — зручність, а не захист: її прибирають у DevTools або обходять запитом зcurl. - Сервер перевіряє кожне поле сам: воно може бути відсутнім, порожнім, задовгим чи не того типу.
- Текст спершу проходить
trim(); обов'язкове поле — непорожнє післяtrim(). - Довжину тексту рахує
mb_strlen():strlen()рахує байти, а кирилична літера займає два. filter_var()зFILTER_VALIDATE_INTіmin_range/max_rangeперевіряє ціле число в діапазоні, зFILTER_VALIDATE_EMAIL— формат адреси; помилка — лише=== false.- Помилки збирають у масив за іменами полів, показують кожну біля свого поля, а введені значення повертають у форму.
Що далі
Лекція «XSS і htmlspecialchars» — чому все, що ввів користувач, виводять лише через htmlspecialchars().