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

Гостьова книга, крок 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 і функції масивів».

Кроки

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

  2. Стилі. Записів на сторінці тепер кілька, і без відступу картки злиплися б. У style.css у правилі .entry допишіть перед } margin-bottom: 12px;, а в кінець файлу додайте стиль дати запису:

    .date { margin: 0; color: #57606a; font-size: 14px; }
    
  3. Масив записів. У 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 поки ніде не показується: воно знадобиться, щоб видаляти записи й зберігати їх у базі даних.

  4. Кількість. Одразу під масивом, під коментарем // Кількість записів — з масиву, а не з адресного рядка, напишіть $entriesCount = count($entries);. Форма слова «запис» і кількість сторінок, як і раніше, рахуються з $entriesCount — змінюється лише джерело числа. count() рахує записи верхнього рівня: 7, а не 35 значень у них.

  5. Середня оцінка. Після блоку банера, під коментарем // Середня оцінка: …, обчисліть $averageRating. array_column($entries, 'rating') дістає оцінки всіх записів, array_sum() додає їх, а суму поділіть на $entriesCount. Для порожньої книги таке ділення зупинило б сторінку з Fatal error: Uncaught DivisionByZeroError: Division by zero. Тому вибирайте тернарним оператором: якщо $entriesCount > 0 — ділення, інакше — 0.

  6. Межі сторінки. Блок $pagesCount із кроку 2 не змінюється. Під ним, під коментарем // Поточна сторінка — від 1 до останньої: …, обмежте $page двома окремими if:

    • спершу верхню межу: якщо $page > $pagesCount, то $page = $pagesCount;;
    • потім нижню: якщо $page < 1, то $page = 1;.

    Для ?page=abc (int) уже дав 0 без попередження, тож спрацює нижня межа. Порядок важливий: у порожній книзі $pagesCount дорівнює 0, верхня межа перетворює сторінку 1 на 0, і лише нижня межа, перевірена останньою, повертає 1.

  7. Записи сторінки. Нижче, під коментарем // Записи сторінки: …, розверніть масив і виріжте з нього сторінку:

    $newestFirst = array_reverse($entries);
    $pageEntries = array_slice($newestFirst, ($page - 1) * $perPage, $perPage);
    
    • зсув — це індекс, а індекси починаються з 0: сторінка 1 починається з індексу 0, сторінка 2 — з індексу 5;
    • на останній сторінці записів менше, ніж $perPage, і array_slice() поверне скільки є — тут два;
    • array_reverse() повертає новий масив, тож $entries лишається від найстаршого.
  8. Оцінка кожного запису. Блоки // Підпис і 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".

  9. Шаблон. У 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.

  10. Відкрийте 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. Потім видаліть цей рядок.
  11. Спершу прогноз, потім запуск. Колега вирішив показати першу сторінку записів з оцінками, по два записи на сторінці, а під нею — усіх авторів за абеткою. Мало вийти Тарас: 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. Тоді виправте всі три помилки — як радять лекції модуля в розділах про відсутній ключ, сортування і зріз, — щоб код сторінки збігся з «Очікуваним результатом».

  12. Зробіть коміт: 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, якщо в кінець масиву додати восьмий запис.

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

  1. Фільтр за оцінкою: ?rating=5 показує лише записи з цією оцінкою — новий масив збирайте в foreach через $filtered[] = $entry. Кількість, середня й навігація мають рахувати лише відфільтровані записи, а посилання сторінок — зберігати rating.
  2. Розподіл оцінок: під підписом кількості покажіть, скільки записів має кожну оцінку від 5 до 1. Знадобиться масив-лічильник з ключами 5…1 і foreach.
  3. Додайте восьмий запис через $entries[] = [...] одразу під масивом. Скільки тепер сторінок, які записи на другій і якою стала середня? Спершу порахуйте на папері, потім перевірте на сторінці.