Перейти до змісту
Intita
Лекція · 35 хв

PDO: підключення до MySQL і читання даних

Що ви дізнаєтесь

  • Що таке PDO і як сторінка PHP під'єднується до MySQL
  • Чому логін і пароль беруть зі змінних оточення
  • Як прочитати всі рядки запиту або лише один
  • Що означають could not find driver, Connection refused і Access denied і чому текст помилки не показують відвідувачам

У модулі 14 «Бази даних і SQL» запити до MySQL ви писали в консолі mysql, а тепер їх надсилатиме сторінка PHP. Тренуємося на таблиці справ tasks з лекції «SQL: SELECT, INSERT, UPDATE, DELETE»: у ній п'ять справ з id від 1 до 5, і не виконано лише справи 3 і 4.

PDO і змінні оточення

PDO (PHP Data Objects) — вбудований у PHP спосіб працювати з базами даних: ті самі функції для MySQL, PostgreSQL чи SQLite, а з конкретною базою говорить драйвер. Драйвер pdo_mysql уже є в образі php: його ставить рядок docker-php-ext-install pdo_mysql у Dockerfile з лекції «Docker і Docker Compose».

Логін і пароль, записані в коді, потрапили б у Git. Тому їх, як і паролі сервісу db, беруть з .env, а Compose передає їх у контейнер php як змінні оточення — розділ environment у docker-compose.yml:

  php:
    # build, image, volumes — без змін
    environment:
      DB_HOST: db
      DB_NAME: guestbook
      DB_USER: guestbook
      DB_PASSWORD: "${DB_PASSWORD}"

Після docker compose up -d Compose перестворить контейнер php, і PHP прочитає змінні вбудованою функцією getenv(): getenv('DB_HOST') повертає рядок 'db', а для змінної, якої немає, — false. Підключення на сторінці src/public/tasks.php:

<?php
// src/public/tasks.php — справи з таблиці tasks
$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,
];
$pdo = new PDO($dsn, getenv('DB_USER'), getenv('DB_PASSWORD'), $options);
  • DSN (Data Source Name) — рядок «куди під'єднатися»: драйвер mysql:, а далі через ; — сервер host=db (ім'я сервісу в мережі intita), база dbname=guestbook і кодування charset=utf8mb4. MySQL 8.4 і без charset обрав би utf8mb4, бо так налаштовано сервер, але явне кодування від налаштувань сервера не залежить — як прапорець --default-character-set=utf8mb4 у консолі.
  • new PDO(…) створює об'єкт — значення, що тримає відкрите з'єднання й має власні функції, методи. Метод викликають через ->: $pdo->query(…).
  • PDO::ATTR_ERRMODE і решта — константи PDO. ERRMODE_EXCEPTION: помилка бази стає винятком і зупиняє скрипт, як JsonException у лекції «JSON: json_encode і json_decode»; у PHP 8 це й так поведінка за замовчуванням, але явний параметр видно в коді. FETCH_ASSOC: рядки приходять асоціативними масивами, де ключі — імена стовпців.

Читання: query(), fetchAll() і fetch()

Допишіть у кінець tasks.php:

$tasks = $pdo->query('SELECT id, title, minutes FROM tasks WHERE done = 0')->fetchAll();
print_r($tasks);

$stats = $pdo->query('SELECT COUNT(*) AS total, AVG(minutes) AS average FROM tasks')->fetch();
echo 'Справ: ' . $stats['total'] . ', у середньому ' . $stats['average'] . " хв\n";

var_dump($pdo->query('SELECT title FROM tasks WHERE id = 6')->fetch());

Відповідь сторінки (curl -s http://localhost:8080/tasks.php):

Array
(
    [0] => Array
        (
            [id] => 3
            [title] => Вивчити SQL
            [minutes] => 40
        )

    [1] => Array
        (
            [id] => 4
            [title] => Оновити резюме
            [minutes] => 60
        )

)
Справ: 5, у середньому 29.0000 хв
bool(false)
  • query($sql) надсилає запит і повертає результат — ще один об'єкт зі своїми методами.
  • fetchAll() віддає всі рядки масивом записів, як $entries гостьової книги, — його обходять foreach.
  • fetch() віддає наступний рядок, а коли рядків більше немає — false. Він зручний, коли рядок один: підсумок COUNT(*) чи запис за id. Справу 6 видалили ще в модулі 14, тож останній запит повернув false.
  • AS total дає стовпцю результату ім'я — воно й стане ключем масиву; без AS ключем був би COUNT(*).
  • Цілі числа приходять типом int, а результат AVG() — рядком '29.0000'.
$pdo створено без параметра PDO::ATTR_DEFAULT_FETCH_MODE. Які ключі матиме масив $row у коді нижче?
<?php
$row = $pdo->query('SELECT id, title FROM tasks WHERE id = 1')->fetch();

Помилки: try і catch

Якщо підключитися не вдалося, new PDO() кидає виняток PDOException. Без обробки сторінка зупиняється, і з php.ini-development відвідувач бачить усе. Ось відповідь із хибним паролем у .env:

Fatal error: Uncaught PDOException: SQLSTATE[HY000] [1045] Access denied for user 'guestbook'@'192.168.64.3' (using password: YES) in /var/www/html/public/tasks.php:8
Stack trace:
#0 /var/www/html/public/tasks.php(8): PDO->__construct('mysql:host=db;d...', 'guestbook', Object(SensitiveParameterValue), Array)
#1 {main}
  thrown in /var/www/html/public/tasks.php on line 8

Тут ім'я користувача бази, адреса контейнера php у мережі Docker (у вас буде інша), шлях до файлу й початок DSN — готові підказки для зловмисника. Пароль PHP 8 сховав (SensitiveParameterValue), але й решти забагато. Тому підключення обгортають у try / catch — замініть останній рядок підключення в tasks.php:

try {
    $pdo = new PDO($dsn, getenv('DB_USER'), getenv('DB_PASSWORD'), $options);
} catch (PDOException $e) {
    error_log($e->getMessage());
    echo 'База даних тимчасово недоступна. Спробуйте пізніше.';
    exit;
}
  • Виняток PDOException у блоці try не зупиняє скрипт: PHP переходить у catch, а $e — об'єкт винятку, чий метод getMessage() повертає текст помилки.
  • Відвідувач бачить лише загальне повідомлення, а exit зупиняє сторінку: без з'єднання решті коду нема з чим працювати.
  • Текст помилки потрібен розробникові. Вбудована функція error_log() пише його в журнал PHP, і docker compose logs php покаже NOTICE: PHP message: SQLSTATE[HY000] [1045] Access denied for user ….

Три помилки підключення, які трапляються найчастіше:

Текст помилки Що сталося
could not find driver у PHP немає драйвера pdo_mysql (інший образ чи PHP поза контейнером) або в DSN хибна назва драйвера, як-от mysq:
SQLSTATE[HY000] [2002] Connection refused за адресою з host MySQL не приймає з'єднань: host вказує не туди або сервер ще стартує
SQLSTATE[HY000] [1045] Access denied for user … MySQL відхилив логін чи пароль; (using password: NO) — PHP не передав пароля зовсім
У розділі environment сервісу php записали DB_HOST: 127.0.0.1, і сторінка показує SQLSTATE[HY000] [2002] Connection refused, хоча docker compose ps каже, що db працює. Де помилка?
Сторінка показує повідомлення нижче, хоча DB_PASSWORD у .env правильний. Де помилка?
SQLSTATE[HY000] [1045] Access denied for user 'guestbook'@'192.168.64.3' (using password: NO)

Підсумок

  • PDO — вбудований у PHP спосіб працювати з базами даних; з MySQL говорить драйвер pdo_mysql.
  • DSN mysql:host=db;dbname=guestbook;charset=utf8mb4 каже, куди під'єднатися, а логін і пароль приходять з .env через environment у Compose і getenv().
  • ERRMODE_EXCEPTION перетворює помилки бази на винятки, FETCH_ASSOC дає рядки асоціативними масивами.
  • query() надсилає запит, fetchAll() повертає всі рядки, fetch() — один рядок або false.
  • Підключення обгортають у try / catch (PDOException $e): відвідувачу — загальне повідомлення, розробникові — error_log().
  • could not find driver — немає драйвера, Connection refused — MySQL за цією адресою не відповідає, Access denied — хибний логін чи пароль.

Що далі

Лекція «Підготовлені запити і SQL-ін'єкції» — як безпечно передати в запит те, що ввів відвідувач, і як додавати, змінювати й видаляти рядки з PHP.