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

Гостьова книга, крок 2: форма і сторінки циклами

Мета

Застосувати цикли у справжній сторінці: for з накопичувачем рядка, альтернативний синтаксис for (): … endfor; для HTML, що повторюється, умову всередині циклу і selected через тернарний оператор. Навчитися перевіряти межі циклу — перше й останнє значення лічильника — і знаходити в циклі зсув на одиницю, break замість continue та = замість ===.

Завдання

Продовжуємо проєкт із кроку 1 — практики «Гостьова книга, крок 1: сторінка, що ухвалює рішення». Сторінка http://localhost:8080/guestbook/ уже вітається за годиною, підписує кількість записів і показує демо-запис з оцінкою. Тепер вона отримує три частини, у яких той самий HTML повторюється кілька разів, — їх згенерують цикли:

  • зірки оцінки в демо-записі: ★ за кожен бал і ☆ до п'яти, тобто ★★★★☆ для оцінки 4;
  • навігацію сторінками «1 2 3 …»: на сторінці 5 записів, кількість записів, як і раніше, задає ?count=, а поточну сторінку — ?page= (за замовчуванням перша); поточна сторінка — без посилання, а коли сторінка одна, навігації немає зовсім;
  • форму нового запису: ім'я, текст і оцінка, варіанти якої від 1 до 5 згенеровано циклом, обрано 5.

Форма поки нічого не зберігає: вона надсилає дані методом POST, але index.php їх ще не читає — обробку форми додамо в модулі 10 «Форми: GET і POST». Справжніх записів теж ще немає, тож на кожній сторінці навігації той самий демо-запис. Теорія — у лекціях «Цикли for, while і do-while» і «break, continue і генерація HTML циклом».

Кроки

  1. Запустіть робочий проєкт intita-php (docker compose up -d) і відкрийте http://localhost:8080/guestbook/ — сторінка з кроку 1 має працювати. Цей крок змінює ті самі два файли, src/public/guestbook/index.php і src/public/guestbook/style.css; нових файлів у папці guestbook не буде.

  2. Допишіть у кінець style.css стилі для зірок, навігації і форми:

    .stars { color: #bf8700; letter-spacing: 2px; }
    .pages { display: flex; gap: 8px; margin: 16px 0; }
    .pages a, .pages .current { padding: 4px 10px; border: 1px solid #d0d7de; border-radius: 6px; text-decoration: none; }
    .pages a { background: #fff; color: #2b4c7e; }
    .pages .current { background: #2b4c7e; border-color: #2b4c7e; color: #fff; }
    .new-entry { margin-top: 16px; padding: 12px 16px; background: #fff; border: 1px solid #d0d7de; border-radius: 8px; }
    .new-entry h2 { margin: 0 0 8px; font-size: 18px; color: #2b4c7e; }
    .new-entry label { display: block; margin: 8px 0 4px; font-weight: 600; }
    .new-entry input, .new-entry textarea { box-sizing: border-box; width: 100%; padding: 6px 8px; font: inherit; border: 1px solid #d0d7de; border-radius: 6px; }
    .new-entry select { padding: 4px 8px; font: inherit; }
    .new-entry button { display: block; margin-top: 12px; padding: 8px 16px; font: inherit; color: #fff; background: #2b4c7e; border: 0; border-radius: 6px; cursor: pointer; }
    
  3. У index.php змініть коментар під <?php на // Гостьова книга, крок 2: форма і сторінки циклами. Під рядком з $entriesCount додайте вхідні дані сторінок — так само, як годину й кількість:

    // Сторінки: по 5 записів, поточна — з адресного рядка (?page=2), за замовчуванням 1
    $perPage = 5;
    $page = (int) ($_GET['page'] ?? 1);
    

    А після демо-запису, під коментарем // Оцінка, обрана у формі нового запису за замовчуванням, — $defaultRating = 5;. Кожен блок відділяйте від сусідніх порожнім рядком.

  4. Зірки. Наприкінці блоку PHP, після $ratingClass і перед ?>, під коментарем // Зірки оцінки: ★ за кожен бал, решта до п'яти — ☆ зберіть рядок зірок у змінній $stars. Накопичувач $stars = ""; оголосіть до циклу: усередині тіла він обнулявся б на кожній ітерації. Далі — цикл for з лічильником $star від 1 до 5 включно, а в тілі одна інструкція: .= дописує до $stars «★», якщо $star <= $entryRating, інакше «☆» — символ виберіть тернарним оператором. Символи ★ і ☆ скопіюйте з цього тексту: для PHP це звичайні рядки. Перевірте межі, як радить лекція в розділі «Зсув на одиницю»: перше значення лічильника — 1, останнє — 5, тож символів рівно п'ять.

  5. Кількість сторінок. Нижче, під коментарем // Кількість сторінок: неповна остання сторінка — теж сторінка, обчисліть $pagesCount. intdiv() знайомий з практики «Калькулятор замовлення», де він ділив суму на рівні платежі в цілих гривнях; тут intdiv($entriesCount, $perPage) дає кількість повних сторінок. Якщо ж остача $entriesCount % $perPage не дорівнює 0, лишаються записи ще на одну, неповну сторінку: додайте її через $pagesCount++ усередині if. Для 12 записів вийде дві повні сторінки і ще одна з двома записами — 3; для 5 записів — 1, для 0 — 0. Закрийте блок PHP тегом ?>.

  6. Зірки в HTML. У демо-записі на початок абзацу з оцінкою додайте <span class="stars"> зі значенням $stars і пробіл після нього, щоб браузер отримав <p class="rating rating-good"><span class="stars">★★★★☆</span> Оцінка: 4 — Добре</p>.

  7. Навігація. Після </article> додайте навігацію сторінками — альтернативним синтаксисом, як варіанти <option> у лекції «break, continue і генерація HTML циклом»:

    • уся навігація стоїть усередині <?php if ($pagesCount > 1): ?> … <?php endif; ?>: коли сторінка одна або записів немає, навігації немає зовсім;
    • у ній — <nav class="pages"> і цикл for (): … endfor; з лічильником $pageNumber від 1 до $pagesCount включно;
    • у тілі циклу — if (): … else: … endif;: поточна сторінка ($pageNumber === $page) — <span class="current"> з номером, без посилання, решта — посилання на кшталт <a href="?count=12&page=3">3</a>, де 12 — $entriesCount, а 3 — $pageNumber.

    Посилання передає й count: кількість записів поки задає адресний рядок, і без count= наступна сторінка відкрилася б із трьома записами за замовчуванням — а для них навігації вже немає. Адреса, що починається з ?, лишає той самий шлях /guestbook/ і змінює лише параметри.

  8. Форма нового запису. Після навігації, перед </main>, додайте <form class="new-entry" method="post"> — поля такі самі, як у лекції «HTML-форми»:

    • заголовок <h2>Новий запис</h2>;
    • <label for="name">Ім'я</label> і <input type="text" id="name" name="name" required>;
    • <label for="message">Текст запису</label> і <textarea id="message" name="message" rows="4" required></textarea>;
    • <label for="rating">Оцінка</label> і <select id="rating" name="rating">, а в ньому — варіанти від 1 до 5, згенеровані циклом for (): … endfor; з лічильником $value. Кожен варіант має вигляд <option value="3">3</option>, а той, що дорівнює $defaultRating, отримує ще selected — тернарним оператором прямо в <?= ?>, як у лекції: <option value="5" selected>5</option>;
    • кнопка <button type="submit">Додати запис</button>.

    $value — число з лічильника, а $defaultRating — число 5, тож строге === тут працює. Атрибут action не потрібен: без нього форма надсилає дані на ту саму адресу.

    Примітка

    Форма вже надсилає дані, але index.php їх поки не читає: після «Додати запис» сторінка просто відкриється знову, без нового запису. Приймати дані форми на сервері навчимося в модулі 10 «Форми: GET і POST».

  9. Відкрийте http://localhost:8080/guestbook/ — зі скісною рискою в кінці, як у кроці 1, — і перевірте адреси з таблиці в «Очікуваному результаті»: ?count=0, ?count=5, ?count=6, ?count=12&page=2, ?count=23&page=1, ?count=23&page=5. Клацніть номери сторінок: має змінюватися лише поточна сторінка, а кількість записів — лишатися тією самою. У коді сторінки (Ctrl+U) у <select> рівно п'ять <option>, і selected — лише в останнього. Тимчасово змініть $entryRating = 4; на 5, потім на 1 — зірки мають стати ★★★★★ і ★☆☆☆☆ (підпис і колір змінюються, як у кроці 1), — і поверніть 4. Нарешті заповніть форму й натисніть «Додати запис»: сторінка відкриється знову, без Warning, а в DevTools на вкладці Network з'явиться запит із методом POST.

  10. Спершу прогноз, потім запуск. Колега написав зірки й навігацію без шаблону, лише через echo. Для оцінки 4, трьох сторінок і поточної сторінки 2 код мав вивести ★★★★☆ і номери 1, 2, 3, де 1 і 3 — посилання, а 2 — жирним і без посилання. Але в ньому три помилки. Створіть тренувальний файл src/public/bugs-loops.php — не в папці guestbook: це вправа, а не частина книги, і наступні кроки його не змінюють.

    <?php
    $rating = 4;      // оцінка запису
    $pagesCount = 3;  // 12 записів по 5 на сторінці
    $page = 2;        // поточна сторінка
    
    $stars = "";
    for ($star = 0; $star <= 5; $star++) {
        $stars .= $star <= $rating ? "★" : "☆";
    }
    echo "<p>$stars</p>\n";
    
    echo "<p>";
    for ($pageNumber = 1; $pageNumber <= $pagesCount; $pageNumber++) {
        if ($page = $pageNumber) {
            echo "<strong>$pageNumber</strong> ";
            break;
        }
        echo "<a href=\"?page=$pageNumber\">$pageNumber</a> ";
    }
    echo "</p>\n";
    

    Перед запуском допишіть у кінці файлу два коментарі-прогнози, // прогноз, зірки: … і // прогноз, сторінки: …: що, на вашу думку, виведе кожен абзац. Потім відкрийте http://localhost:8080/bugs-loops.php і подивіться і на сторінку, і на її код (Ctrl+U). PHP не повідомить про жодну з помилок — ні Warning, ні Fatal error не буде: помилки видно лише з того, що вивели цикли. Біля кожного прогнозу допишіть // вгадав або // не вгадав: чому …, як у практиці кроку 1. Тоді виправте всі три помилки, кожну в одному рядку, — як радять лекції модуля в розділах про зсув на одиницю, break і continue, — щоб код сторінки збігся з «Очікуваним результатом».

  11. Зробіть коміт: git add src/public/guestbook src/public/bugs-loops.php і git commit -m "practice: guestbook entry form, rating stars and pagination".

Порада

Важливо

У index.php — лише строгі порівняння: ===, !==, <, <=, >, >=. Нестроге == у своєму коді не використовуйте, а = в умові — це присвоєння, а не порівняння.

Очікуваний результат

Сторінка http://localhost:8080/guestbook/?hour=9&count=12&page=2:

Навігація для адрес із кроку 9 (жирним — поточна сторінка, вона без посилання):

Адреса Навігація
/guestbook/ немає: 3 записи вміщуються на одну сторінку
/guestbook/?count=0 немає
/guestbook/?count=5 немає
/guestbook/?count=6 1 2
/guestbook/?count=12&page=2 1 2 3
/guestbook/?count=23&page=1 1 2 3 4 5
/guestbook/?count=23&page=5 1 2 3 4 5

Посилання зберігають кількість: на сторінці ?count=12&page=2 номер 3 веде на ?count=12&page=3.

Зірки демо-запису (крок 9):

$entryRating Зірки
5 ★★★★★
4 ★★★★☆
1 ★☆☆☆☆

На кожній адресі поле «Оцінка» має п'ять варіантів, від 1 до 5, і обрано 5. Після «Додати запис» сторінка така сама, як до надсилання: дані форми поки ніхто не читає. На жодній із цих сторінок немає Warning, Notice чи Fatal error.

Код сторінки bugs-loops.php до виправлень (Ctrl+U) — з ним звірте свій прогноз:

<p>★★★★★☆</p>
<p><strong>1</strong> </p>

Після виправлень:

<p>★★★★☆</p>
<p><a href="?page=1">1</a> <strong>2</strong> <a href="?page=3">3</a> </p>

Критерії оцінювання

Роботу оцінюють за 10-бальною шкалою:

Критерій Бали
Сторінка /guestbook/ збігається з «Очікуваним результатом» для адрес із кроку 9: зірки, навігація (поточна сторінка без посилання, посилання зберігають count, для однієї сторінки навігації немає), форма з п'ятьма варіантами оцінки, обрано 5 3
Цикли з кроків 4–8: зірки — for від 1 до 5 з накопичувачем $stars, оголошеним до циклу; кількість сторінок — intdiv() і %; навігація і варіанти <option> — for (): … endfor; в HTML; лише строгі порівняння 3
bugs-loops.php (крок 10): прогнози до запуску, позначки вгадав / не вгадав: чому, три виправлення, код сторінки як в «Очікуваному результаті» 2
Код охайний: зрозумілі імена в camelCase, коментар над кожним блоком PHP, у HTML-частині лише виведення, цикли й умови — альтернативним синтаксисом 1
Коміт practice: guestbook entry form, rating stars and pagination 1
Разом 10

Завдання з розділу «Додатково (*)» балів понад 10 не додає: воно може повернути до 2 балів, знятих за критеріями вище, але оцінка не перевищує 10.

Що здати

Посилання на коміт practice: guestbook entry form, rating stars and pagination з файлами src/public/guestbook/index.php, src/public/guestbook/style.css і src/public/bugs-loops.php (або архів, якщо так домовлено на занятті). Будьте готові відкрити сторінку з адресами, які назве викладач, і пояснити, скільки сторінок буде для 10 і для 11 записів.

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

  1. Показуйте форму лише тоді, коли книга відкрита: з $isOpen = false під червоним банером форми бути не має.
  2. Додайте до навігації посилання «←» на попередню сторінку і «→» на наступну: «←» — лише коли поточна сторінка не перша, «→» — коли не остання.
  3. Перепишіть зірки без циклу — двома викликами str_repeat() з лекції «break, continue і генерація HTML циклом». Що покаже кожен варіант, цикл і str_repeat(), для $entryRating = 7 — і чому?