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'.
Помилки: 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 не передав пароля зовсім |
Підсумок
- 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.