Гостьова книга, крок 10: записи в MySQL через PDO
Мета
Перевести гостьову книгу з файлу JSON на MySQL. Сервіс php отримує змінні підключення, новий файл db.php відкриває одне з'єднання PDO на запит, а функції storage.php замість читання й запису файлу надсилають до таблиці entries запити з кроку 9: кількість і середню оцінку, пошук, сторінку записів, додавання й видалення. Усі запити з даними відвідувача — підготовлені, тож ' OR '1'='1 у пошуку лишається звичайним текстом. Якщо база недоступна, відвідувач бачить зрозуміле повідомлення, а текст помилки потрапляє в журнал. Файл entries.json і data.php більше не потрібні: стартові записи — у seed.sql. Знаходити типові помилки PDO: запит, склеєний з даних відвідувача, LIMIT з параметром через execute() і DSN без charset.
Завдання
Продовжуємо проєкт із кроку 9 — практики «Гостьова книга, крок 9: таблиця записів у MySQL». Таблиця entries уже чекає в MySQL із сімома записами, а сторінка й далі читає entries.json: щоб показати п'ять записів, вона розбирає весь файл, а шукає, рахує й сортує сама. У цьому кроці цю роботу забирає база: сторінка надсилає запити з queries.sql через PDO й отримує лише потрібні рядки.
Має вийти:
- у
docker-compose.ymlсервісphpотримує змінніDB_HOST,DB_NAME,DB_USERіDB_PASSWORD— пароль з.env— і стартує післяdb; src/guestbook/db.phpз функцієюdb(): одне з'єднання на запит, DSN зcharset=utf8mb4, винятки й асоціативні масиви; без бази — повідомлення «Гостьова книга тимчасово недоступна» без деталей помилки;src/guestbook/storage.phpна SQL: кількість і середня оцінка, пошук, сторінка записів зLIMITіOFFSET, додавання й видалення — кожен запит з даними підготовлений;index.phpіdelete.phpпрацюють з базою,data.phpіentries.jsonвидалено; сторінки, пошук, форма, вхід модератора й видалення працюють, як у кроці 8, а запис з одного браузера бачить інший.
intita-php/
├── .env ← паролі MySQL, без змін
├── .env.example ← новий коментар над паролями
├── docker-compose.yml ← php: змінні DB_* і depends_on
├── database/ ← без змін
└── src/
├── guestbook/
│ ├── config.php
│ ├── data.php ← видалити: стартові записи — у seed.sql
│ ├── db.php ← нове: з'єднання PDO
│ ├── functions.php
│ ├── storage.php ← запити до MySQL замість файлу JSON
│ └── templates/
├── storage/
│ ├── .gitkeep
│ └── entries.json ← видалити: записи — у MySQL
└── public/
├── bugs-pdo.php ← нове: вправа «Знайди помилку»
└── guestbook/
├── index.php ← записи з бази
├── delete.php ← видалення з бази
├── login.php
├── logout.php
└── style.css
Теорія — у лекціях «PDO: підключення до MySQL і читання даних» і «Підготовлені запити і SQL-ін'єкції». Це останній крок перед модулем 16 «Підсумковий міні-проєкт»: там книга отримає ваше власне розширення.
Кроки
-
Старт. Запустіть робочий проєкт
intita-php(docker compose up -d) і відкрийтеhttp://localhost:8080/guestbook/: книга кроку 9 працює й поки читає записи зsrc/storage/entries.json. Перевірте, що таблицяentriesна місці й у ній сім записів:docker compose exec -T db sh -c 'mysql --default-character-set=utf8mb4 -t -uguestbook -p"$MYSQL_PASSWORD" guestbook -e "SELECT COUNT(*) FROM entries"'Інша кількість чи
ERROR 1146 (42S02): Table 'guestbook.entries' doesn't exist— виконайтеschema.sqlіseed.sqlкомандами з кроків 4–5 практики кроку 9. Вindex.phpзамініть коментар підdeclareна// Гостьова книга, крок 10: записи в MySQL через PDO. Сторінки з лекцій модуля —tasks.phpта інші — можуть лишитися вsrc/public/: книзі вони не заважають. -
Змінні підключення. У
docker-compose.ymlдопишіть у сервісphpпісляvolumesрозділиenvironmentіdepends_on:environment: DB_HOST: db DB_NAME: guestbook DB_USER: guestbook DB_PASSWORD: "${DB_PASSWORD}" depends_on: - db- Якщо
environmentви вже додали в лекції «PDO: підключення до MySQL і читання даних», звірте його з цим і допишітьdepends_on. Обидва розділи стоять на рівніvolumes— з чотирма пробілами відступу. DB_HOST: db— ім'я сервісу в мережіintita: у контейнеріphpадреса127.0.0.1означає сам цей контейнер. База й користувач — ті саміguestbook, що в сервісіdb, а пароль Compose підставляє з того самогоDB_PASSWORDу.env, тож у файлах проєкту його немає.depends_on—phpстартує післяdb, якwebпісляphp. Compose чекає старту контейнера, а не готовності MySQL: якщо перший запит прийде, поки база ще стартує, книга покаже повідомлення з кроку 3 — оновіть сторінку за кілька секунд.
.envне змінюється:DB_PASSWORDтам є з кроку 9. У.env.exampleвиправте коментар над паролями — тепер пароль бере не лишеdb:# MySQL: пароль користувача guestbook — для сервісів db і php — і пароль rootЗастосуйте зміни й перевірте, що PHP бачить змінні:
docker compose up -d docker compose exec php php -r 'var_dump(getenv("DB_HOST"), getenv("DB_NAME"));'docker compose up -dперестворює контейнерphp: змінилася його конфігурація.php -rу контейнері бачить ті самі змінні, що й php-fpm:string(2) "db"іstring(9) "guestbook".bool(false)означає, що змінної в контейнері немає: перевірте відступи вenvironment. Якщо після цього книга відповідає502 Bad Gateway, перезапустіть nginx —docker compose restart web: адресу контейнераphpвін запам'ятовує на старті. - Якщо
-
db.php: одне з'єднання на запит. Створітьsrc/guestbook/db.php— поруч ізstorage.php:<?php declare(strict_types=1); // З'єднання гостьової книги з MySQL: одне з'єднання PDO на запит. // Лише оголошення функції — без викликів і виводу /** * З'єднання з базою книги: перший виклик під'єднується, наступні повертають те саме з'єднання. * Сервер, база, користувач і пароль — зі змінних оточення сервісу php у docker-compose.yml. */ function db(): PDO { // static — змінна не зникає після return, а живе до кінця запиту static $pdo = null; if ($pdo === null) { $dsn = 'mysql:host=' . getenv('DB_HOST') . ';dbname=' . getenv('DB_NAME') . ';charset=utf8mb4'; $options = [ PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC, ]; try { // getenv() дає false, якщо змінної немає; (string) робить з нього '' — і помилку перехопить catch $pdo = new PDO($dsn, (string) getenv('DB_USER'), (string) getenv('DB_PASSWORD'), $options); } catch (PDOException $e) { // Текст помилки — у журнал PHP для розробника, відвідувачу — лише загальне повідомлення error_log($e->getMessage()); http_response_code(503); echo 'Гостьова книга тимчасово недоступна. Спробуйте пізніше.'; exit; } } return $pdo; }- DSN і параметри — ті самі, що в
tasks.phpз лекції «PDO: підключення до MySQL і читання даних»: сервер, база, користувач і пароль — зі змінних оточення, кодуванняutf8mb4записане явно, помилки бази стають винятками, а рядки приходять асоціативними масивами. static $pdo = null;— статична змінна. Звичайна локальна змінна зникає післяreturn(розділ «Область видимості» лекції), а статична зберігає значення між викликами функції до кінця запиту. Перший викликdb()під'єднується, наступні повертають те саме з'єднання: скільки б запитів не надіслали функціїstorage.php, з'єднання одне. Наступний запит до сторінки під'єднається заново.getenv()повертаєfalse, коли змінної немає, а зdeclare(strict_types=1)значенняfalseне пройде в параметр-рядокnew PDO()— сторінку зупинив биTypeErrorз усіма подробицями.(string)робить зfalseпорожній рядок: тоді MySQL відповістьAccess denied, і помилку перехопитьcatch.catch (PDOException $e): текст помилкиerror_log()пише в журнал PHP, а відвідувач отримує одне речення. Вбудована функціяhttp_response_code(503)ставить код статусу503 Service Unavailable— «сервіс тимчасово недоступний», як у лекції «HTTP: запит і відповідь», аexitзупиняє сторінку: без бази їй нема чого показати.- Сторінки викликають
db()через функціїstorage.phpще до шапки, тож повідомлення — уся відповідь, без половини сторінки над ним.
- DSN і параметри — ті самі, що в
-
storage.php: читання з бази. Відкрийтеsrc/guestbook/storage.phpі замініть увесь його вміст — функції роботи з файлом більше не потрібні:<?php declare(strict_types=1); // Сховище записів гостьової книги: таблиця entries у MySQL, запити — через PDO. // Лише оголошення функцій — без викликів і виводу // З'єднання з базою: db() — у src/guestbook/db.php require_once __DIR__ . '/db.php'; /** * Підпис над записами: скільки записів у книзі й середня оцінка — один запит, як у queries.sql. */ function entriesStats(): array { // Даних відвідувача в запиті немає, тож досить query() $row = db()->query('SELECT COUNT(*) AS total, AVG(rating) AS average FROM entries')->fetch(); // COUNT(*) приходить цілим числом, а AVG() — рядком, у порожній книзі — NULL; (float) дає число, з NULL — 0 return ['total' => $row['total'], 'average' => (float) $row['average']]; } /** * Скільки записів, в імені яких є $q, без урахування регістру; для порожнього $q — усі записи. */ function countEntries(string $q): int { $stmt = db()->prepare('SELECT COUNT(*) AS total FROM entries WHERE name LIKE :q'); // Знаки % — у значенні параметра, а не в SQL: порожній $q дає '%%', тобто всі записи $stmt->execute(['q' => '%' . $q . '%']); $row = $stmt->fetch(); return $row['total']; } /** * Записи сторінки $page серед тих, в імені яких є $q: найновіші першими, не більше $perPage штук. */ function findEntries(string $q, int $page, int $perPage): array { $stmt = db()->prepare('SELECT id, name, message, rating, created_at FROM entries WHERE name LIKE :q ORDER BY created_at DESC, id DESC LIMIT :limit OFFSET :offset'); $stmt->bindValue('q', '%' . $q . '%'); // LIMIT і OFFSET — цілі числа без лапок: bindValue() з PDO::PARAM_INT, а не масив в execute() $stmt->bindValue('limit', $perPage, PDO::PARAM_INT); $stmt->bindValue('offset', ($page - 1) * $perPage, PDO::PARAM_INT); $stmt->execute(); // Масив записів, як $entries у кроках 3–8: id і rating — цілі числа return $stmt->fetchAll(); }require_onceтепер підключаєdb.php:nextId()зfunctions.phpбільше не потрібна, бо номер запису видаєAUTO_INCREMENT.- Запити — ті самі, що в
queries.sqlз кроку 9, лише значення з адресного рядка йдуть параметрами. У запитіentriesStats()даних відвідувача немає, тож доситьquery();AS totalіAS averageдають ключі масиву. COUNT(*)приходить цілим числом, аAVG()— рядком, як-от'3.8571', а в порожній книзі —NULL.(float)робить з рядка число, а зNULL— 0, якaverageRating()для порожньої книги, тожnumber_format()вindex.phpі далі отримуєfloat.- Пошук:
LIKE :qі значення'%' . $q . '%'— розділ «LIMIT і LIKE з параметрами» лекції. Великих і малих літерutf8mb4не розрізняє, як іmb_stripos()уfilterEntries(), а порожній$qдає'%%'— усі записи. - Сторінка:
LIMIT— це$perPage, аOFFSET— записи попередніх сторінок,($page - 1) * $perPage, як уqueries.sql. Обидва — черезbindValue()зPDO::PARAM_INT:execute()з масивом узяв би числа в лапки. ORDER BY created_at DESC, id DESC— два стовпці через кому: спершу за датою, а записи з однаковою датою — заid, новіший першим. Так два записи, додані в ту саму хвилину, стоять у порядку додавання, як післяarray_reverse()у кроці 8.fetchAll()повертає масив записів — такий самий, як$entriesу кроках 3–8:idіratingприходять цілими числами, тожratingClass(),stars()і решта функцій з параметромintпрацюють без змін. Дату MySQL віддає з секундами —2026-10-03 09:20:00, і так її покаже сторінка.
-
addEntry()іdeleteEntry(). Допишіть у кінецьstorage.php:/** * Новий запис. $entry — поля 'name', 'message', 'rating' і 'created_at'; id дає AUTO_INCREMENT. */ function addEntry(array $entry): void { $stmt = db()->prepare('INSERT INTO entries (name, message, rating, created_at) VALUES (:name, :message, :rating, :created_at)'); $stmt->execute([ 'name' => $entry['name'], 'message' => $entry['message'], 'rating' => $entry['rating'], 'created_at' => $entry['created_at'], ]); } /** * Видалити запис з цим id: рівно один рядок за первинним ключем. */ function deleteEntry(int $id): void { $stmt = db()->prepare('DELETE FROM entries WHERE id = :id'); $stmt->execute(['id' => $id]); }addEntry()отримує ті самі поля, що й у кроці 8, тож виклик вindex.phpне змінюється.idне передаємо: його видастьAUTO_INCREMENT, і, на відміну відnextId(), номерів він не повторює.created_atпередає PHP —date('Y-m-d H:i')зindex.php. Без ньогоDEFAULT CURRENT_TIMESTAMPузяв би час MySQL, а годинник MySQL у контейнері йде за UTC, як пояснює розділ «INSERT: додати рядки» лекції. Секунди MySQL допише сам::00.deleteEntry()—DELETEза первинним ключем з параметром:id: рівно один рядок, як уqueries.sql.(int)уdelete.phpлишається, бо параметр функції має типint.- Схеми «прочитати → змінити → записати» більше немає: кожна зміна — один запит, а одночасні запити впорядковує MySQL.
-
index.php: записи з бази. Коментар надrequire_onceзі сховищем замініть:// Записи книги в MySQL: entriesStats(), countEntries(), findEntries(), addEntry() — у src/guestbook/storage.phpі коментар над блоком POST:
// Новий запис із POST-форми — лише якщо поля пройшли перевірку; новий рядок таблиці entries, тож на сторінці він першийВиклик
addEntry([…])у блоці POST не змінюється. Під блоком POST рядки, що брали записи з файлу, — коментар// Записи для сторінки — з файлу…і$entries = loadEntries();— замініть такими:// Кількість записів і середня оцінка — з бази, спільні для всіх браузерів; // у сесії лишаються лише flash і вхід модератора $stats = entriesStats();Далі масив
$entriesу розрахунках замінюють запити — чотири місця, кожне разом з коментарем над ним:// Кількість записів — її рахує MySQL: COUNT(*) $entriesCount = $stats['total'];// Середня оцінка — AVG(rating); у порожній книзі — 0 $averageRating = $stats['average'];// Результат пошуку: скільки записів, в імені яких є $q; без пошуку — усі $foundCount = countEntries($q);// Записи сторінки: найновіші першими, $perPage штук — їх відбирає MySQL через LIMIT і OFFSET $pageEntries = findEntries($q, $page, $perPage);- Перші два місця — це
$entriesCount = count($entries);і$averageRating = averageRating($entries);, третє —$foundEntries = filterEntries(…)разом із$foundCount = count(…), четверте —$pageEntries = pageEntries(…). - Порядок розрахунків той самий: спершу кількість знайдених і
$pagesCount, потім обмеження$pageдіапазоном, і лише тодіfindEntries()—OFFSETрахується з уже перевіреного номера сторінки й від'ємним не буває. - Шаблон під
?>не змінюється:$pageEntries— той самий масив записів, а$entriesCount,$averageRatingі$foundCount— ті самі числа. filterEntries(),pageEntries(),averageRating()іnextId()уfunctions.phpсторінка більше не викликає: їхню роботу роблятьLIKE,LIMIT/OFFSET,AVG()іAUTO_INCREMENT. Самfunctions.phpу цьому кроці не змінюється.
- Перші два місця — це
-
delete.php,data.phpіentries.json. Уdelete.phpзамініть коментар надrequire_once:// Записи книги в MySQL: deleteEntry() — у src/guestbook/storage.phpі коментар над
deleteEntry(…):// Рядок зникає з таблиці entries, а отже — з книги в кожному браузеріЗаписи тепер живуть у таблиці, а стартові сім — у
database/seed.sql, тожdata.phpі файл записів більше не потрібні:git rm src/guestbook/data.php rm -f src/storage/entries.json grep -rn 'loadEntries\|saveEntries\|data\.php\|entries\.json' src/guestbook src/public/guestbookgit rmвидаляє файл і одразу додає видалення до наступного коміту.entries.jsonу git не потрапляв — його прибирає звичайнийrm.grepнічого не друкує: жодна сторінка книги не згадує ні файл записів, ніdata.php.- Каталог
src/storage/з.gitkeepі рядокsrc/storage/*.jsonу.gitignoreлишаються: місце для даних, які пише сам PHP, ще може знадобитися — наприклад, для журналу видалень із «Додатково» кроку 8.
-
Перевірка. Спершу в браузері:
- книга показує сім записів із
seed.sql— «7 записів, середня оцінка 3,9», імена й тексти кирилицею без кракозябр, дати — з секундами; - друга сторінка, пошук «ол» і порожній результат пошуку працюють, як у кроці 8;
- у пошук введіть
' OR '1'='1: «Нічого не знайдено» без помилки SQL, а в полі пошуку — той самий текст; - додайте запис в одному браузері й оновіть книгу в іншому: запис там теж нагорі. Увійдіть модератором (
knyha2026) і видаліть його; - на жодній сторінці немає
Warning,Notice,DeprecatedчиFatal error.
Далі з терміналу, з каталогу
intita-php, — два «браузери», файли cookiea.txtіb.txt, як у кроці 8. Перші дві команди повертають таблицю до семи записів ізseed.sql, тож новий запис отримаєid8: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 rm -f a.txt b.txt curl -s http://localhost:8080/guestbook/ | grep -E 'class="count"|<article' curl -s 'http://localhost:8080/guestbook/?page=2' | grep -E '<article|class="current"' curl -s -G --data-urlencode 'q=ол' http://localhost:8080/guestbook/ | grep -E 'class="count"|<article' curl -s -G --data-urlencode "q=' OR '1'='1" http://localhost:8080/guestbook/ | grep -E 'class="count"|<article|id="q"|SQLSTATE' curl -s -i -c a.txt -b a.txt -d "name=Тарас&message=Привіт усім&rating=4" http://localhost:8080/guestbook/ | grep -E '^HTTP|^Location' docker compose exec -T db sh -c 'mysql --default-character-set=utf8mb4 -t -uguestbook -p"$MYSQL_PASSWORD" guestbook -e "SELECT id, name, message, rating, created_at FROM entries WHERE id = 8"' curl -s -c b.txt -b b.txt http://localhost:8080/guestbook/ | grep -E 'class="flash"|class="count"|id="entry-8"' 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' docker compose exec -T db sh -c 'mysql --default-character-set=utf8mb4 -t -uguestbook -p"$MYSQL_PASSWORD" guestbook -e "SELECT COUNT(*) FROM entries"' curl -s -c b.txt -b b.txt http://localhost:8080/guestbook/ | grep -E 'class="count"|id="entry-8"'Друга сторінка — записи Андрія й Олени, пошук «ол» знаходить один запис, а пошук зловмисника — нічого: у полі
valueлапки екранованоe(), а до SQL рядок дійшов параметром. Після POST з A у таблиці є рядок зid8 — його показуєSELECTу консоліmysql, — і «браузер» B бачить цей запис, але без flash. Після входу модератора й видалення в таблиці знову сім рядків, і B бачить «7 записів». Вивід — в «Очікуваному результаті».Перевірте й код:
grep -n 'query(\|prepare(' src/guestbook/*.phpпоказує п'ять запитів уstorage.phpі ще рядок коментаря надquery(), а кожен запит — один рядок SQL у лапках: дані відвідувача потрапляють у запит лише параметрами:q,:limit,:offset,:name…, жодного' . $усередині SQL.Наостанок — книга без бази. Зупиніть сервіс
db, відкрийте книгу й подивіться журнал PHP:docker compose stop db curl -s -i http://localhost:8080/guestbook/ | grep -E '^HTTP|недоступна|SQLSTATE|PDOException' docker compose logs php | grep SQLSTATE docker compose start dbВідповідь —
503і одне речення: ніSQLSTATE, ніPDOExceptionдо відвідувача не доходять. Причину показує журнал — рядок зSQLSTATE[HY000] [2002]: сервераdbу мережі зараз немає. Післяdocker compose start dbкнига знову працює; якщо перший запит покаже повідомлення, повторіть його за кілька секунд. - книга показує сім записів із
-
Знайди помилку: спершу прогноз. Колега зробив сторінку пошуку записів книги — по три на сторінку, з адресою на кшталт
?q=ол&page=2. Підключення він написав сам, безdb(). У коді три помилки. Створіть тренувальний файлsrc/public/bugs-pdo.php— не в папціguestbook: це вправа, а не частина книги. Код дослівно:<?php declare(strict_types=1); // Тренувальна сторінка: пошук записів книги за ім'ям, по три на сторінку — ?q=…&page=… $dsn = 'mysql:host=' . getenv('DB_HOST') . ';dbname=' . getenv('DB_NAME'); $pdo = new PDO($dsn, getenv('DB_USER'), getenv('DB_PASSWORD'), [ PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC, ]); $q = trim($_GET['q'] ?? ''); $page = max(1, (int) ($_GET['page'] ?? 1)); $perPage = 3; // Скільки записів знайдено $found = $pdo->query("SELECT COUNT(*) AS total FROM entries WHERE name LIKE '%" . $q . "%'")->fetch(); echo 'Знайдено: ' . $found['total'] . "\n"; // Записи сторінки: найновіші першими $stmt = $pdo->prepare('SELECT name, rating FROM entries WHERE name LIKE :q ORDER BY created_at DESC LIMIT :limit OFFSET :offset'); $stmt->execute(['q' => '%' . $q . '%', 'limit' => $perPage, 'offset' => ($page - 1) * $perPage]); foreach ($stmt->fetchAll() as $row) { echo $row['name'] . ' — ' . $row['rating'] . "\n"; }Помилки ховаються одна за одною, тож працюйте колами:
- перед кожним колом допишіть у кінці
bugs-pdo.phpпрогноз — коментар// прогноз 1: …, потім// прогноз 2: …і// прогноз 3: …: що надрукує сторінка і чому. Рядки в кінці файлу не зсувають номери рядків у повідомленнях PHP; - після кола допишіть у прогноз
вгадавабоне вгадав: чому …, як у практиці кроку 8, і виправте одну помилку — ту, яку показало коло.
Коло 1 — сторінка без пошуку:
curl -s http://localhost:8080/bugs-pdo.phpВиправлення — як радить розділ «LIMIT і LIKE з параметрами» лекції і як у
findEntries()книги.Коло 2 — третя сторінка і пошук зловмисника:
curl -s 'http://localhost:8080/bugs-pdo.php?page=3' curl -s -G --data-urlencode "q=' OR '1'='1" http://localhost:8080/bugs-pdo.phpПрогноз: скільки записів «знайде» друга команда і скільки імен покаже? Виправлення — як у
countEntries()книги: SQL з параметром:q, а знаки%— у значенні (розділ «prepare() і execute()» лекції). Після виправлення друга команда друкуєЗнайдено: 0.Коло 3 — третя помилка сторінку не ламає: знайдіть її, порівнявши підключення колеги з
db()книги. Щоб побачити, яке кодування дістало з'єднання, допишіть під]);підключення два рядки перевірки:$charset = $pdo->query('SELECT @@character_set_connection AS charset')->fetch(); echo "Кодування з'єднання: " . $charset['charset'] . "\n";@@character_set_connection— змінна MySQL: кодування, у якому з'єднання передає рядки. Прогноз: що покаже перевірка і чи будуть імена кракозябрами?curl -s -G --data-urlencode 'q=ол' http://localhost:8080/bugs-pdo.phpВиправлення — як у
db():charset=utf8mb4у DSN. Без нього PDO бере кодування, яке пропонує сервер. MySQL 8.4 пропонуєutf8mb4, тож тут усе гаразд, але сервер з іншими налаштуваннями — скажімо, зlatin1, як за замовчуванням у MySQL 5.7, — віддав би замість імен знаки?, як консоль без прапорця в кроці 9. Зcharsetу DSN сторінка від налаштувань сервера не залежить. Після виправлення повторіть команду кола 3: вивід той самий. Наостанок повторіть команди кола 2: третя сторінка — та сама, а пошук зловмисника нічого не знаходить. - перед кожним колом допишіть у кінці
-
Зробіть коміт.
git statusпоказує зміненіdocker-compose.yml,.env.example,storage.php,index.phpіdelete.php, видаленийsrc/guestbook/data.phpі новіsrc/guestbook/db.phpтаsrc/public/bugs-pdo.php—.envсеред них немає. Даліgit add docker-compose.yml .env.example src/guestbook src/public/guestbook src/public/bugs-pdo.phpіgit commit -m "practice: guestbook entries in MySQL via PDO".
Порада
Документація PHP: PDO::prepare(), PDOStatement::bindValue(), PDOStatement::execute(), PDOStatement::fetchAll(), область видимості й статичні змінні, http_response_code(); Docker Compose — depends_on.
Важливо
Усе, що прийшло від відвідувача, потрапляє в SQL лише параметром — через prepare() і execute() або bindValue(), а LIMIT і OFFSET — з PDO::PARAM_INT. Пароль бази живе лише в .env, а текст помилки підключення — лише в журналі: відвідувач бачить загальне повідомлення.
Очікуваний результат
Книга в «браузері» B з перевірки (крок 8) — відповідь на GET після того, як A додав запис Тараса. Запис прийшов із таблиці entries, спільної для всіх браузерів, а дати — з секундами, як їх віддає MySQL (привітання й час запису у вас — свої):
Відповіді на команди й запити з кроків:
| Запит | Відповідь |
|---|---|
php -r 'var_dump(getenv(…));' у контейнері php (крок 2) |
string(2) "db" і string(9) "guestbook" |
| Перший GET | «7 записів, середня оцінка 3,9», п'ять записів — від Софії до Марії, кирилиця без кракозябр |
?page=2 |
записи Андрія й Олени, поточна сторінка — 2 |
?q=ол |
«Знайдено 1 запис» — запис Олени |
?q=' OR '1'='1 |
«Нічого не знайдено» без помилки SQL; у полі пошуку — той самий текст |
A: POST форми name=Тарас&message=Привіт усім&rating=4 |
303 See Other, Location: /guestbook/; у таблиці — рядок з id 8 |
| B: GET | «8 записів, середня оцінка 3,9», запис з id 8 нагорі; «Запис додано» немає |
A: вхід модератора і POST delete.php з id=8 |
303, Location: /guestbook/; у таблиці 7 рядків, B бачить «7 записів» без запису з id 8 |
docker compose stop db, потім GET |
503 Service Unavailable і «Гостьова книга тимчасово недоступна. Спробуйте пізніше.»; текст помилки — лише в журналі php |
- У жодній відповіді немає
Warning,Notice,DeprecatedчиFatal error. grepз кроку 7 нічого не друкує, аgit statusперед комітом не показує.env.
Вивід команд з перевірки (відступи — з шаблону, дата запису у вас — своя). Перший GET — сім записів, п'ять на першій сторінці:
<p class="count">7 записів, середня оцінка 3,9</p>
<article class="entry" id="entry-7">
<article class="entry" id="entry-6">
<article class="entry" id="entry-5">
<article class="entry" id="entry-4">
<article class="entry" id="entry-3">
Друга сторінка:
<article class="entry" id="entry-2">
<article class="entry" id="entry-1">
<span class="current">2</span>
Пошук «ол»:
<p class="count">7 записів, середня оцінка 3,9</p>
<p class="count">Знайдено 1 запис</p>
<article class="entry" id="entry-1">
Пошук зловмисника — у полі пошуку лапки екрановано, записів немає:
<p class="count">7 записів, середня оцінка 3,9</p>
<input type="search" id="q" name="q" value="' OR '1'='1">
<p class="count">Нічого не знайдено</p>
Відповідь на форму A:
HTTP/1.1 303 See Other
Location: /guestbook/
Рядок з id 8 у таблиці:
+----+------------+-----------------------+--------+---------------------+
| id | name | message | rating | created_at |
+----+------------+-----------------------+--------+---------------------+
| 8 | Тарас | Привіт усім | 4 | 2026-10-06 09:11:00 |
+----+------------+-----------------------+--------+---------------------+
«Браузер» B бачить запис з id 8, але без flash:
<p class="count">8 записів, середня оцінка 3,9</p>
<article class="entry" id="entry-8">
Вхід модератора й видалення відповідають однаково:
HTTP/1.1 303 See Other
Location: /guestbook/
У таблиці знову сім рядків:
+----------+
| COUNT(*) |
+----------+
| 7 |
+----------+
B після видалення:
<p class="count">7 записів, середня оцінка 3,9</p>
Книга з зупиненим db:
HTTP/1.1 503 Service Unavailable
Гостьова книга тимчасово недоступна. Спробуйте пізніше.
а в журналі PHP — причина (Compose додає перед рядком ім'я контейнера, кінець рядка у вас може бути інший):
NOTICE: PHP message: SQLSTATE[HY000] [2002] php_network_getaddresses: getaddrinfo for db failed: Name does not resolve
Сторінка bugs-pdo.php — звірте з прогнозами. Коло 1, до виправлень: підрахунок спрацював, а на записах сторінки PHP зупинився:
Знайдено: 7
<br />
<b>Fatal error</b>: Uncaught PDOException: SQLSTATE[42000]: Syntax error or access violation: 1064 You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near ''3' OFFSET '0'' at line 1 in /var/www/html/public/bugs-pdo.php:21
Stack trace:
#0 /var/www/html/public/bugs-pdo.php(21): PDOStatement->execute(Array)
#1 {main}
thrown in <b>/var/www/html/public/bugs-pdo.php</b> on line <b>21</b><br />
Коло 2, після першого виправлення. Третя сторінка:
Знайдено: 7
Олена — 4
Пошук зловмисника — підрахунок «знайшов» усі записи, а список, де пошук уже йде параметром, порожній:
Знайдено: 7
Після другого виправлення:
Знайдено: 0
Коло 3 — і до третього виправлення, і після нього:
Кодування з'єднання: utf8mb4
Знайдено: 1
Олена — 4
Критерії оцінювання
Роботу оцінюють за 10-бальною шкалою:
| Критерій | Бали |
|---|---|
Підключення (кроки 2–3): у php — DB_HOST: db, DB_NAME, DB_USER, DB_PASSWORD з .env і depends_on: db; db.php — одне з'єднання на запит, DSN з charset=utf8mb4, ERRMODE_EXCEPTION, FETCH_ASSOC; помилка підключення — у журнал, відвідувачу — 503 і повідомлення без деталей |
2 |
Запити (кроки 4–7): storage.php — кількість і середня оцінка, пошук LIKE з параметром, сторінка з LIMIT / OFFSET через bindValue() і PDO::PARAM_INT, addEntry(), deleteEntry(); кожен запит з даними — prepare() з параметрами, жодного SQL, склеєного зі змінних; index.php і delete.php працюють з базою; data.php видалено |
3 |
Книга на MySQL (крок 8): сім записів із seed.sql без кракозябр, сторінки й пошук — як у кроці 8, ' OR '1'='1 → «Нічого не знайдено», запис з одного браузера бачить інший, модератор видаляє рядок; на сторінках немає попереджень |
2 |
bugs-pdo.php (крок 9): прогноз до кожного кола, позначки вгадав / не вгадав: чому, три виправлення; вивід — як в «Очікуваному результаті» |
2 |
Коміт practice: guestbook entries in MySQL via PDO без .env |
1 |
| Разом | 10 |
Завдання з розділу «Додатково (*)» балів понад 10 не додає: воно може повернути до 2 балів, знятих за критеріями вище, але оцінка не перевищує 10.
Що здати
Посилання на коміт practice: guestbook entries in MySQL via PDO з такими змінами:
docker-compose.yml,.env.example;- новий
src/guestbook/db.php, зміненийsrc/guestbook/storage.php, видаленийsrc/guestbook/data.php; src/public/guestbook/index.php,delete.php;src/public/bugs-pdo.php.
.env з паролями в коміт не потрапляє. Або архів, якщо так домовлено на занятті. Будьте готові пояснити, звідки PHP бере адресу бази й пароль і чому DB_HOST — db; як db() тримає одне з'єднання на запит і що бачить відвідувач, коли бази немає; як підготовлений запит робить ' OR '1'='1 звичайним текстом і чому e() у шаблоні все одно потрібна; навіщо bindValue() з PDO::PARAM_INT; і яку роботу замість PHP тепер робить MySQL.
Додатково (*)
- Якір нового запису. Нехай
addEntry()повертаєidнового рядка: тип результату —int, а в кінці функції —return (int) db()->lastInsertId();(lastInsertId()повертає номер рядком — розділ «prepare() і execute()» лекції). Вindex.phpзбережіть його в змінну й перенаправте браузер до запису:header('Location: /guestbook/#entry-' . $id, true, 303);— кожен<article>маєid="entry-…", тож браузер прокрутить сторінку до нового запису. - Чесне повідомлення про видалення. Нехай
deleteEntry()повертаєbool—return $stmt->rowCount() === 1;. Уdelete.phpflash «Запис видалено» — лише коли рядок справді зник, інакше «Запису вже немає». Перевірте: надішліть POST наdelete.phpз тим самимidдвічі, як у кроці 8. - Знаки
%і_у пошуку. УLIKEзнак%означає «будь-які символи», а_— «будь-який один символ», тож?q=_знаходить усі сім записів, хоча знака_немає в жодному імені. Вбудована функціяaddcslashes($q, '%_\\')ставить\перед кожним%,_і самим\, і MySQL читає їх як звичайні символи. Застосуйте її до$qу значенні параметра вcountEntries()іfindEntries(): після цього?q=_дає «Нічого не знайдено».