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

Гостьова книга, крок 8: записи у файлі JSON

Мета

Зробити записи гостьової книги спільними для всіх відвідувачів. Записи переїжджають із сесії у файл src/storage/entries.json поза веб-коренем. Новий файл storage.php читає їх через json_decode() і записує через json_encode() і file_put_contents() з LOCK_EX. Файл лишається читабельним — з відступами й кирилицею літерами, — а вебсервер його не віддає. У сесії лишаються flash-повідомлення і вхід модератора. Знаходити типові помилки роботи з файлами й JSON: json_decode() без true, FILE_APPEND під час збереження всього масиву і відносний шлях замість __DIR__.

Завдання

Продовжуємо проєкт із кроку 7 — практики «Гостьова книга, крок 7: сесія, cookie і вхід модератора». Книга вже пам'ятає записи, але в кожного браузера вони свої: запис, доданий в одному браузері, інший не бачить, а з новою сесією додані записи зникають. У цьому кроці записи переїдуть у файл на сервері — один для всіх.

Має вийти:

  • каталог src/storage/ поза веб-коренем з порожнім файлом .gitkeep, а в .gitignore — рядок src/storage/*.json: файл даних живе на сервері, але не в репозиторії;
  • src/guestbook/storage.php з функціями loadEntries(), saveEntries(), addEntry() і deleteEntry(). Записи лежать у src/storage/entries.json: на першому візиті туди потрапляють сім записів із data.php. Файл — JSON з відступами й кирилицею літерами;
  • index.php бере записи з файлу й додає туди нові, а delete.php видаляє запис із файлу. У сесії лишаються лише flash-повідомлення і вхід модератора;
  • запис, доданий в одному браузері, бачить інший браузер, а за адресою http://localhost:8080/storage/entries.json записів не видно.
intita-php/
├── .gitignore                ← рядок src/storage/*.json
└── src/
    ├── guestbook/
    │   ├── config.php
    │   ├── data.php
    │   ├── functions.php
    │   ├── storage.php       ← нове: читання й запис файлу JSON
    │   └── templates/
    │       ├── header.php
    │       └── footer.php
    ├── storage/              ← нове: дані, які пише PHP
    │   ├── .gitkeep
    │   └── entries.json      ← з'явиться на першому візиті, у git не потрапить
    └── public/
        ├── bugs-json.php     ← нове: вправа «Знайди помилку»
        ├── api/
        │   └── bugs-json.php ← нове: вправа «Знайди помилку»
        └── guestbook/
            ├── index.php     ← записи з файлу
            ├── delete.php    ← видалення з файлу
            ├── logout.php    ← новий коментар
            ├── login.php
            └── style.css

Теорія — у лекціях «Файли: читання й запис» і «JSON: json_encode і json_decode». Файл JSON — не остання зупинка записів: у модулі 14 «Бази даних і SQL» вони переїдуть у таблицю бази даних.

Кроки

  1. Старт: у кожного браузера свої записи. Запустіть робочий проєкт intita-php (docker compose up -d) і відкрийте http://localhost:8080/guestbook/ у двох браузерах — або у звичайному й приватному вікні: у приватного вікна свої cookie, а отже, й своя сесія. Додайте в першому запис «Тарас» / «Привіт усім» / 4: він нагорі. У другому після F5 — сім записів без Тараса: записи кроку 7 живуть у сесії, а сесія в кожного браузера своя. Щоб записи бачили всі, сервер має тримати їх в одному місці — у файлі. В index.php замініть коментар під declare на // Гостьова книга, крок 8: записи у файлі JSON.

  2. Каталог для даних. Створіть у проєкті каталог src/storage/ — поруч із src/guestbook/ і src/public/ — в IDE чи командою mkdir src/storage. Якщо він уже є з лекції «Файли: читання й запис», залиште його. Додайте в нього порожній файл .gitkeep, а в кінець .gitignore у корені проєкту допишіть рядок:

    src/storage/*.json
    
    • Файл даних лежить поза веб-коренем, як радить розділ «Поза веб-коренем» лекції: nginx віддає лише вміст src/public/, а PHP читає й пише файли будь-де.
    • entries.json пише PHP, поки сайт працює: це дані, а не код, і в кожної копії проєкту вони свої. Рядок у .gitignore каже git не помічати жодного файлу .json у src/storage/.
    • Порожніх каталогів git не зберігає. Без .gitkeep після git clone каталогу src/storage/ не було б, і запис закінчився б No such file or directory: файл file_put_contents() створює, а каталог — ні. .gitkeep — звичайний порожній файл; таке ім'я дають файлу, який тримає каталог у репозиторії.
    • На Linux каталог має належати користувачу з тим самим номером, що й app у контейнері php, інакше запис дасть Permission denied — розділ «Хто має право писати» лекції.
  3. storage.php: читання і запис. Створіть src/guestbook/storage.php — поруч із functions.php:

    <?php
    declare(strict_types=1);
    
    // Сховище записів гостьової книги: файл JSON поза веб-коренем, src/storage/entries.json.
    // Лише оголошення функцій — без викликів і виводу
    
    // nextId() для нового запису — з functions.php
    require_once __DIR__ . '/functions.php';
    
    /**
     * Шлях до файлу записів — від __DIR__, тож він однаковий для будь-якої сторінки, що підключила цей файл.
     */
    function entriesPath(): string
    {
        return __DIR__ . '/../storage/entries.json';
    }
    
    /**
     * Усі записи книги, від найстаршого до найновішого. Файлу ще немає — записи з data.php, і з них створюється файл.
     */
    function loadEntries(): array
    {
        $path = entriesPath();
        if (!file_exists($path)) {
            $entries = require __DIR__ . '/data.php';
            saveEntries($entries);
            return $entries;
        }
        // true — асоціативні масиви, а не об'єкти; зламаний файл зупинить сторінку, а не обнулить книгу
        return json_decode(file_get_contents($path), true, 512, JSON_THROW_ON_ERROR);
    }
    
    /**
     * Записати всі записи у файл: кирилиця — літерами, з відступами, щоб файл читала й людина.
     */
    function saveEntries(array $entries): void
    {
        $json = json_encode($entries, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR);
        // Файл перезаписується цілим; LOCK_EX — поки цей запит пише файл, інші чекають
        file_put_contents(entriesPath(), $json, LOCK_EX);
    }
    
    • __DIR__ — каталог самого storage.php, тобто src/guestbook/; /../storage/ піднімає в src/ і веде в src/storage/. Відносний шлях без __DIR__ PHP рахував би від каталогу відкритої сторінки, src/public/guestbook/, як пояснює розділ «Запис і читання цілого файлу» лекції. Шлях потрібен і для читання, і для запису, тож він живе в одній функції — entriesPath().
    • Файлу ще немає — file_exists() дає false, і loadEntries() бере сім записів із data.php, як на першому візиті в кроці 7. saveEntries() одразу створює з них файл, тож далі книга читає лише його.
    • json_decode() з true повертає масив масивів — такі записи вміють обробляти всі функції з functions.php. Без true кожен запис став би об'єктом stdClass, і перший же $entry['name'] зупинив би сторінку. 512 — глибина вкладеності за замовчуванням: вона стоїть лише тому, що прапорці — четвертий аргумент.
    • JSON_THROW_ON_ERROR у json_decode(): зіпсований файл зупинить сторінку з JsonException, а не перетвориться тихо на null, після якого наступне збереження перезаписало б книгу одним записом (розділ «json_decode(): з JSON у масив» лекції).
    • saveEntries(): JSON_UNESCAPED_UNICODE лишає кирилицю літерами, JSON_PRETTY_PRINT ставить кожне поле на свій рядок — файл зручно читати в IDE. JSON_THROW_ON_ERROR зупинить скрипт ще до запису, якщо json_encode() не впорається, і старий файл лишиться цілим.
    • file_put_contents() без FILE_APPEND перезаписує файл цілим. JSON-масив у кінець не дописують: після ] почався б другий масив, і файл перестав би бути JSON. LOCK_EX ставить одночасні записи в чергу — розділ «Одночасний запис» лекції.
    • require_once на початку: addEntry() з наступного кроку рахує номер запису функцією nextId() з functions.php. Якщо сторінка вже підключила functions.php сама, require_once удруге його не підключить.
  4. addEntry() і deleteEntry(). Допишіть у кінець storage.php:

    /**
     * Новий запис у кінець книги. $entry — поля 'name', 'message', 'rating' і 'created_at'; id функція дає сама.
     */
    function addEntry(array $entry): void
    {
        // Прочитати → змінити → записати весь масив назад
        $entries = loadEntries();
        $entries[] = [
            'id' => nextId($entries),
            'name' => $entry['name'],
            'message' => $entry['message'],
            'rating' => $entry['rating'],
            'created_at' => $entry['created_at'],
        ];
        saveEntries($entries);
    }
    
    /**
     * Видалити запис з цим id: у файлі лишаються всі інші записи.
     */
    function deleteEntry(int $id): void
    {
        $kept = [];
        foreach (loadEntries() as $entry) {
            if ($entry['id'] !== $id) {
                $kept[] = $entry;
            }
        }
        saveEntries($kept);
    }
    
    • Обидві функції працюють за схемою «прочитати → змінити → записати» з лекції: читають увесь файл, змінюють масив і записують його назад цілим.
    • addEntry() отримує поля без id: номер рахує nextId() за записами, щойно прочитаними з файлу. Запис збирається поле за полем, тож у файлі в нього той самий порядок ключів, що й у записів із data.php, — спершу id.
    • deleteEntry() — той самий foreach з delete.php кроку 7, що лишає всі записи, крім запису з цим id, — але записи він читає з файлу й туди ж записує результат. Новий масив $kept нумерується з 0, тож у файлі знову буде JSON-масив […].
    • Числа JSON json_decode() повертає числами, тож $entry['id'] з файлу — int, і строге !== порівнює число з числом.
  5. index.php: записи з файлу. Під require_once з функціями підключіть сховище:

    // Записи книги у файлі JSON: loadEntries(), addEntry() — у src/guestbook/storage.php
    require_once __DIR__ . '/../../guestbook/storage.php';
    

    Блок, що клав записи в сесію, — коментар // Записи книги живуть у сесії цього браузера… і if (!isset($_SESSION['entries'])) { … } під ним — видаліть разом із порожнім рядком після нього. Коментар над блоком POST замініть таким:

    // Новий запис із POST-форми — лише якщо поля пройшли перевірку; у кінець файлу записів, тож на сторінці він перший
    

    А додавання в сесію — $_SESSION['entries'][] = [ … ]; разом із рядком 'id' => nextId(…) — замініть викликом:

            addEntry([
                'name' => $form['name'],
                'message' => $form['message'],
                'rating' => (int) $form['rating'],
                'created_at' => date('Y-m-d H:i'),
            ]);
    

    Під блоком POST рядки, що брали записи із сесії, — коментар // Записи для сторінки — із сесії… і $entries = $_SESSION['entries']; — замініть такими:

    // Записи для сторінки — з файлу, спільні для всіх браузерів, від найстаршого до найновішого;
    // у сесії лишаються лише flash і вхід модератора
    $entries = loadEntries();
    
    • Решта сторінки працює з $entries, як і раніше: пошук, сторінки, середня оцінка й шаблон не змінюються.
    • Решта блоку POST — cookie з ім'ям, flash «Запис додано» і перенаправлення 303 — та сама. Flash і далі чекає в сесії: це повідомлення лише для браузера, який додав запис.
    • session_start() лишається: сесія тримає flash і вхід модератора — те, що стосується одного браузера.
    • Перший GET викликає loadEntries(), і, поки файлу немає, той з'являється із сімома записами з data.php. Записи, які ви додавали в кроці 7, жили в сесіях і у файл не переїдуть.
  6. delete.php і logout.php. У delete.php під коментарем-заголовком підключіть сховище — до session_start(), як в index.php:

    // Записи книги у файлі JSON: deleteEntry() — у src/guestbook/storage.php
    require_once __DIR__ . '/../../guestbook/storage.php';
    

    У блоці POST усе, що стоїть перед $_SESSION['flash'] = 'Запис видалено';, — рядок $id = …, коментар, $kept = [];, foreach і $_SESSION['entries'] = $kept; — замініть одним викликом:

        // Запис зникає з файлу, а отже — з книги в кожному браузері
        deleteEntry((int) ($_POST['id'] ?? 0));
    
    • (int) робить число з рядка форми, як і в кроці 7: параметр deleteEntry() має тип int, і з declare(strict_types=1) рядок туди не пройде.
    • Перевірка входу не змінилася: видаляти може лише той, у чиїй сесії є позначка moderator.

    У logout.php коментар над unset() пояснює, що в сесії живуть записи, — тепер це неправда. Замініть його:

        // Забираємо лише позначку модератора: решта сесії лишається — у ній чекатиме flash «Ви вийшли»
    
  7. Перевірка. Видаліть src/storage/entries.json, якщо він з'явився, поки ви редагували код: перевірка починається з першого візиту. Далі в браузерах:

    • відкрийте книгу: сім записів, як і раніше, а в src/storage/ з'явився entries.json. Відкрийте його в IDE: масив із сімома записами, кожне поле на своєму рядку, імена й тексти — кирилицею;
    • додайте запис «Тарас» / «Привіт усім» / 4 у першому браузері й оновіть книгу в другому: запис Тараса там теж нагорі, і записів 8. «Запис додано» та ім'я у формі — лише в першому браузері: flash лежить у його сесії, а cookie — у ньому самому;
    • увійдіть модератором (knyha2026) і видаліть запис Тараса: після F5 у другому браузері його теж немає, а в entries.json знову сім записів;
    • відкрийте http://localhost:8080/storage/entries.json: замість записів — головна сторінка вашого проєкту з src/public/index.php. У src/public/ файлу storage/entries.json немає, і nginx передав запит index.php, як пояснює лекція «Шлях запиту, шляхи до файлів і IDE»;
    • git status не показує src/storage/entries.json;
    • на жодній сторінці немає Warning, Notice, Deprecated чи Fatal error.

    З терміналу, з каталогу intita-php — два «браузери», файли cookie a.txt і b.txt, як у кроці 7. Перша команда починає з чистого аркуша: без файлу записів і без старих cookie:

    rm -f src/storage/entries.json a.txt b.txt
    curl -s -c a.txt -b a.txt http://localhost:8080/guestbook/ | grep 'class="count"'
    ls src/storage/entries.json
    curl -s -i -c a.txt -b a.txt -d "name=Тарас&message=Привіт усім&rating=4" http://localhost:8080/guestbook/ | grep -E '^HTTP|^Location'
    curl -s -c b.txt -b b.txt http://localhost:8080/guestbook/ | grep -E 'class="flash"|class="count"|id="entry-8"|name="name"'
    tail -n 9 src/storage/entries.json
    docker compose exec php php -r 'var_dump(count(json_decode(file_get_contents("storage/entries.json"), true, 512, JSON_THROW_ON_ERROR)));'
    grep -c '\\u' src/storage/entries.json
    curl -s -i -c a.txt -b a.txt -d "password=knyha2026" http://localhost:8080/guestbook/login.php | grep -E '^HTTP|^Location'
    curl -s -i -c a.txt -b a.txt -d "id=8" http://localhost:8080/guestbook/delete.php | grep -E '^HTTP|^Location'
    curl -s -c b.txt -b b.txt http://localhost:8080/guestbook/ | grep -E 'class="count"|id="entry-8"'
    grep -c '"id"' src/storage/entries.json
    curl -s http://localhost:8080/storage/entries.json | grep -c '"message"'
    curl -s --path-as-is http://localhost:8080/guestbook/../storage/entries.json | grep -c '"message"'
    

    Перший GET створює файл. Після POST з A «браузер» B бачить запис з id 8 — без flash і без імені у формі. tail -n 9 показує останні дев'ять рядків файлу — запис Тараса. php -r у контейнері php розбирає файл з JSON_THROW_ON_ERROR — робочий каталог контейнера /var/www/html, тобто ваш src/: виняток означав би зламаний JSON, а count() рахує записи. grep -c '\\u' рахує рядки з кодами \u… замість літер. Після входу модератора й видалення B знову бачить сім записів, і у файлі їх сім. Дві останні команди просять файл даних через вебсервер і рахують у відповіді поля "message"; --path-as-is надсилає .. як є, без спрощення адреси на боці curl. Вивід — в «Очікуваному результаті».

  8. Знайди помилку: спершу прогноз. Колега робить нотатки у файлі JSON. Сторінка bugs-json.php додає нотатку з POST-поля text і показує всі нотатки, а маленьке API api/bugs-json.php відповідає програмам, скільки нотаток у файлі. Нотатки лежать у src/storage/bugs-notes.json — поза веб-коренем, як і записи книги. У коді три помилки. Створіть тренувальні файли — не в папці guestbook: це вправа, а не частина книги. src/public/bugs-json.php, код дослівно:

    <?php
    declare(strict_types=1);
    // Тренувальна сторінка: нотатки у файлі JSON поза веб-коренем, src/storage/bugs-notes.json
    
    $path = '../storage/bugs-notes.json';
    
    // Прочитати всі нотатки; файлу ще немає — список порожній
    $notes = file_exists($path) ? json_decode(file_get_contents($path)) : [];
    
    // Нова нотатка з POST — у кінець списку, і весь список назад у файл
    $text = trim($_POST['text'] ?? '');
    if ($text !== '') {
        $notes[] = ['text' => $text, 'created_at' => date('Y-m-d H:i')];
        $json = json_encode($notes, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
        file_put_contents($path, $json, FILE_APPEND | LOCK_EX);
    }
    
    foreach ($notes as $note) {
        echo '<p>', htmlspecialchars($note['text'], ENT_QUOTES, 'UTF-8'), '</p>', "\n";
    }
    

    І src/public/api/bugs-json.php — каталог api створіть, якщо його ще немає:

    <?php
    declare(strict_types=1);
    // Тренувальне API: скільки нотаток у файлі src/storage/bugs-notes.json — відповідь у JSON для програм
    
    $path = '../storage/bugs-notes.json';
    
    $notes = file_exists($path) ? json_decode(file_get_contents($path)) : [];
    
    header('Content-Type: application/json; charset=utf-8');
    echo json_encode(['count' => count($notes)]), "\n";
    

    Помилки ховаються одна за одною, тож працюйте колами. Кожне коло починається з rm -f src/storage/bugs-notes.json — без нотаток:

    • перед кожним колом допишіть у кінці src/public/bugs-json.php прогноз — коментар // прогноз 1: …, потім // прогноз 2: … і // прогноз 3: …: що поверне сервер і чому. Рядки в кінці файлу не зсувають номери рядків у повідомленнях PHP;
    • після кола допишіть у прогноз вгадав або не вгадав: чому …, як у практиці кроку 7, і виправте одну помилку — ту, яку показало коло.

    Коло 1 — нотатка, а потім звичайний GET:

    rm -f src/storage/bugs-notes.json
    curl -s -d "text=Купити каву" http://localhost:8080/bugs-json.php
    curl -s http://localhost:8080/bugs-json.php
    

    Виправлення — як радить розділ «json_decode(): з JSON у масив» лекції, в обох файлах.

    Коло 2 — дві нотатки, GET і вміст файлу:

    rm -f src/storage/bugs-notes.json
    curl -s -d "text=Купити каву" http://localhost:8080/bugs-json.php
    curl -s -d "text=Полити квіти" http://localhost:8080/bugs-json.php
    curl -s http://localhost:8080/bugs-json.php
    cat src/storage/bugs-notes.json
    

    Виправлення — як у saveEntries() гостьової книги: масив JSON перезаписують цілим (розділ «Масив записів у файлі й API» лекції).

    Коло 3 — дві нотатки на сторінці й запит до API:

    rm -f src/storage/bugs-notes.json
    curl -s -d "text=Купити каву" http://localhost:8080/bugs-json.php
    curl -s -d "text=Полити квіти" http://localhost:8080/bugs-json.php
    curl -s http://localhost:8080/api/bugs-json.php
    

    Виправлення — як в entriesPath() гостьової книги, в обох файлах: від src/public/ до src/storage/ — один рівень угору, від src/public/api/ — два.

    Після трьох виправлень повторіть команди кола 3 і ще раз відкрийте сторінку — curl -s http://localhost:8080/bugs-json.php: API рахує обидві нотатки, а сторінка показує обидві без попереджень.

  9. Зробіть коміт: git add .gitignore src/storage/.gitkeep src/guestbook src/public/guestbook src/public/bugs-json.php src/public/api/bugs-json.php і git commit -m "practice: guestbook entries in a JSON file". git status перед комітом не показує ні entries.json, ні bugs-notes.json: дані з src/storage/ у репозиторій не потрапляють.

Важливо

Шлях до файлу даних будують від __DIR__, а сам файл тримають поза src/public/. Масив у файлі JSON перезаписують цілим, з LOCK_EX, а читають із true і JSON_THROW_ON_ERROR: зламаний файл має зупинити сторінку, а не тихо обнулити книгу.

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

Книга в «браузері» B з перевірки (крок 7) — відповідь на GET після того, як A додав запис Тараса. Сесія B про цей запис нічого не знає: він прийшов із файлу (привітання й час запису у вас — свої):

Відповіді на запити з перевірки (крок 7):

Запит Відповідь
Перший GET, entries.json ще немає «7 записів, середня оцінка 3,9»; у src/storage/ з'явився entries.json — сім записів із data.php
A: POST форми name=Тарас&message=Привіт усім&rating=4 303 See Other, Location: /guestbook/; запис з id 8 — у кінці entries.json
B: GET «8 записів, середня оцінка 3,9», запис з id 8 нагорі; «Запис додано» немає, поле «Ім'я» порожнє
entries.json після запису 8 записів; json_decode(…, true, 512, JSON_THROW_ON_ERROR) розбирає файл без винятку; кирилиця — літерами, рядків із \u — 0
A: вхід модератора, POST delete.php з id=8 303, Location: /guestbook/; у файлі знову 7 записів, B бачить «7 записів» без запису з id 8
/storage/entries.json і /guestbook/../storage/entries.json головна сторінка проєкту з src/public/index.php; жодного поля "message" — записів вебсервер не віддає
  • У жодній відповіді немає Warning, Notice, Deprecated чи Fatal error.
  • git status не показує src/storage/entries.json.

Вивід команд з перевірки (відступи — з шаблону, дата запису у вас — своя). Друга команда — перший візит:

                                    <p class="count">7 записів, середня оцінка 3,9</p>

Третя — файл з'явився:

src/storage/entries.json

Четверта — відповідь на форму A:

HTTP/1.1 303 See Other
Location: /guestbook/

П'ята — «браузер» B бачить запис з id 8, але без flash і без імені у формі:

                                    <p class="count">8 записів, середня оцінка 3,9</p>
                            <article class="entry" id="entry-8">
            <input type="text" id="name" name="name" value="" required minlength="2" maxlength="50">

Шоста — останній запис у файлі:

    },
    {
        "id": 8,
        "name": "Тарас",
        "message": "Привіт усім",
        "rating": 4,
        "created_at": "2026-10-06 06:41"
    }
]

Сьома — файл розбирається з JSON_THROW_ON_ERROR, у ньому 8 записів:

int(8)

Восьма — рядків із кодами \u… немає:

0

Дев'ята й десята — вхід модератора й видалення — відповідають однаково:

HTTP/1.1 303 See Other
Location: /guestbook/

Одинадцята — B після видалення:

                                    <p class="count">7 записів, середня оцінка 3,9</p>

Дванадцята — у файлі знову сім записів:

7

Дві останні — у відповідях на адреси файлу даних немає жодного поля "message":

0

Сторінка bugs-json.php — звірте з прогнозами. Коло 1, до виправлень. POST показує нотатку:

<p>Купити каву</p>

GET — <p> на початку встиг вивести echo, а далі PHP зупинився:

<p><br />
<b>Fatal error</b>:  Uncaught Error: Cannot use object of type stdClass as array in /var/www/html/public/bugs-json.php:19
Stack trace:
#0 {main}
  thrown in <b>/var/www/html/public/bugs-json.php</b> on line <b>19</b><br />

Коло 2, після першого виправлення. Друга відповідь на POST показує обидві нотатки:

<p>Купити каву</p>
<p>Полити квіти</p>

GET — уже без нотаток:

<br />
<b>Warning</b>:  foreach() argument must be of type array|object, null given in <b>/var/www/html/public/bugs-json.php</b> on line <b>18</b><br />

У файлі — два масиви поспіль, і разом це вже не JSON:

[
    {
        "text": "Купити каву",
        "created_at": "2026-10-06 06:41"
    }
][
    {
        "text": "Купити каву",
        "created_at": "2026-10-06 06:41"
    },
    {
        "text": "Полити квіти",
        "created_at": "2026-10-06 06:41"
    }
]

Коло 3, після другого виправлення. Сторінка показує обидві нотатки, а API:

{"count":0}

Після трьох виправлень — API:

{"count":2}

і сторінка:

<p>Купити каву</p>
<p>Полити квіти</p>

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

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

Критерій Бали
Сховище (кроки 2–4): src/storage/ з .gitkeep, рядок src/storage/*.json у .gitignore; storage.php з loadEntries(), saveEntries(), addEntry() і deleteEntry(); шлях від __DIR__; json_decode() з true і JSON_THROW_ON_ERROR; json_encode() з кирилицею літерами й відступами; запис цілого файлу з LOCK_EX 4
Книга на файлі (кроки 5–7): перший візит створює entries.json із сімома записами з data.php; запис з одного браузера бачить інший; модератор видаляє запис із файлу; у сесії — лише flash і вхід модератора; за адресою файлу записів не видно; на сторінках немає попереджень 3
bugs-json.php і api/bugs-json.php (крок 8): прогноз до кожного кола, позначки вгадав / не вгадав: чому, три виправлення; вивід — як в «Очікуваному результаті» 2
Коміт practice: guestbook entries in a JSON file без файлів даних із src/storage/, крім .gitkeep 1
Разом 10

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

Що здати

Посилання на коміт practice: guestbook entries in a JSON file з такими файлами:

  • .gitignore, src/storage/.gitkeep;
  • src/guestbook/storage.php;
  • src/public/guestbook/index.php, delete.php, logout.php;
  • src/public/bugs-json.php, src/public/api/bugs-json.php.

Або архів, якщо так домовлено на занятті. Будьте готові пояснити, чому записи кроку 8 бачать усі браузери, а flash і вхід модератора — лише свій; навіщо шлях від __DIR__; чому масив JSON перезаписують цілим і з LOCK_EX; навіщо в json_decode() true і JSON_THROW_ON_ERROR; і чому entries.json немає ні в src/public/, ні в git.

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

  1. API книги. Створіть src/public/guestbook/api.php: він бере записи через loadEntries() і віддає їх у JSON, найновіші першими (array_reverse()), із заголовком Content-Type: application/json; charset=utf-8 — як api/tasks.php у розділі «Масив записів у файлі й API» лекції. Перевірте curl -i http://localhost:8080/guestbook/api.php і відкрийте адресу у Firefox.
  2. Журнал видалень. Після видалення delete.php дописує в src/storage/deletions.log рядок із датою, часом і id запису: file_put_contents() з FILE_APPEND | LOCK_EX, а рядок закінчується "\n". Тут FILE_APPEND доречний: журнал лише дописують. Щоб журнал не потрапив у git, додайте в .gitignore рядок src/storage/*.log.
  3. Резервна копія. Перед кожним записом saveEntries() копіює наявний entries.json у entries.backup.json вбудованою функцією copy($from, $to) — якщо файл уже є. Зіпсуйте entries.json в IDE зайвою комою, подивіться на JsonException і відновіть книгу з копії.