Гостьова книга, крок 5: пошук і форма нового запису
Мета
Застосувати обробку форм у справжньому проєкті. GET-форма пошуку читає запит із $_GET і лишає його в полі та в посиланнях сторінок, а POST-форму нового запису обробляє та сама сторінка — гілку обирає $_SERVER['REQUEST_METHOD']. Дані форми перетворюються одразу під час читання: trim() для тексту, (int) для оцінки, — а все, що ввів користувач, виводиться лише через htmlspecialchars(). Знаходити типові помилки з формами: поле без name, не той метод форми й рядок проти числа в ===.
Завдання
Продовжуємо проєкт із кроку 4 — практики «Гостьова книга, крок 4: функції і шаблони». Форма нового запису з кроку 2 досі нічого не робила, а знайти запис можна було лише гортанням сторінок. У цьому кроці сторінка навчиться шукати записи за ім'ям і приймати форму нового запису.
Має вийти:
- над записами — GET-форма «Пошук за ім'ям» з полем
q:?q=олі?q=ОЛзнаходять Олену з підписом «Знайдено 1 запис», а для?q=zzzсторінка пише «Нічого не знайдено». Шукає функціяfilterEntries(array $entries, string $q): arrayуfunctions.php— без урахування регістру й з кирилицею; - посилання сторінок зберігають пошук (
?page=2&q=…), а поле пошуку показує введений запит; index.phpсам обробляє POST-форму нового запису: запис зid8 і поточним часом з'являється нагорі, а підпис над записами — «8 записів»;- запис живе лише в цій відповіді, і сторінка чесно про це каже: наступний запит знову бере сім записів із
data.php. Зберігати записи навчимося в модулі 12 «Сесії та cookies» і модулі 13 «Файли та JSON»; - усе, що ввів користувач, — ім'я, текст запису, запит
q— виводиться черезhtmlspecialchars(): ім'я<b>Тарас</b>показується текстом.
intita-php/
└── src/
├── guestbook/
│ ├── functions.php ← + filterEntries() і nextId()
│ ├── data.php
│ └── templates/
└── public/
├── bugs-forms.php ← нове: вправа з кроку 10
└── guestbook/
├── index.php ← пошук і обробка POST
└── style.css ← стилі пошуку й повідомлення
Теорія — у лекціях «Дані форми на сервері: $_GET і $_POST» і «Обробка форми в одному файлі». Перевіряти, чи ім'я не порожнє, а оцінка — від 1 до 5, навчимося в модулі 11 «Валідація та безпека введення».
Кроки
-
Старт і запит пошуку. Запустіть робочий проєкт
intita-php(docker compose up -d) і відкрийтеhttp://localhost:8080/guestbook/— сторінка має працювати так, як після кроку 4. Вindex.phpзамініть коментар підdeclareна// Гостьова книга, крок 5: пошук і форма нового запису, а під блоком$pageдодайте запит пошуку:// Пошук за ім'ям — з адресного рядка (?q=ол), без пробілів по краях; порожній — усі записи $q = trim($_GET['q'] ?? '');trim()— нова вбудована функція: повертає рядок без пробілів, табуляцій і переносів рядка по краях,trim(" Олена ")→"Олена". Запитолз випадковим пробілом знайде те саме, що йол.?? ''— як радить лекція «Дані форми на сервері: $_GET і $_POST»: без?q=в адресі ключа немає, і замістьWarningсторінка отримує порожній рядок. Порожній запит означає, що пошуку немає.
-
Функція
filterEntries(). У кінецьfunctions.phpдодайте функцію пошуку:/** * Записи, в імені яких є $q, без урахування регістру; для порожнього $q — усі записи. */ function filterEntries(array $entries, string $q): array { if ($q === '') { return $entries; } $found = []; foreach ($entries as $entry) { // mb_stripos() повертає позицію збігу (0 — на початку імені) або false, тож лише !== false if (mb_stripos($entry['name'], $q) !== false) { $found[] = $entry; } } return $found; }mb_stripos()— нова вбудована функція: шукає один рядок в іншому без урахування регістру й повертає позицію першого збігу, рахуючи з 0, абоfalse, якщо збігу немає:mb_stripos("Олена", "ол")→0.mb_на початку — як уmb_strlen()з лекції «Типи даних, рядки і перетворення типів»: функція рахує символи, а не байти, і знає великі й малі літери кирилиці.stripos("Олена", "ол")безmb_даєfalse: великі й малі літери вона зрівнює лише для латиниці.!== false, а не простоif (mb_stripos(…)): позиція0означає збіг на самому початку імені, аif (0)— хиба, тож Олену запитолзагубив би.- Для порожнього
$qфункція одразу повертає всі записи — раннійreturn, як вaverageRating().
-
Пошук на сторінці. В
index.phpпід$averageRating = …;додайте результат пошуку:// Результат пошуку: записи, в імені яких є $q; без пошуку — усі $foundEntries = filterEntries($entries, $q); $foundCount = count($foundEntries);Сторінки тепер рахуються від знайденого:
pagesCount($foundCount, $perPage)замістьpagesCount($entriesCount, $perPage)іpageEntries($foundEntries, $page, $perPage)замістьpageEntries($entries, $page, $perPage). Підпис «7 записів, середня оцінка 3,9» лишається для всієї книги. У шаблоні підif-блоком цього підпису додайте форму пошуку й підпис результату — з тим самим відступом у 8 пробілів, що й решта шаблону:<form class="search" method="get"> <label for="q">Пошук за ім'ям</label> <input type="search" id="q" name="q" value="<?= htmlspecialchars($q) ?>"> <button type="submit">Знайти</button> </form> <?php if ($q !== '' && $foundCount === 0): ?> <p class="count">Нічого не знайдено</p> <?php elseif ($q !== ''): ?> <p class="count">Знайдено <?= pluralEntries($foundCount) ?></p> <?php endif; ?>type="search"— текстове поле для пошуку: браузер показує в ньому хрестик, що очищає запит.value="<?= htmlspecialchars($q) ?>"— запит лишається в полі після пошуку, як у розділі «Введені значення лишаються у формі» лекції.htmlspecialchars()тут обов'язкова:qвводить користувач, і лапка в запиті закрила б атрибутvalue.- Форма без
actionнадсилає запит на поточну сторінку:/guestbook/?q=ол. GET-форма замінює весь рядок після?своїми полями, тожpageз адреси зникає, і результат пошуку починається з першої сторінки.
Перевірте:
?q=олі?q=ОЛпоказують лише Олену з підписом «Знайдено 1 запис», а?q=zzz— «Нічого не знайдено», без записів і без навігації. Після «Знайти» відкрийте DevTools (F12) → Network → запитguestbook/?q=…→ Payload: полеq— у розділі Query String Parameters. -
Сторінки пам'ятають пошук. Знайдіть
а: «Знайдено 6 записів», на першій сторінці — п'ять. Але посилання «2» веде на?page=2і губитьq: друга сторінка показує Андрія й Олену з усієї книги, а не шостий знайдений запис. Додайте вindex.phpпід$pageEntries = …;частину адреси з пошуком:// Пошук у посиланнях сторінок: &q=… у кодуванні адреси; без пошуку — нічого $searchParam = $q === '' ? '' : '&q=' . urlencode($q);і допишіть її в посилання навігації:
<a href="?page=<?= $pageNumber ?><?= htmlspecialchars($searchParam) ?>"><?= $pageNumber ?></a>urlencode()— нова вбудована функція: кодує рядок для адреси так само, як браузер кодує поля форми:а→%D0%B0, пробіл →+.htmlspecialchars()перетворює&на&— так&записують усередині HTML-атрибута, а браузер читає його назад як&.- Без пошуку
$searchParamпорожній, і посилання лишаються?page=2, як у кроці 4.
Перевірте: на
?q=апосилання «2» веде на?page=2&q=а, і там — Олена, шостий знайдений запис. -
Екранування записів. Досі імена й тексти записів писали ви самі в
data.php, а тепер їх вводить будь-хто у формі. Тому в шаблоні запису виведіть їх черезhtmlspecialchars(), як$userAgentу практиці модуля 4 «Практика (*): що сервер знає про ваш запит»:<h2><?= htmlspecialchars($entry['name']) ?></h2> <p class="date"><?= $entry['created_at'] ?></p> <p><?= htmlspecialchars($entry['message']) ?></p>created_atіratingсторінка формує сама — час даєdate(), оцінку —(int), — тож їх не екрануємо. Ім'я<b>Тарас</b>тепер з'явиться на сторінці текстом разом із кутовими дужками, а не жирним. Що може зробити зловмисник, коли вивід не екрановано, розберемо в модулі 11 «Валідація та безпека введення». -
Обробка POST у тому ж файлі. Спершу — функція для номера нового запису, у кінець
functions.php:/** * Номер для нового запису: найбільший id + 1; для порожньої книги — 1. */ function nextId(array $entries): int { if (count($entries) === 0) { return 1; } return max(array_column($entries, 'id')) + 1; }max()— нова вбудована функція: повертає найбільше значення масиву,max([4, 8, 2])→8. Для порожнього масиву вона зупиняє скрипт зValueError, тому спершуcount(). Саме найбільшийid+ 1, а не кількість + 1: щойно записи можна буде видаляти (модуль 12 «Сесії та cookies»), номери перестануть іти підряд.Тепер в
index.phpодразу під$entries = require …;додайте обробку форми:// Новий запис із POST-форми — у кінець масиву, тож на сторінці він перший. // Зберігати його ніде: він живе лише в цій відповіді, наступний запит знову почне з data.php $isAdded = false; if ($_SERVER['REQUEST_METHOD'] === 'POST') { $entries[] = [ 'id' => nextId($entries), 'name' => trim($_POST['name'] ?? ''), 'message' => trim($_POST['message'] ?? ''), 'rating' => (int) ($_POST['rating'] ?? 0), 'created_at' => date('Y-m-d H:i'), ]; $isAdded = true; }- Відкрили сторінку посиланням — метод
GET, надіслали форму —POSTна ту саму адресу. Гілку обирає$_SERVER['REQUEST_METHOD'], як у розділі «Форма і обробник в одному файлі» лекції, а$isAddedзадано доif, тож шаблон працює для обох методів. $entries[] = …ставить запис у кінець масиву, аpageEntries()перевертає масив — тож новий запис стає першим на першій сторінці.(int)— бо з форми навіть оцінка приходить рядком"4", аratingClass(),stars()іratingLabel()у строгому режимі чекаютьint: без(int)сторінка зупинилася б зTypeError.?? ''і?? 0— щоб запит без поля, як-отcurl -X POSTбез даних, не давWarning.date('Y-m-d H:i')— поточний час у тому ж форматі, що йcreated_atуdata.php:Y— рік,m— місяць,d— день,H— години,i— хвилини.- Блок стоїть вище за
$entriesCountі$averageRating, тож підпис кількості й середня оцінка враховують новий запис. - Порожнє ім'я чи оцінку
9сторінка поки прийме як є: перевіряти поля навчимося в модулі 11 «Валідація та безпека введення».
- Відкрили сторінку посиланням — метод
-
Повідомлення, адреса форми і
idзапису. Під банером покажіть, що запис живе лише в цій відповіді:<?php if ($isAdded): ?> <p class="notice">Запис додано лише до цієї відповіді: зберігати записи книга ще не вміє, тож, щойно ви <a href="/guestbook/">відкриєте сторінку знову</a>, його не буде.</p> <?php endif; ?>Формі нового запису додайте адресу:
<form class="new-entry" method="post" action="/guestbook/">. Безactionформа надсилає дані на поточну адресу разом з?page=…чи?q=…: на?page=2новий запис опинився б на першій сторінці, якої не видно, а з?q=олйого відкинув би пошук. Зactionвідповідь на POST — завжди перша сторінка всієї книги.Статті запису додайте
id:<article class="entry" id="entry-<?= $entry['id'] ?>">. Номер запису тепер видно в коді сторінки, а на запис можна послатися:/guestbook/#entry-7прокручує сторінку до запису Софії. -
Стилі. Допишіть у кінець
style.cssстилі повідомлення й форми пошуку:.notice { padding: 8px 12px; border-radius: 6px; background: #fff8c5; color: #7d4e00; } .notice a { color: inherit; } .search { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; margin: 16px 0; } .search label { flex-basis: 100%; font-weight: 600; } .search input { flex: 1; min-width: 160px; padding: 6px 8px; font: inherit; border: 1px solid #d0d7de; border-radius: 6px; } .search button { padding: 6px 16px; font: inherit; color: #fff; background: #2b4c7e; border: 0; border-radius: 6px; cursor: pointer; } -
Перевірка. У браузері додайте запис: ім'я «Тарас», текст «Привіт усім», оцінка 4. Має з'явитися повідомлення, підпис «8 записів, середня оцінка 3,9», а першим — новий запис Тараса з поточним часом.
Ctrl+U: у коді сторінки —id="entry-8"і ваш поточний час.- DevTools → Network → запит
guestbook/→ Payload: розділ Form Data зname,messageіrating. - Клацніть посилання в повідомленні: знову 7 записів, Тараса з
id8 немає. - Додайте запис ще раз і натисніть
F5. Браузер спитає, чи надіслати дані форми повторно; погодьтеся — запис знову зid8, а не 9. Це повтор того самого POST, а не збереження: сервер знову почав із семи записівdata.php(лекція, розділ «Повторне надсилання при F5»). Як цього уникнути, розберемо в модулі 12 «Сесії та cookies». - Додайте запис зі сторінки
?page=2— він нагорі першої сторінки. - Ім'я
<b>Тарас</b>показується разом із кутовими дужками, а не жирним.
Те саме з терміналу.
-dнадсилає POST із тілом, як форма, — так само, якcurl -X POST -dу практиці модуля 1 «Практика: HTTP з командного рядка»:curl -s -d "name=Тарас&message=Привіт усім&rating=4" http://localhost:8080/guestbook/ | grep -A2 'id="entry-8"' curl -s -d "name=<b>Тарас</b>&message=Привіт усім&rating=4" http://localhost:8080/guestbook/ | grep 'Тарас' curl -s http://localhost:8080/guestbook/ | grep -c 'entry-8'Перша команда показує початок нового запису, друга — обидва заголовки з іменем Тарас (новий і з
data.php), третя рахуєentry-8у відповіді на GET. На жодній сторінці немаєWarning. -
Спершу прогноз, потім запуск. Колега зробив чернетку обробки форми нового запису. Після надсилання форми з ім'ям «Олена», текстом «Дуже корисно» й оцінкою 5 сторінка мала показати
Дякуємо, Олена! Запис отримано: «Дуже корисно». Дякуємо за найвищу оцінку!, але в коді три помилки. Створіть тренувальний файлsrc/public/bugs-forms.php— не в папціguestbook: це вправа, а не частина книги. Код дослівно (рядок 7 —$message, рядок 9 —if, рядок 17 —<form>, рядок 19 —textarea):<?php // Тренувальна сторінка: форма нового запису й обробка в одному файлі $reply = ""; if ($_SERVER['REQUEST_METHOD'] === 'POST') { $name = trim($_POST['name']); $message = trim($_POST['message']); $reply = "Дякуємо, " . $name . "! Запис отримано: «" . $message . "»."; if ($_POST['rating'] === 5) { $reply .= " Дякуємо за найвищу оцінку!"; } } ?> <?php if ($reply !== ""): ?> <p><?= htmlspecialchars($reply) ?></p> <?php endif; ?> <form method="get"> <input name="name" placeholder="Ім'я" required> <textarea placeholder="Текст запису" required></textarea> <select name="rating"> <option value="5">5</option> <option value="4">4</option> <option value="3">3</option> <option value="2">2</option> <option value="1">1</option> </select> <button>Додати запис</button> </form>Відкрийте
http://localhost:8080/bugs-forms.phpі щоразу заповнюйте форму однаково: Олена, «Дуже корисно», 5. Сторінку доведеться надсилати кілька разів:- перед кожним надсиланням допишіть у кінці файлу прогноз —
<!-- прогноз 1: … -->, потім<!-- прогноз 2: … -->і<!-- прогноз 3: … -->: що покаже сторінка і що буде в адресному рядку. Кінець файлу — поза<?php, тому прогноз — HTML-коментар, а в кінці файлу він не зсуває номери рядків у повідомленнях PHP; - після надсилання допишіть у прогноз
вгадавабоне вгадав: чому …, як у практиці кроку 4, і подивіться DevTools → Network → Payload: які поля браузер надіслав і як — в адресі чи в тілі запиту; - виправляйте по одній помилці — ту, на яку вказує сторінка чи Payload, — як радять лекції модуля: метод форми,
nameу полі,(int)для числа з форми.
Наостанок прочитайте поля так само, як гостьова книга:
trim($_POST['name'] ?? ''),trim($_POST['message'] ?? '')і(int) ($_POST['rating'] ?? 0). Запит лише з ім'ям тепер не дає попереджень — перевірте перший рядок відповіді:curl -s -d "name=Олена" http://localhost:8080/bugs-forms.php | head -1 - перед кожним надсиланням допишіть у кінці файлу прогноз —
-
Зробіть коміт:
git add src/guestbook src/public/guestbook src/public/bugs-forms.phpіgit commit -m "practice: guestbook search and new entry form".
Порада
Документація PHP: mb_stripos(), trim(), urlencode(), max(), htmlspecialchars(), $_POST.
Важливо
Усе, що ввів користувач, — ім'я, текст запису, запит q у полі пошуку — виводьте лише через htmlspecialchars(). У index.php і functions.php — лише строгі порівняння, зокрема !== false для результату mb_stripos().
Очікуваний результат
Відповідь на форму з ім'ям «Тарас», текстом «Привіт усім» і оцінкою 4 (привітання й час запису у вас — свої):
Сторінки пошуку (жирним — поточна сторінка, вона без посилання):
| Адреса | Підпис пошуку | Записи на сторінці | Навігація |
|---|---|---|---|
/guestbook/ |
— | Софія, Богдан, Ірина, Тарас, Марія | 1 2 |
/guestbook/?q=ол |
Знайдено 1 запис | Олена | — |
/guestbook/?q=ОЛ |
Знайдено 1 запис | Олена | — |
/guestbook/?q=а |
Знайдено 6 записів | Богдан, Ірина, Тарас, Марія, Андрій | 1 2 |
/guestbook/?page=2&q=а |
Знайдено 6 записів | Олена | 1 2 |
/guestbook/?q=zzz |
Нічого не знайдено | — | — |
- На всіх цих сторінках над формою пошуку — «7 записів, середня оцінка 3,9», а поле пошуку показує запит.
- Посилання «2» на
?q=аведе на?page=2&q=%D0%B0. - Ні на GET-сторінках, ні після POST немає
Warning,Notice,DeprecatedчиFatal error. - Після POST — повідомлення і «8 записів, середня оцінка 3,9»; наступний GET — знову «7 записів, середня оцінка 3,9», без Тараса з
id8.
Вивід трьох команд curl з кроку 9 (відступи — з шаблону, час — ваш):
<article class="entry" id="entry-8">
<h2>Тарас</h2>
<p class="date">2026-10-04 22:59</p>
<h2><b>Тарас</b></h2>
<h2>Тарас</h2>
0
Сторінка bugs-forms.php, перше надсилання — звірте з прогнозом 1. Адресний рядок:
http://localhost:8080/bugs-forms.php?name=Олена&rating=5
На сторінці — та сама порожня форма, без жодного повідомлення.
Друге надсилання:
Warning: Undefined array key "message" in /var/www/html/public/bugs-forms.php on line 7
Deprecated: trim(): Passing null to parameter #1 ($string) of type string is deprecated in /var/www/html/public/bugs-forms.php on line 7
Дякуємо, Олена! Запис отримано: «».
Третє надсилання:
Дякуємо, Олена! Запис отримано: «Дуже корисно».
Після всіх трьох виправлень:
Дякуємо, Олена! Запис отримано: «Дуже корисно». Дякуємо за найвищу оцінку!
Перший рядок відповіді на curl -s -d "name=Олена" http://localhost:8080/bugs-forms.php | head -1 з кроку 10 — до ?? '' там <br /> від попередження, а після:
<p>Дякуємо, Олена! Запис отримано: «».</p>
Критерії оцінювання
Роботу оцінюють за 10-бальною шкалою:
| Критерій | Бали |
|---|---|
Пошук (кроки 1–4): filterEntries() з mb_stripos() і !== false; ?q=ол, ?q=ОЛ і ?q=zzz — як в «Очікуваному результаті»; поле пошуку й посилання сторінок зберігають q |
3 |
Новий запис (кроки 6, 7, 9): POST обробляє той самий index.php; trim() для тексту, (int) для оцінки, id 8 з nextId() і поточний час; запис нагорі з повідомленням, наступний GET — без нього; форма з action="/guestbook/" |
3 |
Екранування (кроки 3, 5): ім'я, текст запису й q — через htmlspecialchars(); <b>Тарас</b> показується текстом |
1 |
bugs-forms.php (крок 10): прогноз до кожного надсилання, позначки вгадав / не вгадав: чому, три виправлення й читання полів через ??; вивід — як в «Очікуваному результаті» |
2 |
Коміт practice: guestbook search and new entry form |
1 |
| Разом | 10 |
Завдання з розділу «Додатково (*)» балів понад 10 не додає: воно може повернути до 2 балів, знятих за критеріями вище, але оцінка не перевищує 10.
Що здати
Посилання на коміт practice: guestbook search and new entry form з такими файлами:
src/guestbook/functions.php;src/public/guestbook/index.php,src/public/guestbook/style.css;src/public/bugs-forms.php.
Або архів, якщо так домовлено на занятті. Будьте готові пояснити, чому ?q=ОЛ знаходить Олену, що зламалося б з умовою if (mb_stripos(…)) без !== false і куди зникає новий запис, щойно сторінку відкрити знову.
Додатково (*)
- Пошук і в тексті запису. Нехай
filterEntries()знаходить запит не лише в імені, а й у тексті запису: друга умова зmb_stripos($entry['message'], $q)через||. Перевірте?q=docker: має знайтися запис Ірини, хоч в імені «docker» немає. Оновіть підпис поля пошуку й doc-коментар функції. - «Усі записи» і запит у підписі. Коли
$q !== '', покажіть біля підпису пошуку посилання «Усі записи» на/guestbook/, а в самому підписі — запит: «Знайдено 1 запис за запитом «ол»». Запит виводьте черезhtmlspecialchars()і перевірте адресою?q=<b>ол. - Фільтр за оцінкою. Додайте в ту саму GET-форму
<select name="min">«Оцінка від» з пунктами 1–5 і функціюfilterByRating(array $entries, int $min): array. Посилання сторінок мають зберігати іq, іmin— складіть$searchParamз обох параметрів.