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

Підсумковий проєкт: гостьова книга на захист

Мета

Довести гостьову книгу з кроків 1–10 до завершеного проєкту, який будь-хто запустить з чистого клону за інструкцією в README.md. Самостійно спланувати й зробити одне розширення, спираючись на модулі 6–15: форми, валідацію, сесії, SQL і PDO. Перевірити проєкт за чеклістом безпеки — кожен пункт командою чи в браузері — і захистити його: показати книгу за 3–5 хвилин і пояснити, як вона влаштована.

Завдання

Продовжуємо проєкт із кроку 10 — практики «Гостьова книга, крок 10: записи в MySQL через PDO». За десять кроків сторінка з привітанням стала книгою на MySQL: пошук, сторінки, форма з перевіркою, вхід модератора й видалення. Лекцій у модулі 16 немає: ви збираєте все разом, додаєте одну функцію від себе й показуєте результат.

Карта проєкту

Модуль Крок Що додали
6. Розгалуження Крок 1: сторінка, що ухвалює рішення привітання за годиною, підпис кількості записів, банер, підпис і колір оцінки через match
7. Цикли Крок 2: форма і сторінки циклами форму нового запису, <select> оцінки, зірки, навігацію сторінками
8. Масиви Крок 3: записи в масиві сім записів у масиві, foreach, найновіші першими, середню оцінку
9. Функції Крок 4: функції і шаблони functions.php з типами, data.php, шапку й підвал у templates/
10. Форми: GET і POST Крок 5: пошук і форма нового запису пошук за ім'ям (GET) і новий запис через POST
11. Валідація та безпека введення Крок 6: валідація і захист від XSS validateEntry(), помилки біля полів, e() для всього виведення
12. Сесії та cookies Крок 7: сесія, cookie і вхід модератора flash після POST, cookie з ім'ям автора, вхід модератора, видалення
13. Файли та JSON Крок 8: записи у файлі JSON storage.php і записи у src/storage/entries.json
14. Бази даних і SQL Крок 9: таблиця записів у MySQL сервіс db, .env.example, schema.sql, seed.sql, queries.sql
15. PHP + MySQL: CRUD через PDO Крок 10: записи в MySQL через PDO db.php і підготовлені запити в storage.php замість файлу JSON
16. Підсумковий міні-проєкт ця практика власне розширення, README.md, чекліст безпеки, захист

Що має вийти

  • усе з кроків 1–10 працює на чистому git clone: .env з .env.example, docker compose up -d --build, database/schema.sql і seed.sql — і більше нічого;
  • одне власне розширення з переліку в кроці 3 або своє — за погодженням із викладачем;
  • README.md у корені проєкту: що це, як запустити (команди), функції, яке розширення зроблено, результати чекліста безпеки;
  • чекліст безпеки пройдено: кожен пункт перевірено командою чи кроком у браузері;
  • історія комітів: щонайменше по коміту на кожен крок 1–10 і на розширення;
  • захист: демо на 3–5 хвилин за сценарієм і відповіді на контрольні питання.
intita-php/
├── README.md             ← нове: опис і запуск проєкту
├── .env                  ← паролі, не в git
├── .env.example
├── .gitignore
├── docker-compose.yml
├── database/             ← schema.sql, seed.sql, queries.sql
├── docker/
└── src/
    ├── guestbook/        ← функції, з'єднання з базою, сховище, шаблони
    ├── storage/
    └── public/
        └── guestbook/    ← сторінки книги і файли розширення

Кроки

  1. Старт: книга кроку 10 та історія. Запустіть робочий проєкт intita-php (docker compose up -d) і відкрийте http://localhost:8080/guestbook/: книга кроку 10 читає записи з MySQL. Перевірте, що все збережено в git:

    git status
    git log --oneline
    
    • git status не показує змінених файлів книги: усе з кроку 10 закомічено. Якщо щось не закомічено — закомітьте зараз.
    • У git log знайдіть коміти practice: guestbook … — по одному на кожен крок 1–10 з «Карти проєкту». Якщо якогось кроку бракує (скажімо, два кроки в одному коміті), не переписуйте історію: скажіть про це викладачу до захисту.
    • Тренувальні файли bugs-*.php і сторінки з лекцій можуть лишитися в src/public/: книзі вони не заважають.
  2. Чистий клон: кроки 1–10 без вашої робочої копії. Робоча копія пам'ятає те, чого немає в git: файл без git add, таблицю, змінену вручну в консолі mysql, ваш .env. Перевірте проєкт так, як його побачить викладач, — з GitHub. Надішліть коміти й зупиніть робочий стек: імена контейнерів (container_name) і порт 8080 у docker-compose.yml сталі, тож другий стек поруч не запуститься:

    git push
    docker compose down
    

    Склонуйте репозиторій поруч із робочим каталогом — у новий каталог gb-check — і запустіть його з нуля:

    cd ..
    git clone https://github.com/<ваш-логін>/intita-php.git gb-check
    cd gb-check
    cp .env.example .env
    docker compose up -d --build
    docker compose exec -T db sh -c 'mysql --default-character-set=utf8mb4 -uguestbook -p"$MYSQL_PASSWORD" guestbook' < database/schema.sql
    docker compose exec -T db sh -c 'mysql --default-character-set=utf8mb4 -uguestbook -p"$MYSQL_PASSWORD" guestbook' < database/seed.sql
    
    • Compose бере назву проєкту з назви каталогу, тож том бази тут — gb-check_db-data, і він порожній: таблицю й сім записів дають лише schema.sql і seed.sql з репозиторію.
    • Перший старт MySQL з порожнім томом триває до хвилини. Якщо mysql відповідає помилкою підключення, зачекайте й повторіть команду.
    • На Linux змініть у .env значення UID і GID на свої (id -u, id -g), якщо вони не 1000, — як у робочому проєкті.

    Відкрийте http://localhost:8080/guestbook/ і пройдіть кроки 1–10:

    • «7 записів, середня оцінка 3,9», дві сторінки, привітання за годиною, імена кирилицею без кракозябр;
    • пошук «ол» — «Знайдено 1 запис»;
    • новий запис з порожнім ім'ям — помилка біля поля, а введений текст лишився у формі; правильний запис — «Запис додано», і запис нагорі;
    • «Вхід для модератора», видалення щойно доданого запису — «Запис видалено», потім «Вийти»;
    • на жодній сторінці немає Warning, Notice, Deprecated чи Fatal error.

    Щось не працює — виправляйте в робочому каталозі intita-php, а не в gb-check: закомітьте, виконайте git push, а в gb-check — git pull, і перевірте знову. Найчастіша причина — файл, якого немає в git: git status у робочому каталозі показує його в Untracked files. Наприкінці приберіть перевірочний стек разом із його томом і поверніться до роботи:

    docker compose down -v
    cd ../intita-php
    docker compose up -d
    

    -v видаляє томи лише цього проєкту — gb-check. Том робочого проєкту має інше ім'я, тож ваші записи на місці. Ту саму перевірку повторіть наприкінці, коли розширення й README будуть готові.

  3. Оберіть розширення. Одне з переліку або своє — погодьте вибір із викладачем на початку заняття. Розширення має бути завбільшки з крок проєкту: одна-дві сторінки чи форми, перевірка даних, запит до бази.

    • Редагування запису модератором. Біля кнопки «Видалити» модератор бачить «Редагувати»: вона відкриває форму з поточними значеннями запису, а збереження змінює рядок у таблиці й повертає до книги з повідомленням «Запис оновлено». Знадобляться форма, $_GET і $_POST (модуль 10), validateEntry() і помилки біля полів (модуль 11), перевірка входу модератора, PRG і flash (модуль 12) та підготовлений UPDATE … WHERE id = :id (модулі 14–15).
    • Відповідь модератора на запис. Модератор пише під записом коротку відповідь, і книга показує її окремим блоком «Відповідь модератора». Знадобляться новий стовпець у schema.sql (скажімо, reply VARCHAR(500) NOT NULL DEFAULT '': порожній рядок — відповіді немає), форма лише для модератора з перевіркою довжини (модулі 10–12), підготовлений UPDATE (модуль 15) і e() під час виведення (модуль 11).
    • CSRF-токен у всіх POST-формах. Чужа сторінка може приховано надіслати форму на ваш delete.php, поки модератор увійшов у книгу, і якщо браузер додасть до запиту cookie сесії, запис зникне: це CSRF, підробка запиту від імені користувача. Захист — випадковий токен у сесії (вбудовані random_bytes() і bin2hex() дають рядок, який не вгадати), приховане поле з ним у кожній POST-формі й перевірка hash_equals() перед будь-якою зміною, а без правильного токена — відмова з кодом 403. Знадобляться сесії (модуль 12), приховані поля форм (модулі 10–12) і http_response_code() (модуль 15).
    • Сортування за оцінкою. Перемикач «Спершу нові / Спершу найкращі» (?sort=rating) змінює порядок записів і зберігається в посиланнях сторінок разом із пошуком. Назву стовпця параметром PDO не передати — він візьме її в лапки, як рядок, — тож match (модуль 6) обирає один із двох готових фрагментів ORDER BY, а решта — GET-параметри в посиланнях (модулі 7 і 10) і ORDER BY rating DESC, created_at DESC (модуль 14).
    • «Корисно» з обмеженням через cookie. Під кожним записом кнопка «Корисно» (POST) додає одиницю до лічильника: новий стовпець likes у schema.sql і підготовлений UPDATE entries SET likes = likes + 1 WHERE id = :id (модулі 14–15). Cookie зі списком id, за які браузер уже голосував (implode() і explode(), модулі 8 і 12), ховає кнопку під цими записами. Cookie можна стерти, тож це захист від випадкового повторного кліку, а не від накрутки.
    • Записи JSON-ом для інших сайтів. Сторінка api.php віддає п'ять найновіших записів у форматі JSON із заголовком Content-Type: application/json, а з ?q= — результат пошуку. Знадобляться json_encode() з JSON_UNESCAPED_UNICODE (модуль 13) і findEntries() зі storage.php (модуль 15), а перевірка — curl і DevTools → Network.
    • Своє розширення. Будь-яка функція такого самого обсягу — скажімо, фільтр за оцінкою чи лічильник записів для кожної оцінки, — якщо викладач погодив її до початку роботи.
  4. Зробіть розширення. Працюйте в робочому каталозі intita-php і тримайтеся правил, за якими зроблено кроки 1–10:

    • дані від відвідувача після trim() перевіряються на сервері, помилки показуються біля полів, а введене лишається у формі (модуль 11). Браузерні required і maxlength — лише підказка;
    • усе, що потрапляє в SQL із запиту, передається лише параметром: prepare() і execute() або bindValue() (модуль 15);
    • усе, що виводиться на сторінку, проходить через e();
    • дії, що змінюють дані, — лише POST, а після успіху — 303 на сторінку книги і flash (модуль 12);
    • дія модератора починається з перевірки $_SESSION['moderator'], як у delete.php: без входу — перенаправлення на login.php, і далі скрипт не йде;
    • новий стовпець — у database/schema.sql, а його значення для семи записів — у seed.sql: на чистому клоні базу створюють лише ці два файли. Після зміни виконайте обидва файли командами з кроку 2. schema.sql видаляє таблицю, тож записи повернуться до семи стартових.

    Перевірте розширення в браузері з правильними даними, з неправильними даними й з порожніми полями. Потім перевірте дію модератора без входу — з терміналу: curl без файлу cookie — це новий відвідувач:

    curl -s -i -d "id=3" http://localhost:8080/guestbook/<ваша-сторінка>.php | grep -E '^HTTP|^Location'
    

    Відповідь — 303 See Other і Location: /guestbook/login.php, а дані в таблиці не змінилися: перевірте це SELECT у консолі mysql, як у практиці кроку 10. Зробіть коміт: git status покаже нові й змінені файли, далі git add для них і git commit -m "practice: guestbook <що додали, англійською>" — скажімо, practice: guestbook moderator edits entries.

  5. Чекліст безпеки. Пройдіть шість пунктів, виконуючи команди в каталозі intita-php. Кожен пункт стосується всієї книги разом із вашим розширенням. Якщо пункт не виконується, виправте код, закомітьте й перевірте знову. Що показала кожна перевірка, запишіть: це розділ «Безпека» в README (крок 6).

    • Усе виведення екрановане. У браузері додайте запис з ім'ям <b>Тест</b> і текстом <script>alert(1)</script>: теги видно як текст, жирного шрифту й вікна alert немає, а curl -s http://localhost:8080/guestbook/ | grep -c '<script>' друкує 0. Потім видаліть цей запис модератором. У коді grep -rn '<?= \$' src/public/guestbook src/guestbook/templates показує виведення без e(): там мають лишитися тільки числа — $entry['id'], $entry['rating'], $pageNumber, $value — і вибір класу банера з двох готових рядків.
    • SQL з даними відвідувача — лише підготовлені запити. Після grep -rn 'query(\|prepare(' src/guestbook src/public/guestbook має вийти так: query() — лише там, де в запиті немає даних ззовні (entriesStats()), а решта — prepare(), і в рядках SQL немає ' . $. У браузері пошук ' OR '1'='1 дає «Нічого не знайдено».
    • Валідація на сервері. Запит повз форму браузера curl -s -d "name=&message=&rating=9" http://localhost:8080/guestbook/ | grep 'class="error"' друкує три помилки: для імені, тексту й оцінки. Так само перевірте форму розширення, якщо вона є.
    • Пароль модератора — лише хеш. grep -rn 'moderator_password_hash' src показує, що в config.php лежить хеш з password_hash(), який починається з $2y$, а login.php перевіряє пароль password_verify(). Самого пароля в коді немає: grep -rn 'knyha2026' src (чи ваш пароль) нічого не друкує.
    • Код і дані — поза src/public/. ls src/public/guestbook показує лише сторінки й style.css. Функції, з'єднання з базою й налаштування лежать у src/guestbook/, якого nginx не віддає: curl -s -o /dev/null -w '%{http_code}\n' http://localhost:8080/guestbook/config.php друкує 404. Записи живуть у MySQL, паролі — у .env поза src/.
    • .env не в репозиторії. git check-ignore .env друкує .env, а git ls-files .env — нічого. На GitHub серед файлів є .env.example, але немає .env.
  6. README.md. Створіть README.md у корені проєкту, поруч із docker-compose.yml. Це файл у форматі Markdown: GitHub показує його під списком файлів репозиторію, тож це перше, що побачить викладач. Розмітка проста:

    • # — заголовок, ## — розділ;
    • - на початку рядка — пункт списку;
    • текст у бектиках — код;
    • команди — у блоці між рядками з трьома бектиками.

    Каркас:

    # Гостьова книга
    
    Що це за проєкт — одне-два речення.
    
    ## Як запустити
    
    ```bash
    git clone …
    ```
    
    ## Функції
    
    - …
    
    ## Розширення
    
    Що робить, як перевірити, які файли.
    
    ## Безпека
    
    - …
    
    • Під заголовком — що це: одне-два речення про проєкт і про те, яке розширення зроблено.
    • «Як запустити» — команди з кроку 2, ті самі й у тому самому порядку. Далі — адреса книги, сторінка входу модератора з навчальним паролем (у коді — лише його хеш) і що робити, якщо щось піде не так: порт 8080 зайнятий чи MySQL ще стартує.
    • «Функції» — що вміє книга після кроків 1–10, по пункту на функцію.
    • «Розширення» — що воно робить, як його перевірити в браузері й які файли додано чи змінено.
    • «Безпека» — шість пунктів кроку 5: що перевірили і що вийшло.

    Зробіть коміт — git add README.md і git commit -m "practice: guestbook README", — надішліть його (git push) і відкрийте репозиторій на GitHub: заголовки, списки й блок команд у README мають бути відформатовані.

  7. Історія комітів.

    git status
    git log --oneline
    
    • git status не показує змінених файлів: кроки 1–10, розширення й README закомічено. .env git не показує, бо ігнорує його; в Untracked files можуть лишитися хіба що файли cookie *.txt з перевірок curl (a.txt, b.txt, bugs1.txt…) і сторінки з лекцій — у репозиторії вони не потрібні.
    • У git log --oneline — щонайменше по коміту на кожен крок 1–10, коміт розширення й коміт README; зразок — в «Очікуваному результаті».
    • Після git push повторіть чистий клон з кроку 2 — тепер разом із розширенням. Якщо розширення змінило schema.sql, переконайтеся, що на свіжій базі воно працює.
  8. Захист: демо на 3–5 хвилин. Перед захистом книга вже запущена, у браузері відкрито http://localhost:8080/guestbook/, поруч — приватне вікно без входу, а в терміналі — каталог проєкту. Покажіть у такому порядку:

    1. Що це (30 с). README на GitHub: що за проєкт, як його запустити, яке розширення.
    2. Відвідувач (1 хв). Друга сторінка, пошук «ол», новий запис: спершу з порожнім ім'ям — помилка біля поля, потім правильний — «Запис додано».
    3. Модератор і розширення (1–1,5 хв). Вхід модератора, розширення в дії — з правильними й неправильними даними, — а потім та сама дія в приватному вікні без входу.
    4. Безпека (1 хв). Запис з <script>alert(1)</script> показується текстом, пошук ' OR '1'='1 нічого не знаходить, і одна команда чекліста в терміналі.
    5. Історія (30 с). git log --oneline: коміти кроків 1–10, розширення й README.

    Відрепетируйте демо із секундоміром: якщо виходить більше 5 хвилин, приберіть зайве. Друга частина захисту — відповіді на питання: контрольні питання — в уроці «Самоконтроль: підсумок курсу», пройдіть його перед захистом. Викладач може додати 1–2 питання про ваш код — скажімо, де розширення перевіряє вхід модератора і навіщо в шаблоні e().

Важливо

Захищаєте те, що в репозиторії, а не те, що у вашій робочій копії. Файл без git add, стовпець, доданий у консолі mysql, а не в schema.sql, чи змінна, яку ви дописали лише у свій .env, а не в .env.example, на чистому клоні не спрацюють. Тому крок 2 повторюється наприкінці.

Порада

Документація PHP: htmlspecialchars(), PDO::prepare(), password_hash(), random_bytes(), hash_equals(). Markdown для README — довідка GitHub.

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

Еталон викладача — кроки 1–10 і розширення «Редагування запису модератором». Ваше розширення може бути іншим, а все з кроків 1–10 має працювати так само.

Книга модератора після того, як він зберіг запис Марії (id 3) з новим текстом і оцінкою 4. Нагорі flash «Запис оновлено», середня оцінка тепер 4,0, а біля кожного запису — «Редагувати» і «Видалити» (привітання у вас — своє):

Форма редагування після POST з ім'ям М і текстом Ок: помилки біля полів, введене лишилося у формі, а рядок у таблиці не змінився:

Відповіді еталона на запити з перевірки:

Запит Відповідь
Без входу: GET edit.php?id=3 чи POST на цю адресу 303 See Other, Location: /guestbook/login.php; рядок 3 у таблиці не змінився
Модератор: GET /guestbook/ біля кожного запису — кнопки «Редагувати» і «Видалити»
Модератор: GET edit.php?id=3 форма з поточними значеннями: «Марія», текст запису, оцінка 3
POST name=М&message=Ок&rating=4 200 OK, помилки «Ім'я — від 2 до 50 символів» і «Текст запису — від 5 до 500 символів» біля полів; рядок 3 не змінився
POST з оцінкою 9 помилка «Оцінка — ціле число від 1 до 5»
POST з новим текстом і оцінкою 4 303 See Other, Location: /guestbook/; у таблиці — новий текст і оцінка; книга — «Запис оновлено», «7 записів, середня оцінка 4,0»
Модератор: GET edit.php?id=99 303 See Other, Location: /guestbook/ і flash «Запису не знайдено»

Рядок 3 у таблиці після збереження:

+----+------------+------------------------------------------------------------------------------------------------------------------------------------------------+--------+---------------------+
| id | name       | message                                                                                                                                        | rating | created_at          |
+----+------------+------------------------------------------------------------------------------------------------------------------------------------------------+--------+---------------------+
|  3 | Марія      | Цікаво, але темп швидкий. Після розбору циклів на занятті все стало зрозуміло.                                                                 |      4 | 2026-09-21 08:05:00 |
+----+------------+------------------------------------------------------------------------------------------------------------------------------------------------+--------+---------------------+

Чекліст безпеки на еталоні — усі шість пунктів виконано:

  • запис з ім'ям <b>Тест</b> і текстом <script>alert(1)</script> показано текстом, grep -c '<script>' — 0;
  • без e() виводяться лише $entry['id'], $entry['rating'], $pageNumber, $value і клас банера;
  • query() — лише в entriesStats(), решта запитів — prepare() з параметрами;
  • curl -d "name=&message=&rating=9" — три рядки class="error";
  • у config.php — хеш $2y$12$…, пароля в src/ немає;
  • /guestbook/config.php — 404, git check-ignore .env — .env.

Історія комітів еталона — git log --oneline -12 (хеші у вас — свої, а нижче, перед кроком 1, — коміти модулів 2–5):

4191b1f practice: guestbook README
eb53f26 practice: guestbook moderator edits entries
bd071ce practice: guestbook entries in MySQL via PDO
c297289 practice: guestbook entries table in MySQL
d42ea8d practice: guestbook entries in a JSON file
2781731 practice: guestbook sessions, cookie and moderator login
e694573 practice: guestbook validation and XSS protection
0db421c practice: guestbook search and new entry form
4dbcd1e practice: guestbook functions, data file and templates
87bc53d practice: guestbook entries array with pagination and average rating
b8c49c0 practice: guestbook entry form, rating stars and pagination
5aa5ec5 practice: guestbook greeting, entries count and rating
  • У жодній відповіді й у журналі php немає Warning, Notice, Deprecated чи Fatal error.
  • Чистий клон з кроку 2 дає ту саму книгу: сім записів із seed.sql, а розширення працює без ручних змін у базі.

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

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

Критерій Бали
Кроки 1–10 працюють на чистому клоні (крок 2): .env з .env.example, docker compose up -d --build, schema.sql і seed.sql — і книга працює як у кроці 10: сторінки, пошук, форма з перевіркою, вхід модератора, видалення; без попереджень PHP 3
Чекліст безпеки (крок 5): кожен із шести пунктів перевірено командою чи в браузері й виконано, результати — у README 2
Розширення (кроки 3–4): працює, як описано в README; дані перевіряються на сервері, SQL — підготовлені запити, виведення — через e(), дія модератора без входу — відмова; працює на чистому клоні 2
README.md (крок 6) з розділами «Як запустити», «Функції», «Розширення», «Безпека» та історія комітів (крок 7): щонайменше по коміту на кроки 1–10 і на розширення, без .env 1
Захист (крок 8): демо на 3–5 хвилин за сценарієм і відповіді на контрольні питання 2
Разом 10

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

Що здати

Посилання на репозиторій intita-php на GitHub, у якому:

  • коміти кроків 1–10, коміт розширення practice: guestbook … і коміт practice: guestbook README;
  • README.md у корені проєкту з розділами «Як запустити», «Функції», «Розширення» і «Безпека»;
  • немає .env.

Або архів проєкту разом із прихованим каталогом .git, якщо так домовлено на занятті.

Захист — на занятті: демо за сценарієм кроку 8 і відповіді на контрольні питання. Будьте готові пояснити:

  • як ваше розширення перевіряє дані й чому SQL у ньому не зламати лапкою;
  • що перевіряє кожен пункт чекліста;
  • що потрібно, щоб книгу з нуля запустив хтось інший.

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

  1. Друге розширення. Ще один пункт переліку з кроку 3 — окремим комітом і окремим розділом у README. На захисті покажіть обидва й не вийдіть за 5 хвилин.
  2. README на чужому комп'ютері. Попросіть когось із друзів чи команди запустити книгу лише за README, без ваших підказок. Кожне місце, де вони застрягли, — виправлення в README.
  3. Прибрати зайве. Після кроку 10 сторінки не викликають filterEntries(), pageEntries(), averageRating() і nextId() з functions.php: їхню роботу роблять LIKE, LIMIT / OFFSET, AVG() і AUTO_INCREMENT. Переконайтеся в цьому: grep -rn 'filterEntries(\|pageEntries(\|averageRating(\|nextId(' src/guestbook src/public/guestbook знаходить лише оголошення в functions.php. Потім видаліть ці функції окремим комітом і повторіть перевірку кроку 2.