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

Гостьова книга, крок 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.

Кроки

  1. Старт. Запустіть робочий проєкт 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 з лекцій може лишитися в базі: книзі вона не заважає.

  2. Сервіс 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 немає, тож ззовні до бази не дістатися.
  3. Паролі: .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 db
    
    • docker 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 створить базу заново.
  4. Таблиця: 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.
  5. Записи: 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.sql AUTO_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.
  6. Запити сторінки: 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
    

    Звірте відповіді з «Очікуваним результатом». Коментарі -- … з -vvv mysql теж друкує, і після кожного стоїть Query OK, 0 rows affected: коментар рядків не змінює. Запускайте queries.sql на свіжій таблиці — після schema.sql і seed.sql. Якщо запустити його вдруге поспіль, новий запис отримає id 9: AUTO_INCREMENT номерів не повторює, і DELETE FROM entries WHERE id = 8 відповість Query OK, 0 rows affected.

  7. Дані в томі. Зупиніть стек і запустіть знову:

    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 ls
    
    • docker 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.
  8. Знайди помилку: спершу прогноз. Колега написав файл, що додає тестовий запис, шукає записи Олени й прибирає тестовий запис. Створіть 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» лекції: на свіжій таблиці тестовий запис отримує id 8 — прибирайте рівно його, за первинним ключем. Після виправлення повторіть коло 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.

  9. Зробіть коміт. 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.

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

  1. Порт для 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_db 127.0.0.1:3306->3306/tcp.

  2. Модератор виправляє запис. Допишіть у кінець queries.sql запит, що змінює текст запису з id 3 на ваш: спершу SELECT із тією самою умовою, потім UPDATE entries SET message = '…' WHERE id = 3;. MySQL має відповісти Rows matched: 1 Changed: 1. Такий запит знадобиться, якщо в підсумковому проєкті ви оберете розширення «редагування запису модератором».

  3. Середня, як на сторінці. Сторінка показує середню оцінку з одним знаком — «3,9». Функція SQL ROUND(число, знаки) округлює так само: допишіть у queries.sql запит SELECT COUNT(*), ROUND(AVG(rating), 1) FROM entries; і перевірте, що на свіжій таблиці він повертає 3.9. Кому замість крапки MySQL не ставить — це робота number_format() у PHP.