Перейти до змісту
Intita
Лекція · 35 хв

Перевірка даних форми

Що ви дізнаєтесь

  • Чому браузерна перевірка форми не захищає сервер
  • Як перевірити обов'язкове поле і довжину тексту з кирилицею
  • Як 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.

Що виведе var_dump(strlen(trim(" Ян ")), mb_strlen(" Ян "));?

Числа й 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.

Поле «Скільки дітей з вами» приймає від 0 до 3 (код нижче). На kids=0 форма показує помилку. Де помилка?
<?php
$kids = filter_var($_POST['kids'] ?? '', FILTER_VALIDATE_INT, ['options' => ['min_range' => 0, 'max_range' => 3]]);
if (!$kids) {
    $errors['kids'] = 'Від 0 до 3';
}

Масив помилок і помилки біля полів

Одна змінна $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>
У форму tour.php ввели ім'я " Я " (з пробілами по краях), email ya@example.com і 5 квитків. Які ключі будуть у $errors?

Підсумок

  • Браузерна перевірка (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().