Гостьова книга, крок 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» вони переїдуть у таблицю бази даних.
Кроки
-
Старт: у кожного браузера свої записи. Запустіть робочий проєкт
intita-php(docker compose up -d) і відкрийтеhttp://localhost:8080/guestbook/у двох браузерах — або у звичайному й приватному вікні: у приватного вікна свої cookie, а отже, й своя сесія. Додайте в першому запис «Тарас» / «Привіт усім» / 4: він нагорі. У другому післяF5— сім записів без Тараса: записи кроку 7 живуть у сесії, а сесія в кожного браузера своя. Щоб записи бачили всі, сервер має тримати їх в одному місці — у файлі. Вindex.phpзамініть коментар підdeclareна// Гостьова книга, крок 8: записи у файлі JSON. -
Каталог для даних. Створіть у проєкті каталог
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— розділ «Хто має право писати» лекції.
- Файл даних лежить поза веб-коренем, як радить розділ «Поза веб-коренем» лекції: nginx віддає лише вміст
-
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удруге його не підключить.
-
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, і строге!==порівнює число з числом.
-
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, жили в сесіях і у файл не переїдуть.
- Решта сторінки працює з
-
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 «Ви вийшли» -
Перевірка. Видаліть
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— два «браузери», файли cookiea.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 бачить запис з
id8 — без 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. Вивід — в «Очікуваному результаті». - відкрийте книгу: сім записів, як і раніше, а в
-
Знайди помилку: спершу прогноз. Колега робить нотатки у файлі JSON. Сторінка
bugs-json.phpдодає нотатку з POST-поляtextі показує всі нотатки, а маленьке APIapi/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 рахує обидві нотатки, а сторінка показує обидві без попереджень. - перед кожним колом допишіть у кінці
-
Зробіть коміт:
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/у репозиторій не потрапляють.
Порада
Документація PHP: file_put_contents(), file_get_contents(), file_exists(), json_encode(), json_decode(), require_once.
Важливо
Шлях до файлу даних будують від __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.
Додатково (*)
- 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. - Журнал видалень. Після видалення
delete.phpдописує вsrc/storage/deletions.logрядок із датою, часом іidзапису:file_put_contents()зFILE_APPEND | LOCK_EX, а рядок закінчується"\n". ТутFILE_APPENDдоречний: журнал лише дописують. Щоб журнал не потрапив у git, додайте в.gitignoreрядокsrc/storage/*.log. - Резервна копія. Перед кожним записом
saveEntries()копіює наявнийentries.jsonуentries.backup.jsonвбудованою функцієюcopy($from, $to)— якщо файл уже є. Зіпсуйтеentries.jsonв IDE зайвою комою, подивіться наJsonExceptionі відновіть книгу з копії.