Гостьова книга, крок 9: таблиця записів у MySQL
Мета
Підготувати для гостьової книги базу даних. У docker-compose.yml з'являється сервіс db з MySQL 8.4: паролі він бере з .env, дані тримає в іменованому томі, а порт назовні не відкриває. У каталозі database/ лежать три файли SQL: schema.sql створює таблицю entries, seed.sql заповнює її сімома записами книги, а queries.sql збирає запити, потрібні сторінці, — сторінки записів, кількість, середню оцінку, пошук, додавання й видалення. PHP-код у цьому кроці не змінюється: до MySQL сторінка під'єднається в кроці 10. Знаходити типові помилки SQL: рядок без лапок, DELETE без WHERE і кирилицю, записану без --default-character-set=utf8mb4.
Завдання
Продовжуємо проєкт із кроку 8 — практики «Гостьова книга, крок 8: записи у файлі JSON». Записи лежать у файлі entries.json: щоб показати п'ять записів, сторінка читає й розбирає весь файл, а два одночасні «прочитати → змінити → записати» можуть загубити запис. Шукати, рахувати й упорядковувати одночасні зміни вміє база даних. У цьому кроці ви запустите MySQL поруч із nginx і PHP і перенесете туди записи книги, а переключити на неї сторінку — завдання кроку 10.
Має вийти:
- сервіс
dbуdocker-compose.yml: образmysql:8.4, база й користувачguestbook, паролі зі змінних у.env, іменований томdb-dataдля даних, мережаintita, без опублікованого порту; .envз паролями — як і раніше, поза git, а в git — новий.env.exampleз назвами змінних і прикладом значень;database/schema.sql— таблицяentriesз полями запису книги,database/seed.sql— ті самі сім записів, що вdata.php,database/queries.sql— запити сторінки;- кожен запит із
queries.sqlдає результат з «Очікуваного результату», кирилиця в таблиці — без кракозябр, а записи переживаютьdocker compose downіdocker compose up -d.
intita-php/
├── .env ← паролі MySQL, у git не потрапляє
├── .env.example ← нове: зразок .env без справжніх паролів
├── .gitignore
├── docker-compose.yml ← сервіс db і том db-data
├── database/ ← нове: файли SQL для клієнта mysql
│ ├── schema.sql ← таблиця entries
│ ├── seed.sql ← сім записів книги
│ ├── queries.sql ← запити сторінки
│ └── bugs.sql ← вправа «Знайди помилку»
├── docker/
└── src/ ← без змін
Теорія — у лекціях «Бази даних і MySQL у Docker» і «SQL: SELECT, INSERT, UPDATE, DELETE». Сторінку книги до MySQL під'єднає модуль 15 «PHP + MySQL: CRUD через PDO»: запити з queries.sql надсилатиме вже PHP.
Кроки
-
Старт. Запустіть робочий проєкт
intita-php(docker compose up -d) і відкрийтеhttp://localhost:8080/guestbook/: книга кроку 8 працює й читає записи зsrc/storage/entries.json. PHP-файли в цьому кроці не змінюються — уся робота в корені проєкту, поруч ізdocker-compose.yml. Якщо в лекції «Бази даних і MySQL у Docker» ви вже додали сервісdbі паролі в.env, звірте їх із кроками 2–3. Таблиця справtasksз лекцій може лишитися в базі: книзі вона не заважає. -
Сервіс
db. Уdocker-compose.ymlдодайте після сервісуphpсервісdb:db: image: mysql:8.4 container_name: intita_db restart: unless-stopped environment: MYSQL_DATABASE: guestbook MYSQL_USER: guestbook MYSQL_PASSWORD: "${DB_PASSWORD}" MYSQL_ROOT_PASSWORD: "${DB_ROOT_PASSWORD}" volumes: - db-data:/var/lib/mysql # іменований том для даних networks: - intitaА в кінець файлу, після розділу
networks, — розділvolumes:volumes: db-data:dbстоїть на тому самому рівні, щоwebіphp, — з двома пробілами відступу;webіphpне змінюються.- На першому старті з порожнім томом образ створює базу
guestbookі користувачаguestbookз паролем ізMYSQL_PASSWORD, аMYSQL_ROOT_PASSWORDзадає пароль адміністратораroot. Значення${…}Compose підставляє з.env— крок 3. - Том
db-dataтримає файли бази в/var/lib/mysqlокремо від контейнера: контейнер можна видалити й створити знову, а дані лишаться — це перевірить крок 7. - Мережа
intita— та сама, що вwebіphp: у кроці 10 PHP знайде MySQL за ім'ям сервісуdb, порт 3306. Розділуportsнемає, тож ззовні до бази не дістатися.
-
Паролі:
.envі.env.example. Відкрийте.envу корені проєкту — на Linux у ньому вже єUIDіGIDз модуля 2 — і допишіть у кінець свої паролі. Файлу немає — створіть його з цими двома рядками:DB_PASSWORD=guestbook-secret DB_ROOT_PASSWORD=root-secretПоруч створіть
.env.example— зразок, який піде в git:# Зразок файлу .env: скопіюйте його в .env (cp .env.example .env) і задайте свої значення. # Сам .env записано в .gitignore — справжні паролі в git не потрапляють. # Лише Linux: UID і GID вашого користувача (id -u, id -g), якщо вони не 1000 UID=1000 GID=1000 # MySQL, сервіс db: пароль користувача guestbook і пароль root DB_PASSWORD=guestbook-secret DB_ROOT_PASSWORD=root-secret.envзаписано в.gitignoreще в модулі 2: паролі в git не потрапляють. Командаgit check-ignore -v .envпокаже правило —.gitignore:2:.env..env.example— для того, хто склонує проєкт: у ньому видно, які змінні потрібні. Зразок копіюють у.envкомандоюcp .env.example .envі задають свої значення. Справжніх паролів у зразку немає — лише приклад.- Наявний
.envзразком не перезаписуйте: на Linux у ньому вашіUIDіGID. - Перевірка:
docker compose config --quietнічого не друкує. ПопередженняThe "DB_PASSWORD" variable is not set. Defaulting to a blank string.означає, що Compose не знайшов змінну в.env.
Запустіть сервіс і перевірте його:
docker compose up -d docker compose ps docker compose logs dbdocker compose psпоказує три контейнери:intita,intita_phpіintita_db. У стовпціPORTSдляintita_db—3306/tcp, 33060/tcp, без0.0.0.0:…->: ці порти відкриті лише всередині мережіintita.- Перший старт довший: дочекайтеся в
docker compose logs dbрядка зready for connectionsіport: 3306. - Змінні
MYSQL_*діють лише на першому старті. Якщоdbуже працював з іншим паролем і команди з кроку 4 відповідаютьAccess denied for user 'guestbook', поверніть у.envстарий пароль або почніть з порожнього тому:docker compose down -vвидаляє контейнери разом із томами — і всіма даними бази, — аdocker compose up -dстворить базу заново.
-
Таблиця:
schema.sql. Створіть у корені проєкту каталогdatabase/— поруч ізdocker-compose.yml, а не вsrc/: ці файли читає клієнтmysql, а не nginx чи PHP. У ньому —database/schema.sql:-- database/schema.sql — таблиця записів гостьової книги. -- Увага: файл спершу видаляє таблицю entries разом з усіма записами — так можна почати з чистого аркуша DROP TABLE IF EXISTS entries; CREATE TABLE entries ( id INT UNSIGNED AUTO_INCREMENT PRIMARY KEY, name VARCHAR(50) NOT NULL, message VARCHAR(500) NOT NULL, rating TINYINT UNSIGNED NOT NULL, created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ) CHARACTER SET utf8mb4;DROP TABLE IF EXISTS entries— нова команда: вона видаляє таблицю разом з усіма рядками, аIF EXISTSприбирає помилку, коли таблиці ще немає. Томуschema.sqlможна запустити знову й почати з чистого аркуша — і тому його не запускають там, де записи ще потрібні.- Стовпці — це поля запису книги з модуля 8, а розміри — межі перевірки з модуля 11: ім'я до 50 символів, текст до 500, оцінка — ціле від 1 до 5.
TINYINT UNSIGNEDвміщає числа від 0 до 255, тобто з запасом.NOT NULLробить кожне поле обов'язковим, як і у формі. id INT UNSIGNED AUTO_INCREMENT PRIMARY KEY— номер запису видає MySQL. Це якnextId()у PHP, лише без повторів:nextId()бере найбільший номер + 1, тож після видалення останнього запису видав би його номер удруге, аAUTO_INCREMENTномерів не повторює.created_at DATETIME … DEFAULT CURRENT_TIMESTAMP— дата й час запису: не передали — MySQL візьме поточні. Годинник MySQL у контейнері йде за UTC, як пояснює розділ «INSERT: додати рядки» лекції.CHARACTER SET utf8mb4— повний UTF-8: кирилиця й емодзі.
Виконайте файл командою з розділу «Запити з файлу .sql» лекції і подивіться на будову таблиці:
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 -t -uguestbook -p"$MYSQL_PASSWORD" guestbook -e "DESCRIBE entries"'- Перша команда друкує лише попередження
mysql: [Warning] Using a password on the command line interface can be insecure.Такmysqlвідповідає на кожну команду з паролем у рядку, тож далі ми його не згадуємо. -e "…"виконує один запит і виходить — без файлу й без консолі. ВивідDESCRIBE— в «Очікуваному результаті».- У Windows PowerShell оператора
<немає: виконуйте ці команди в Git Bash або терміналі WSL.
-
Записи:
seed.sql. Перенесіть сім записів ізsrc/guestbook/data.phpуdatabase/seed.sql:-- database/seed.sql — сім записів гостьової книги, ті самі, що в src/guestbook/data.php. -- Запускати на свіжій таблиці, одразу після schema.sql: записи отримають id від 1 до 7 INSERT INTO entries (name, message, rating, created_at) VALUES ('Олена', 'Дуже корисне заняття! Нарешті зрозуміла, що таке DOM.', 4, '2026-09-14 10:15:00'), ('Андрій', 'Зробив свою першу сторінку на PHP, і вона запрацювала з першого разу!', 5, '2026-09-16 19:40:00'), ('Марія', 'Цікаво, але темп швидкий: розбиралася з циклами весь вечір.', 3, '2026-09-21 08:05:00'), ('Тарас', 'Гостьова книга — чудова ідея, хочу таку саму для свого сайту.', 5, '2026-09-25 17:30:00'), ('Ірина', 'Docker так і не запустився з першого разу. Хотілося б більше прикладів.', 2, '2026-09-28 21:10:00'), ('Богдан', 'Масиви виявилися простішими, ніж я думав.', 4, '2026-10-01 12:45:00'), ('Софія', 'Дякую за заняття! Найкорисніше — розбір помилок.', 4, '2026-10-03 09:20:00');docker compose exec -T db sh -c 'mysql --default-character-set=utf8mb4 -uguestbook -p"$MYSQL_PASSWORD" guestbook' < database/seed.sql- Порядок той самий, що в
data.php, — від найстаршого.idне передаємо: на свіжій таблиці післяschema.sqlAUTO_INCREMENTвидасть номери від 1 до 7, як уdata.php. - Рядки — в одинарних лапках. Дату
DATETIMEрозуміє у форматі рік-місяць-день:'2026-09-14 10:15:00'— це2026-09-14 10:15зdata.phpіз секундами. Якщо в тексті трапиться апостроф, його подвоюють —'п''ять': одна одинарна лапка закрила б рядок. - Прапорець
--default-character-set=utf8mb4тут головний: без нього клієнт прочитає файл уlatin1, і кирилиця ляже в таблицю кракозябрами — як саме, покаже крок 8. seed.sql, запущений удруге безschema.sql, дасть 14 записів:INSERTлише додає. Свіжий старт — завжди обидва файли: спершуschema.sql, потімseed.sql.
- Порядок той самий, що в
-
Запити сторінки:
queries.sql. Зберіть уdatabase/queries.sqlзапити, які потрібні сторінці книги:-- database/queries.sql — запити сторінки гостьової книги; у кроці 10 їх надсилатиме PHP. -- Запускати на свіжій таблиці (schema.sql + seed.sql): INSERT дасть новому запису id 8, а DELETE його прибере -- Сторінка 1: п'ять найновіших записів SELECT id, name, message, rating, created_at FROM entries ORDER BY created_at DESC LIMIT 5 OFFSET 0; -- Сторінка 2: OFFSET пропускає записи сторінки 1 SELECT id, name, message, rating, created_at FROM entries ORDER BY created_at DESC LIMIT 5 OFFSET 5; -- Підпис над записами: скільки їх і середня оцінка SELECT COUNT(*), AVG(rating) FROM entries; -- Пошук за ім'ям: «ар» будь-де в імені, без різниці великих і малих літер SELECT id, name, message, rating, created_at FROM entries WHERE name LIKE '%ар%' ORDER BY created_at DESC; -- Новий запис: id і created_at MySQL заповнить сам INSERT INTO entries (name, message, rating) VALUES ('Тарас', 'Привіт усім', 4); -- Видалення запису модератором — за первинним ключем DELETE FROM entries WHERE id = 8;- Сторінки:
$perPage = 5вindex.php— цеLIMIT 5, а сторінка N пропускає записи попередніх сторінок:OFFSET(N − 1) × 5. Друга сторінка —OFFSET 5, третя —OFFSET 10. COUNT(*)іAVG(rating)— підпис «7 записів, середня оцінка 3,9». MySQL дає3.8571: до одного знака й з комою число округлитьnumber_format()на сторінці, як і зараз.- Пошук:
filterEntries()шукаєqбудь-де в імені без різниці регістру черезmb_stripos(), а SQL — черезLIKE '%…%': великих і малих літерutf8mb4не розрізняє. INSERT— це форма «Новий запис», аDELETE … WHERE id = …— кнопка «Видалити» модератора: рівно один рядок за первинним ключем.
Виконайте файл із прапорцем
-vvv— «дуже докладно»:mysqlдрукує кожен запит і відповідь на нього, як у консолі, разом ізQuery OK, 1 row affectedдляINSERTіDELETE:docker compose exec -T db sh -c 'mysql --default-character-set=utf8mb4 -vvv -uguestbook -p"$MYSQL_PASSWORD" guestbook' < database/queries.sqlЗвірте відповіді з «Очікуваним результатом». Коментарі
-- …з-vvvmysqlтеж друкує, і після кожного стоїтьQuery OK, 0 rows affected: коментар рядків не змінює. Запускайтеqueries.sqlна свіжій таблиці — післяschema.sqlіseed.sql. Якщо запустити його вдруге поспіль, новий запис отримаєid9:AUTO_INCREMENTномерів не повторює, іDELETE FROM entries WHERE id = 8відповістьQuery OK, 0 rows affected. - Сторінки:
-
Дані в томі. Зупиніть стек і запустіть знову:
docker compose down docker compose up -d docker compose exec -T db sh -c 'mysql --default-character-set=utf8mb4 -t -uguestbook -p"$MYSQL_PASSWORD" guestbook -e "SELECT COUNT(*) FROM entries"' docker volume lsdocker compose downвидалив контейнери й мережу, аup -dстворив їх заново, протеSELECT COUNT(*)показує стільки ж записів, скільки було, — після кроку 6 це 7: файли бази лежать у томі, а не в контейнері. ВідповідьCan't connect to local MySQL serverозначає, що MySQL ще стартує: повторіть команду за кілька секунд.docker volume lsпоказує томintita-php_db-data: до імені тому Compose додає назву проєкту — каталогу зdocker-compose.yml.- Том разом з усіма записами видаляє лише
docker compose down -v.
-
Знайди помилку: спершу прогноз. Колега написав файл, що додає тестовий запис, шукає записи Олени й прибирає тестовий запис. Створіть
database/bugs.sql, код дослівно:-- database/bugs.sql — вправа «Знайди помилку»: файл колеги -- Тестовий запис: чи працює вставка INSERT INTO entries (name, message, rating) VALUES ('Тест', 'Перевірка вставки', 1); -- Записи Олени SELECT id, name, rating FROM entries WHERE name = Олена; -- Прибрати тестовий запис і перевірити, скільки записів лишилося DELETE FROM entries; SELECT COUNT(*) FROM entries;А таблицю колега наповнює своєю командою:
docker compose exec -T db sh -c 'mysql -uguestbook -p"$MYSQL_PASSWORD" guestbook' < database/seed.sqlУ файлі дві помилки, а в команді — третя. Працюйте колами. Кожне коло починається зі свіжої таблиці —
schema.sqlіseed.sqlвашою командою з кроків 4–5: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- перед кожним колом допишіть у кінці
bugs.sqlпрогноз — коментар-- прогноз 1: …, потім-- прогноз 2: …і-- прогноз 3: …: що надрукуєmysqlі чому. Рядки в кінці файлу не зсувають номери рядків у повідомленнях MySQL; - після кола допишіть у прогноз
вгадавабоне вгадав: чому …, як у практиці кроку 8, і виправте одну помилку — ту, яку показало коло.
Коло 1 — свіжа таблиця і файл колеги, запущений вашою командою:
docker compose exec -T db sh -c 'mysql --default-character-set=utf8mb4 -t -uguestbook -p"$MYSQL_PASSWORD" guestbook' < database/bugs.sqlВиправлення — як радить розділ «SELECT: знайти потрібне» лекції: рядок у SQL пишуть у лапках.
Коло 2 — свіжа таблиця і та сама команда. Прогноз: скільки рядків зникне на
DELETEі що покажеCOUNT(*)? Виправлення — як радить розділ «UPDATE і DELETE — лише з WHERE» лекції: на свіжій таблиці тестовий запис отримуєid8 — прибирайте рівно його, за первинним ключем. Після виправлення повторіть коло 2:SELECTзнаходить запис Олени, аCOUNT(*)показує 7.Коло 3 — команда колеги. Виконайте
schema.sqlсвоєю командою, аseed.sql— командою колеги. Потім подивіться на перший запис двічі — з прапорцем і без:docker compose exec -T db sh -c 'mysql --default-character-set=utf8mb4 -t -uguestbook -p"$MYSQL_PASSWORD" guestbook -e "SELECT id, name, rating FROM entries WHERE id = 1"' docker compose exec -T db sh -c 'mysql -t -uguestbook -p"$MYSQL_PASSWORD" guestbook -e "SELECT id, name, rating FROM entries WHERE id = 1"'Прогноз: що покаже кожна з двох команд? Виправлення — прапорець, як радить розділ «MySQL у Docker Compose» лекції. Наповніть таблицю знову —
schema.sqlіseed.sqlвашою командою — і повторіть обидві перевірки. PHP, який у модулі 15 читатиме таблицю зcharset=utf8mb4, бачить те саме, що консоль із прапорцем. Після цього кола в таблиці знову сім записів ізseed.sql— такою її чекає крок 10. - перед кожним колом допишіть у кінці
-
Зробіть коміт.
git statusпоказує зміненийdocker-compose.ymlі нові.env.exampleтаdatabase/—.envсеред них немає. Даліgit add docker-compose.yml .env.example databaseіgit commit -m "practice: guestbook entries table in MySQL".
Порада
Документація: образ mysql на Docker Hub — змінні MYSQL_* і том /var/lib/mysql; MySQL 8.4 — CREATE TABLE, DROP TABLE, INSERT, SELECT, DELETE.
Важливо
Паролі живуть лише в .env, а в git іде .env.example. Кожна команда mysql — з --default-character-set=utf8mb4. UPDATE і DELETE пишуть із WHERE за id, а schema.sql запускають, лише щоб почати з чистого аркуша: він видаляє таблицю разом із записами.
Очікуваний результат
PHP-код у кроці 9 не змінювався, тож сторінка книги та сама, що в кроці 8: записи вона поки бере з entries.json. Після docker compose up -d із новим сервісом db перший візит виглядає так (привітання у вас — своє):
Відповіді на команди з кроків:
| Команда | Відповідь |
|---|---|
docker compose config --quiet з паролями в .env |
нічого |
docker compose ps |
три контейнери; в intita_db у стовпці PORTS — 3306/tcp, 33060/tcp, без 0.0.0.0:…-> |
schema.sql і seed.sql вашою командою |
лише попередження mysql: [Warning] Using a password on the command line interface can be insecure. |
queries.sql на свіжій таблиці |
сторінки з п'яти й двох записів, 7 і 3.8571, Тарас і Марія в пошуку, Query OK, 1 row affected для INSERT і DELETE |
SELECT COUNT(*) після docker compose down і docker compose up -d |
7 |
Будова таблиці — DESCRIBE entries з кроку 4:
+------------+------------------+------+-----+-------------------+-------------------+
| Field | Type | Null | Key | Default | Extra |
+------------+------------------+------+-----+-------------------+-------------------+
| id | int unsigned | NO | PRI | NULL | auto_increment |
| name | varchar(50) | NO | | NULL | |
| message | varchar(500) | NO | | NULL | |
| rating | tinyint unsigned | NO | | NULL | |
| created_at | datetime | NO | | CURRENT_TIMESTAMP | DEFAULT_GENERATED |
+------------+------------------+------+-----+-------------------+-------------------+
Відповіді на queries.sql з кроку 6 — по черзі, без тексту запитів (час виконання у вас свій). Сторінка 1:
+----+--------------+-----------------------------------------------------------------------------------------------------------------------------+--------+---------------------+
| id | name | message | rating | created_at |
+----+--------------+-----------------------------------------------------------------------------------------------------------------------------+--------+---------------------+
| 7 | Софія | Дякую за заняття! Найкорисніше — розбір помилок. | 4 | 2026-10-03 09:20:00 |
| 6 | Богдан | Масиви виявилися простішими, ніж я думав. | 4 | 2026-10-01 12:45:00 |
| 5 | Ірина | Docker так і не запустився з першого разу. Хотілося б більше прикладів. | 2 | 2026-09-28 21:10:00 |
| 4 | Тарас | Гостьова книга — чудова ідея, хочу таку саму для свого сайту. | 5 | 2026-09-25 17:30:00 |
| 3 | Марія | Цікаво, але темп швидкий: розбиралася з циклами весь вечір. | 3 | 2026-09-21 08:05:00 |
+----+--------------+-----------------------------------------------------------------------------------------------------------------------------+--------+---------------------+
5 rows in set (0.00 sec)
Сторінка 2:
+----+--------------+----------------------------------------------------------------------------------------------------------------------------+--------+---------------------+
| id | name | message | rating | created_at |
+----+--------------+----------------------------------------------------------------------------------------------------------------------------+--------+---------------------+
| 2 | Андрій | Зробив свою першу сторінку на PHP, і вона запрацювала з першого разу! | 5 | 2026-09-16 19:40:00 |
| 1 | Олена | Дуже корисне заняття! Нарешті зрозуміла, що таке DOM. | 4 | 2026-09-14 10:15:00 |
+----+--------------+----------------------------------------------------------------------------------------------------------------------------+--------+---------------------+
2 rows in set (0.00 sec)
Кількість і середня оцінка:
+----------+-------------+
| COUNT(*) | AVG(rating) |
+----------+-------------+
| 7 | 3.8571 |
+----------+-------------+
1 row in set (0.00 sec)
Пошук «ар»:
+----+------------+-----------------------------------------------------------------------------------------------------------------+--------+---------------------+
| id | name | message | rating | created_at |
+----+------------+-----------------------------------------------------------------------------------------------------------------+--------+---------------------+
| 4 | Тарас | Гостьова книга — чудова ідея, хочу таку саму для свого сайту. | 5 | 2026-09-25 17:30:00 |
| 3 | Марія | Цікаво, але темп швидкий: розбиралася з циклами весь вечір. | 3 | 2026-09-21 08:05:00 |
+----+------------+-----------------------------------------------------------------------------------------------------------------+--------+---------------------+
2 rows in set (0.00 sec)
INSERT і DELETE — по одному рядку:
Query OK, 1 row affected (0.00 sec)
Query OK, 1 row affected (0.00 sec)
Файл bugs.sql — звірте з прогнозами. Коло 1: INSERT спрацював мовчки, а на рядку 5 mysql зупинився:
ERROR 1054 (42S22) at line 5: Unknown column 'Олена' in 'where clause'
Коло 2, після першого виправлення — запис Олени знайдено, але таблиця порожня:
+----+------------+--------+
| id | name | rating |
+----+------------+--------+
| 1 | Олена | 4 |
+----+------------+--------+
+----------+
| COUNT(*) |
+----------+
| 0 |
+----------+
Після другого виправлення:
+----+------------+--------+
| id | name | rating |
+----+------------+--------+
| 1 | Олена | 4 |
+----+------------+--------+
+----------+
| COUNT(*) |
+----------+
| 7 |
+----------+
Коло 3, seed.sql командою колеги. Перевірка з прапорцем:
+----+----------------------+--------+
| id | name | rating |
+----+----------------------+--------+
| 1 | Олена | 4 |
+----+----------------------+--------+
Без прапорця — ніби все гаразд:
+----+------------+--------+
| id | name | rating |
+----+------------+--------+
| 1 | Олена | 4 |
+----+------------+--------+
Після виправлення, коли seed.sql виконано вашою командою, з прапорцем:
+----+------------+--------+
| id | name | rating |
+----+------------+--------+
| 1 | Олена | 4 |
+----+------------+--------+
а без прапорця:
+----+-------+--------+
| id | name | rating |
+----+-------+--------+
| 1 | ????? | 4 |
+----+-------+--------+
Критерії оцінювання
Роботу оцінюють за 10-бальною шкалою:
| Критерій | Бали |
|---|---|
Сервіс db і паролі (кроки 2–3): mysql:8.4, база й користувач guestbook, паролі з .env через ${…}, том db-data, мережа intita, без ports; .env.example з назвами змінних і прикладом значень; .env поза git |
3 |
Таблиця й записи (кроки 4–5): schema.sql — utf8mb4, типи й розміри полів, AUTO_INCREMENT PRIMARY KEY, DEFAULT CURRENT_TIMESTAMP; seed.sql — сім записів із data.php з id від 1 до 7, кирилиця без кракозябр |
2 |
Запити сторінки (кроки 6–7): queries.sql — дві сторінки з LIMIT / OFFSET, COUNT(*) і AVG(rating), пошук LIKE, INSERT, DELETE за id; відповіді — як в «Очікуваному результаті»; записи переживають docker compose down і up -d |
2 |
bugs.sql (крок 8): прогноз до кожного кола, позначки вгадав / не вгадав: чому, два виправлення у файлі й прапорець у команді |
2 |
Коміт practice: guestbook entries table in MySQL без .env |
1 |
| Разом | 10 |
Завдання з розділу «Додатково (*)» балів понад 10 не додає: воно може повернути до 2 балів, знятих за критеріями вище, але оцінка не перевищує 10.
Що здати
Посилання на коміт practice: guestbook entries table in MySQL з такими файлами:
docker-compose.yml,.env.example;database/schema.sql,database/seed.sql,database/queries.sql,database/bugs.sql.
.env з паролями в коміт не потрапляє. Або архів, якщо так домовлено на занятті. Будьте готові пояснити, навіщо паролі в .env, а в git — .env.example; що зберігає том db-data і чому порт MySQL не опубліковано; чому стовпці таблиці мають саме такі типи й розміри; як LIMIT і OFFSET відповідають номеру сторінки; чому schema.sql видаляє таблицю, а DELETE пишуть лише з WHERE за id; і що станеться з кирилицею без --default-character-set=utf8mb4.
Додатково (*)
-
Порт для IDE. Щоб переглядати таблицю в IDE (PhpStorm → Database, розширення для VS Code чи DBeaver), опублікуйте порт MySQL лише для свого комп'ютера. Додайте в сервіс
db:ports: - "127.0.0.1:3306:3306"і виконайте
docker compose up -d.127.0.0.1:відкриває порт лише на вашому комп'ютері, а не для всієї мережі. Підключення в IDE: хост127.0.0.1, порт3306, база й користувачguestbook, пароль —DB_PASSWORDз.env. Якщо порт 3306 уже зайнятий — на комп'ютері встановлено свій MySQL, — візьміть"127.0.0.1:3307:3306"і порт3307в IDE.docker compose psтепер показує дляintita_db127.0.0.1:3306->3306/tcp. -
Модератор виправляє запис. Допишіть у кінець
queries.sqlзапит, що змінює текст запису зid3 на ваш: спершуSELECTіз тією самою умовою, потімUPDATE entries SET message = '…' WHERE id = 3;. MySQL має відповістиRows matched: 1 Changed: 1. Такий запит знадобиться, якщо в підсумковому проєкті ви оберете розширення «редагування запису модератором». -
Середня, як на сторінці. Сторінка показує середню оцінку з одним знаком — «3,9». Функція SQL
ROUND(число, знаки)округлює так само: допишіть уqueries.sqlзапитSELECT COUNT(*), ROUND(AVG(rating), 1) FROM entries;і перевірте, що на свіжій таблиці він повертає3.9. Кому замість крапки MySQL не ставить — це роботаnumber_format()у PHP.