Перейти до змісту
Intita
Практика · 45 хв · Макс. бал: 10

Гостьова книга, крок 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-форму нового запису: запис з id 8 і поточним часом з'являється нагорі, а підпис над записами — «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 «Валідація та безпека введення».

Кроки

  1. Старт і запит пошуку. Запустіть робочий проєкт 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 сторінка отримує порожній рядок. Порожній запит означає, що пошуку немає.
  2. Функція 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().
  3. Пошук на сторінці. В 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.

  4. Сторінки пам'ятають пошук. Знайдіть а: «Знайдено 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() перетворює & на &amp; — так & записують усередині HTML-атрибута, а браузер читає його назад як &.
    • Без пошуку $searchParam порожній, і посилання лишаються ?page=2, як у кроці 4.

    Перевірте: на ?q=а посилання «2» веде на ?page=2&q=а, і там — Олена, шостий знайдений запис.

  5. Екранування записів. Досі імена й тексти записів писали ви самі в 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 «Валідація та безпека введення».

  6. Обробка 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 «Валідація та безпека введення».
  7. Повідомлення, адреса форми і 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 прокручує сторінку до запису Софії.

  8. Стилі. Допишіть у кінець 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; }
    
  9. Перевірка. У браузері додайте запис: ім'я «Тарас», текст «Привіт усім», оцінка 4. Має з'явитися повідомлення, підпис «8 записів, середня оцінка 3,9», а першим — новий запис Тараса з поточним часом.

    • Ctrl+U: у коді сторінки — id="entry-8" і ваш поточний час.
    • DevTools → Network → запит guestbook/ → Payload: розділ Form Data з name, message і rating.
    • Клацніть посилання в повідомленні: знову 7 записів, Тараса з id 8 немає.
    • Додайте запис ще раз і натисніть F5. Браузер спитає, чи надіслати дані форми повторно; погодьтеся — запис знову з id 8, а не 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.

  10. Спершу прогноз, потім запуск. Колега зробив чернетку обробки форми нового запису. Після надсилання форми з ім'ям «Олена», текстом «Дуже корисно» й оцінкою 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
    
  11. Зробіть коміт: 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», без Тараса з id 8.

Вивід трьох команд curl з кроку 9 (відступи — з шаблону, час — ваш):

                            <article class="entry" id="entry-8">
                <h2>Тарас</h2>
                <p class="date">2026-10-04 22:59</p>
                <h2>&lt;b&gt;Тарас&lt;/b&gt;</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 і куди зникає новий запис, щойно сторінку відкрити знову.

Додатково (*)

  1. Пошук і в тексті запису. Нехай filterEntries() знаходить запит не лише в імені, а й у тексті запису: друга умова з mb_stripos($entry['message'], $q) через ||. Перевірте ?q=docker: має знайтися запис Ірини, хоч в імені «docker» немає. Оновіть підпис поля пошуку й doc-коментар функції.
  2. «Усі записи» і запит у підписі. Коли $q !== '', покажіть біля підпису пошуку посилання «Усі записи» на /guestbook/, а в самому підписі — запит: «Знайдено 1 запис за запитом «ол»». Запит виводьте через htmlspecialchars() і перевірте адресою ?q=<b>ол.
  3. Фільтр за оцінкою. Додайте в ту саму GET-форму <select name="min"> «Оцінка від» з пунктами 1–5 і функцію filterByRating(array $entries, int $min): array. Посилання сторінок мають зберігати і q, і min — складіть $searchParam з обох параметрів.