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

Гостьова книга, крок 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 «Підсумковий міні-проєкт»: там книга отримає ваше власне розширення.

Кроки

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

  2. Змінні підключення. У 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 він запам'ятовує на старті.

  3. 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 ще до шапки, тож повідомлення — уся відповідь, без половини сторінки над ним.
  4. 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, і так її покаже сторінка.
  5. 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.
  6. 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 у цьому кроці не змінюється.
  7. 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/guestbook
    
    • git rm видаляє файл і одразу додає видалення до наступного коміту. entries.json у git не потрапляв — його прибирає звичайний rm.
    • grep нічого не друкує: жодна сторінка книги не згадує ні файл записів, ні data.php.
    • Каталог src/storage/ з .gitkeep і рядок src/storage/*.json у .gitignore лишаються: місце для даних, які пише сам PHP, ще може знадобитися — наприклад, для журналу видалень із «Додатково» кроку 8.
  8. Перевірка. Спершу в браузері:

    • книга показує сім записів із seed.sql — «7 записів, середня оцінка 3,9», імена й тексти кирилицею без кракозябр, дати — з секундами;
    • друга сторінка, пошук «ол» і порожній результат пошуку працюють, як у кроці 8;
    • у пошук введіть ' OR '1'='1: «Нічого не знайдено» без помилки SQL, а в полі пошуку — той самий текст;
    • додайте запис в одному браузері й оновіть книгу в іншому: запис там теж нагорі. Увійдіть модератором (knyha2026) і видаліть його;
    • на жодній сторінці немає Warning, Notice, Deprecated чи Fatal error.

    Далі з терміналу, з каталогу intita-php, — два «браузери», файли cookie a.txt і b.txt, як у кроці 8. Перші дві команди повертають таблицю до семи записів із seed.sql, тож новий запис отримає id 8:

    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 у таблиці є рядок з id 8 — його показує 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 книга знову працює; якщо перший запит покаже повідомлення, повторіть його за кілька секунд.

  9. Знайди помилку: спершу прогноз. Колега зробив сторінку пошуку записів книги — по три на сторінку, з адресою на кшталт ?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: третя сторінка — та сама, а пошук зловмисника нічого не знаходить.

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

Важливо

Усе, що прийшло від відвідувача, потрапляє в 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="&#039; OR &#039;1&#039;=&#039;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-&gt;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.

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

  1. Якір нового запису. Нехай addEntry() повертає id нового рядка: тип результату — int, а в кінці функції — return (int) db()->lastInsertId(); (lastInsertId() повертає номер рядком — розділ «prepare() і execute()» лекції). В index.php збережіть його в змінну й перенаправте браузер до запису: header('Location: /guestbook/#entry-' . $id, true, 303); — кожен <article> має id="entry-…", тож браузер прокрутить сторінку до нового запису.
  2. Чесне повідомлення про видалення. Нехай deleteEntry() повертає bool — return $stmt->rowCount() === 1;. У delete.php flash «Запис видалено» — лише коли рядок справді зник, інакше «Запису вже немає». Перевірте: надішліть POST на delete.php з тим самим id двічі, як у кроці 8.
  3. Знаки % і _ у пошуку. У LIKE знак % означає «будь-які символи», а _ — «будь-який один символ», тож ?q=_ знаходить усі сім записів, хоча знака _ немає в жодному імені. Вбудована функція addcslashes($q, '%_\\') ставить \ перед кожним %, _ і самим \, і MySQL читає їх як звичайні символи. Застосуйте її до $q у значенні параметра в countEntries() і findEntries(): після цього ?q=_ дає «Нічого не знайдено».