Гостьова книга, крок 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 циклом».
Кроки
-
Запустіть робочий проєкт
intita-php(docker compose up -d) і відкрийтеhttp://localhost:8080/guestbook/— сторінка з кроку 1 має працювати. Цей крок змінює ті самі два файли,src/public/guestbook/index.phpіsrc/public/guestbook/style.css; нових файлів у папціguestbookне буде. -
Допишіть у кінець
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; } -
У
index.phpзмініть коментар під<?phpна// Гостьова книга, крок 2: форма і сторінки циклами. Під рядком з$entriesCountдодайте вхідні дані сторінок — так само, як годину й кількість:// Сторінки: по 5 записів, поточна — з адресного рядка (?page=2), за замовчуванням 1 $perPage = 5; $page = (int) ($_GET['page'] ?? 1);А після демо-запису, під коментарем
// Оцінка, обрана у формі нового запису за замовчуванням, —$defaultRating = 5;. Кожен блок відділяйте від сусідніх порожнім рядком. -
Зірки. Наприкінці блоку PHP, після
$ratingClassі перед?>, під коментарем// Зірки оцінки: ★ за кожен бал, решта до п'яти — ☆зберіть рядок зірок у змінній$stars. Накопичувач$stars = "";оголосіть до циклу: усередині тіла він обнулявся б на кожній ітерації. Далі — циклforз лічильником$starвід 1 до 5 включно, а в тілі одна інструкція:.=дописує до$stars«★», якщо$star <= $entryRating, інакше «☆» — символ виберіть тернарним оператором. Символи ★ і ☆ скопіюйте з цього тексту: для PHP це звичайні рядки. Перевірте межі, як радить лекція в розділі «Зсув на одиницю»: перше значення лічильника — 1, останнє — 5, тож символів рівно п'ять. -
Кількість сторінок. Нижче, під коментарем
// Кількість сторінок: неповна остання сторінка — теж сторінка, обчисліть$pagesCount.intdiv()знайомий з практики «Калькулятор замовлення», де він ділив суму на рівні платежі в цілих гривнях; тутintdiv($entriesCount, $perPage)дає кількість повних сторінок. Якщо ж остача$entriesCount % $perPageне дорівнює 0, лишаються записи ще на одну, неповну сторінку: додайте її через$pagesCount++усерединіif. Для 12 записів вийде дві повні сторінки і ще одна з двома записами — 3; для 5 записів — 1, для 0 — 0. Закрийте блок PHP тегом?>. -
Зірки в HTML. У демо-записі на початок абзацу з оцінкою додайте
<span class="stars">зі значенням$starsі пробіл після нього, щоб браузер отримав<p class="rating rating-good"><span class="stars">★★★★☆</span> Оцінка: 4 — Добре</p>. -
Навігація. Після
</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/і змінює лише параметри. - уся навігація стоїть усередині
-
Форма нового запису. Після навігації, перед
</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». - заголовок
-
Відкрийте
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. -
Спершу прогноз, потім запуск. Колега написав зірки й навігацію без шаблону, лише через
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, — щоб код сторінки збігся з «Очікуваним результатом». -
Зробіть коміт:
git add src/public/guestbook src/public/bugs-loops.phpіgit commit -m "practice: guestbook entry form, rating stars and pagination".
Порада
Документація PHP: for, альтернативний синтаксис, continue, intdiv.
Важливо
У 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 записів.
Додатково (*)
- Показуйте форму лише тоді, коли книга відкрита: з
$isOpen = falseпід червоним банером форми бути не має. - Додайте до навігації посилання «←» на попередню сторінку і «→» на наступну: «←» — лише коли поточна сторінка не перша, «→» — коли не остання.
- Перепишіть зірки без циклу — двома викликами
str_repeat()з лекції «break, continue і генерація HTML циклом». Що покаже кожен варіант, цикл іstr_repeat(), для$entryRating = 7— і чому?