Гостьова книга, крок 3: записи в масиві
Мета
Застосувати масиви у справжній сторінці: зберегти записи як індексний масив асоціативних масивів, вивести їх циклом foreach (): … endforeach;, порахувати через count(), array_column() і array_sum(), розвернути через array_reverse() і поділити на сторінки через array_slice(). Навчитися не довіряти параметру з адреси — обмежувати номер сторінки наявними сторінками — і знаходити типові помилки з масивами: опечатку в ключі, результат sort() у змінній і зсув на цілу сторінку.
Завдання
Продовжуємо проєкт із кроку 2 — практики «Гостьова книга, крок 2: форма і сторінки циклами». Досі сторінка http://localhost:8080/guestbook/ показувала один демо-запис, а кількість записів брала з ?count=. Тепер у книзі з'являються справжні записи — сім, у масиві $entries прямо в коді:
- кожен запис — асоціативний масив з полями
id,name,message,ratingіcreated_at(дата й час, як-от2026-09-14 10:15); у масиві записи стоять від найстаршого до найновішого; - сторінка показує їх від найновішого, по 5 на сторінці: кожен —
<article>з ім'ям, датою, текстом, зірками й підписом оцінки, як у кроках 1–2; - кількість рахує
count(), а поруч — середня оцінка з одним знаком після коми: «7 записів, середня оцінка 3,9»; параметр?count=більше не потрібен; - номер сторінки з
?page=обмежено наявними сторінками:?page=0,?page=99і?page=abcпоказують крайню сторінку без жодного попередження.
Записи поки живуть у коді: форма надсилає дані, але приймати їх навчимося в модулі 10 «Форми: GET і POST», а зберігати між запитами — у модулях 12–13. Теорія — у лекціях «Масиви: індексні й асоціативні» і «foreach і функції масивів».
Кроки
-
Запустіть робочий проєкт
intita-php(docker compose up -d) і відкрийтеhttp://localhost:8080/guestbook/— сторінка з кроку 2 має працювати. Майже вся робота цього кроку — уsrc/public/guestbook/index.php; уsrc/public/guestbook/style.cssлише дві дрібні зміни, а нових файлів у папціguestbookне буде. -
Стилі. Записів на сторінці тепер кілька, і без відступу картки злиплися б. У
style.cssу правилі.entryдопишіть перед}margin-bottom: 12px;, а в кінець файлу додайте стиль дати запису:.date { margin: 0; color: #57606a; font-size: 14px; } -
Масив записів. У
index.phpзмініть коментар під<?phpна// Гостьова книга, крок 3: записи в масиві. Видаліть блок// Кількість записів: з адресного рядка …разом із рядком$entriesCount = …і блок// Демо-записз трьома змінними. На місце демо-запису, після$isOpen, вставте записи книги:// Записи книги: від найстаршого до найновішого, новий запис стане в кінець $entries = [ [ 'id' => 1, 'name' => "Олена", 'message' => "Дуже корисне заняття! Нарешті зрозуміла, що таке DOM.", 'rating' => 4, 'created_at' => "2026-09-14 10:15", ], [ 'id' => 2, 'name' => "Андрій", 'message' => "Зробив свою першу сторінку на PHP, і вона запрацювала з першого разу!", 'rating' => 5, 'created_at' => "2026-09-16 19:40", ], [ 'id' => 3, 'name' => "Марія", 'message' => "Цікаво, але темп швидкий: розбиралася з циклами весь вечір.", 'rating' => 3, 'created_at' => "2026-09-21 08:05", ], [ 'id' => 4, 'name' => "Тарас", 'message' => "Гостьова книга — чудова ідея, хочу таку саму для свого сайту.", 'rating' => 5, 'created_at' => "2026-09-25 17:30", ], [ 'id' => 5, 'name' => "Ірина", 'message' => "Docker так і не запустився з першого разу. Хотілося б більше прикладів.", 'rating' => 2, 'created_at' => "2026-09-28 21:10", ], [ 'id' => 6, 'name' => "Богдан", 'message' => "Масиви виявилися простішими, ніж я думав.", 'rating' => 4, 'created_at' => "2026-10-01 12:45", ], [ 'id' => 7, 'name' => "Софія", 'message' => "Дякую за заняття! Найкорисніше — розбір помилок.", 'rating' => 4, 'created_at' => "2026-10-03 09:20", ], ];Це індексний масив асоціативних масивів, як
$productsу лекції «Масиви: індексні й асоціативні»: індекс — номер запису, ключ — назва поля. Перший запис — демо-запис із кроків 1–2. Записи стоять від найстаршого, тож новий запис додаватиметься в кінець через$entries[] = …. Полеidпоки ніде не показується: воно знадобиться, щоб видаляти записи й зберігати їх у базі даних. -
Кількість. Одразу під масивом, під коментарем
// Кількість записів — з масиву, а не з адресного рядка, напишіть$entriesCount = count($entries);. Форма слова «запис» і кількість сторінок, як і раніше, рахуються з$entriesCount— змінюється лише джерело числа.count()рахує записи верхнього рівня: 7, а не 35 значень у них. -
Середня оцінка. Після блоку банера, під коментарем
// Середня оцінка: …, обчисліть$averageRating.array_column($entries, 'rating')дістає оцінки всіх записів,array_sum()додає їх, а суму поділіть на$entriesCount. Для порожньої книги таке ділення зупинило б сторінку зFatal error: Uncaught DivisionByZeroError: Division by zero. Тому вибирайте тернарним оператором: якщо$entriesCount > 0— ділення, інакше — 0. -
Межі сторінки. Блок
$pagesCountіз кроку 2 не змінюється. Під ним, під коментарем// Поточна сторінка — від 1 до останньої: …, обмежте$pageдвома окремимиif:- спершу верхню межу: якщо
$page > $pagesCount, то$page = $pagesCount;; - потім нижню: якщо
$page < 1, то$page = 1;.
Для
?page=abc(int)уже дав 0 без попередження, тож спрацює нижня межа. Порядок важливий: у порожній книзі$pagesCountдорівнює 0, верхня межа перетворює сторінку 1 на 0, і лише нижня межа, перевірена останньою, повертає 1. - спершу верхню межу: якщо
-
Записи сторінки. Нижче, під коментарем
// Записи сторінки: …, розверніть масив і виріжте з нього сторінку:$newestFirst = array_reverse($entries); $pageEntries = array_slice($newestFirst, ($page - 1) * $perPage, $perPage);- зсув — це індекс, а індекси починаються з 0: сторінка 1 починається з індексу 0, сторінка 2 — з індексу 5;
- на останній сторінці записів менше, ніж
$perPage, іarray_slice()поверне скільки є — тут два; array_reverse()повертає новий масив, тож$entriesлишається від найстаршого.
-
Оцінка кожного запису. Блоки
// Підпис і CSS-клас оцінкиі// Зірки оцінкиз кроків 1–2 рахували оцінку єдиного демо-запису — видаліть їх зі старого місця. Тепер те саме потрібно для кожного запису сторінки. Наприкінці блоку PHP, перед?>, під коментарем із двох рядків —// Зірки, підпис і CSS-клас оцінки — для кожного запису сторінки.і// $entry — копія запису, тому результат пишемо в сам масив за ключем $i— напишіть циклforeach ($pageEntries as $i => $entry) { … }і перенесіть у нього обидва блоки:- накопичувач
$stars = "";— усерединіforeach, але передfor: у кожного запису свої зірки, і без обнулення зірки наступного запису дописалися б до попередніх; - у
forі в обохmatchзамість$entryRating—$entry['rating']; - результат записуйте в сам масив за ключем:
$pageEntries[$i]['stars'] = $stars;, а підпис і назву стилю — у$pageEntries[$i]['ratingLabel'] = match ($entry['rating']) { … };і$pageEntries[$i]['ratingClass'] = ….
Чому не
$entry['stars'] = …: змінна післяas— копія запису (WARNING у лекції «foreach і функції масивів»). Масив$pageEntriesлишився б без нових ключів, а шаблон показав биWarning: Undefined array key "stars". - накопичувач
-
Шаблон. У HTML-частині:
- у
<p class="count">після слова допишіть, середня оцінкаі саму середню з одним знаком після коми:<?= number_format($averageRating, 1, ',', '') ?>. Вбудована функціяnumber_format(число, знаків, роздільник дробу, роздільник тисяч)округлює до вказаної кількості знаків і повертає рядок рівно з ними:number_format(27 / 7, 1, ',', '')дає3,9.round()з лекції «Оператори: арифметика, порівняння, логіка» дав би3.9з крапкою, а для середньої 4 — просто4, без знака після коми; - демо-запис замініть циклом
<?php foreach ($pageEntries as $entry): ?> … <?php endforeach; ?>. Усередині — той самий<article class="entry">, але з полями запису:<h2>з$entry['name'], під ним новий<p class="date">з$entry['created_at'], далі<p>з$entry['message']і<p class="rating …">, де замість змінних демо-запису —$entry['ratingClass'],$entry['stars'],$entry['rating']і$entry['ratingLabel']; - у посиланні навігації приберіть
count=: тепер це<a href="?page=2">2</a>, бо кількість записів сторінка знає сама.
У HTML-частині — лише виведення: усе обчислено в блоці PHP.
- у
-
Відкрийте
http://localhost:8080/guestbook/і перевірте адреси з таблиці в «Очікуваному результаті»:?page=2,?page=0,?page=99,?page=abc.- У коді сторінки (
Ctrl+U) на першій сторінці рівно п'ять<article>, на другій — два, і на жодній немаєWarning. - Порахуйте середню вручну: (4 + 5 + 3 + 5 + 2 + 4 + 4) / 7 = 27 / 7 ≈ 3,857, з одним знаком — 3,9.
- Тимчасово додайте під масивом рядок
$entries = [];. Сторінка має показати «Записів ще немає» — без записів, без навігації і безFatal error. Потім видаліть цей рядок.
- У коді сторінки (
-
Спершу прогноз, потім запуск. Колега вирішив показати першу сторінку записів з оцінками, по два записи на сторінці, а під нею — усіх авторів за абеткою. Мало вийти
Тарас: 5,Олена: 4іАндрій, Марія, Олена, Тарас, але в коді три помилки. Створіть тренувальний файлsrc/public/bugs-arrays.php— не в папціguestbook: це вправа, а не частина книги.<?php $entries = [ ['name' => "Тарас", 'rating' => 5], ['name' => "Олена", 'rating' => 4], ['name' => "Марія", 'rating' => 3], ['name' => "Андрій", 'rating' => 5], ]; $perPage = 2; // записів на сторінці $page = 1; // перша сторінка // Перша сторінка: записи з оцінками $pageEntries = array_slice($entries, $page * $perPage, $perPage); foreach ($pageEntries as $entry) { echo "<p>", $entry['name'], ": ", $entry['raiting'], "</p>\n"; } // Усі автори за абеткою $names = array_column($entries, 'name'); $sorted = sort($names); echo "<p>", implode(", ", $sorted), "</p>\n";Перед запуском допишіть у кінці файлу два коментарі-прогнози:
// прогноз, сторінка: …і// прогноз, автори: …. У кінці файлу вони не зсувають номери рядків у повідомленнях PHP. Потім відкрийтеhttp://localhost:8080/bugs-arrays.php: цього разу PHP повідомить про дві помилки з трьох, а третю видно лише з того, які записи потрапили на сторінку. Біля кожного прогнозу допишіть// вгадавабо// не вгадав: чому …, як у практиці кроку 2. Тоді виправте всі три помилки — як радять лекції модуля в розділах про відсутній ключ, сортування і зріз, — щоб код сторінки збігся з «Очікуваним результатом». -
Зробіть коміт:
git add src/public/guestbook src/public/bugs-arrays.phpіgit commit -m "practice: guestbook entries array with pagination and average rating".
Порада
Документація PHP: foreach, array_reverse, array_slice, array_column, number_format.
Важливо
У index.php — лише строгі порівняння: ===, !==, <, <=, >, >=. Нестроге == у своєму коді не використовуйте.
Очікуваний результат
Сторінка http://localhost:8080/guestbook/?hour=9 — перша сторінка, п'ять найновіших записів:
Сторінки для адрес із кроку 10 (жирним — поточна сторінка, вона без посилання):
| Адреса | Записи на сторінці | Навігація |
|---|---|---|
/guestbook/ |
Софія, Богдан, Ірина, Тарас, Марія | 1 2 |
/guestbook/?page=2 |
Андрій, Олена | 1 2 |
/guestbook/?page=0 |
Софія, Богдан, Ірина, Тарас, Марія | 1 2 |
/guestbook/?page=99 |
Андрій, Олена | 1 2 |
/guestbook/?page=abc |
Софія, Богдан, Ірина, Тарас, Марія | 1 2 |
- На кожній адресі над записами — «7 записів, середня оцінка 3,9», а посилання навігації ведуть на
?page=1і?page=2. - На другій сторінці: Андрій — ★★★★★ «Оцінка: 5 — Чудово», Олена — ★★★★☆ «Оцінка: 4 — Добре».
- З тимчасовим
$entries = [];— лише «Записів ще немає» і форма, без записів і навігації. - На жодній із цих сторінок немає
Warning,NoticeчиFatal error.
Сторінка bugs-arrays.php до виправлень — з нею звірте свій прогноз:
Марія:
Warning: Undefined array key "raiting" in /var/www/html/public/bugs-arrays.php on line 14
Андрій:
Warning: Undefined array key "raiting" in /var/www/html/public/bugs-arrays.php on line 14
Fatal error: Uncaught TypeError: implode(): Argument #2 ($array) must be of type ?array, true given in /var/www/html/public/bugs-arrays.php:20
Stack trace:
#0 /var/www/html/public/bugs-arrays.php(20): implode(', ', true)
#1 {main}
thrown in /var/www/html/public/bugs-arrays.php on line 20
Код сторінки після виправлень (Ctrl+U):
<p>Тарас: 5</p>
<p>Олена: 4</p>
<p>Андрій, Марія, Олена, Тарас</p>
Критерії оцінювання
Роботу оцінюють за 10-бальною шкалою:
| Критерій | Бали |
|---|---|
Сторінка /guestbook/ збігається з «Очікуваним результатом» для адрес із кроку 10: сім записів від найновішого, по 5 на сторінці, зірки й підписи оцінок, «7 записів, середня оцінка 3,9», для ?page=0, ?page=99 і ?page=abc — крайня сторінка без попереджень |
3 |
Масиви з кроків 3–9: записи — індексний масив асоціативних масивів; count(); середня через array_column() і array_sum() без ділення на 0; array_reverse() і array_slice() зі зсувом ($page - 1) * $perPage; межі $page; результат у foreach записано в масив за ключем; лише строгі порівняння |
3 |
bugs-arrays.php (крок 11): прогнози до запуску, позначки вгадав / не вгадав: чому, три виправлення, код сторінки як в «Очікуваному результаті» |
2 |
Код охайний: зрозумілі імена в camelCase, коментар над кожним блоком PHP, у HTML-частині лише виведення, цикли й умови — альтернативним синтаксисом (foreach (): … endforeach;) |
1 |
Коміт practice: guestbook entries array with pagination and average rating |
1 |
| Разом | 10 |
Завдання з розділу «Додатково (*)» балів понад 10 не додає: воно може повернути до 2 балів, знятих за критеріями вище, але оцінка не перевищує 10.
Що здати
Посилання на коміт practice: guestbook entries array with pagination and average rating з файлами src/public/guestbook/index.php, src/public/guestbook/style.css і src/public/bugs-arrays.php (або архів, якщо так домовлено на занятті). Будьте готові відкрити сторінки, які назве викладач, і пояснити, які записи опиняться на сторінці 2, якщо в кінець масиву додати восьмий запис.
Додатково (*)
- Фільтр за оцінкою:
?rating=5показує лише записи з цією оцінкою — новий масив збирайте вforeachчерез$filtered[] = $entry. Кількість, середня й навігація мають рахувати лише відфільтровані записи, а посилання сторінок — зберігатиrating. - Розподіл оцінок: під підписом кількості покажіть, скільки записів має кожну оцінку від 5 до 1. Знадобиться масив-лічильник з ключами 5…1 і
foreach. - Додайте восьмий запис через
$entries[] = [...]одразу під масивом. Скільки тепер сторінок, які записи на другій і якою стала середня? Спершу порахуйте на папері, потім перевірте на сторінці.