PHPTime

PDO в PHP: подключение к MySQL, подготовленные запросы, транзакции

PDO — интерфейс PHP для работы с базами данных. Через него можно подключиться к MySQL или SQLite, передать параметры в SQL-запрос и объединить несколько операций в транзакцию.

Как работает PDO в PHP

PDO предоставляет общие методы для подключения к базе, выполнения SQL и чтения результата. С конкретной СУБД работает драйвер: pdo_mysql для MySQL и pdo_sqlite для SQLite. PDO передаёт SQL выбранной базе, поэтому синтаксис, типы и поведение транзакций зависят от СУБД.

  • query() выполняет фиксированный SQL и возвращает объект PDOStatement, из которого можно читать строки.
  • prepare() создаёт объект запроса, а execute() запускает его с параметрами. Подготовленный запрос можно выполнять повторно с другими значениями.
  • exec() подходит для фиксированных команд без результирующих строк. Он возвращает число затронутых строк, которое может быть равно нулю.

Подключение PHP к MySQL через PDO

В DSN указывают хост, порт, имя базы и кодировку соединения. Учётные данные в примере поступают из переменных окружения. Для примеров с MySQL нужна заранее созданная база app.

PHP
<?php
declare(strict_types=1);

$user = getenv('DB_USER');
$password = getenv('DB_PASSWORD');

if ($user === false || $password === false) {
    throw new RuntimeException('Задайте DB_USER и DB_PASSWORD');
}

$pdo = new PDO(
    'mysql:host=127.0.0.1;port=3306;dbname=app;charset=utf8mb4',
    $user,
    $password,
    [
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
        PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
        PDO::ATTR_EMULATE_PREPARES => false,
    ],
);

ERRMODE_EXCEPTION превращает ошибки SQL в PDOException. В PHP 8.x этот режим действует по умолчанию. Здесь он указан явно, чтобы настройка была видна рядом с подключением. FETCH_ASSOC возвращает строки как массивы с именами столбцов. ATTR_EMULATE_PREPARES со значением false включает использование серверной подготовки там, где драйвер её поддерживает.

charset=utf8mb4 задаёт кодировку соединения. Для хранения эмодзи и других четырёхбайтовых символов соответствующие текстовые столбцы тоже должны использовать utf8mb4. Хост 127.0.0.1 задаёт TCP-подключение. На Unix localhost у драйвера MySQL может означать подключение через локальный сокет.

Для примеров с пользователями выполните этот SQL в тестовой базе. Транзакции в примерах рассчитаны на таблицы InnoDB.

SQL
CREATE TABLE users (
    id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    email VARCHAR(254) NOT NULL UNIQUE,
    status VARCHAR(16) NOT NULL DEFAULT 'active'
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

PHP и SQL: подготовленные запросы с параметрами

Передавайте пользовательские значения отдельно от шаблона SQL. Плейсхолдер :email ставится без кавычек и обозначает целое значение. Для каждого вхождения параметра используйте отдельное имя, даже если значение совпадает. Это позволяет выполнять запрос с отключённой эмуляцией.

PHP
$stmt = $pdo->prepare('INSERT INTO users (email) VALUES (:email)');
$stmt->execute(['email' => 'anna@example.test']);

Массив в execute() удобен для строковых значений. Если нужен явный тип, используйте bindValue() с PDO::PARAM_INT, PDO::PARAM_BOOL или PDO::PARAM_NULL. После привязки вызывайте execute() без массива. Тип параметра описывает передачу значения драйверу. Проверку входных данных и допустимых диапазонов выполняет приложение.

Параметры представляют значения. Для динамической сортировки выбирайте готовый SQL-фрагмент из списка, заданного в коде. Для IN нужен отдельный плейсхолдер для каждого элемента. Пустой список обработайте до выполнения запроса, например верните пустой результат.

PHP
// Значение ключа может прийти из параметра запроса.
$sort = 'email';
$orderBy = match ($sort) {
    'email' => 'email ASC, id ASC',
    default => 'id DESC',
};

$ids = [1, 2];
$placeholders = implode(', ', array_fill(0, count($ids), '?'));
$stmt = $pdo->prepare(
    "SELECT id, email FROM users WHERE id IN ($placeholders) ORDER BY $orderBy"
);
foreach ($ids as $index => $id) {
    $stmt->bindValue($index + 1, $id, PDO::PARAM_INT);
}
$stmt->execute();
$users = $stmt->fetchAll();

SELECT в MySQL из PHP: одна строка, список и количество

Для поиска по уникальному полю достаточно одного вызова fetch(). Метод возвращает false, когда строк больше нет. Сравнивайте результат строго, чтобы явно обработать отсутствие записи.

PHP
$stmt = $pdo->prepare('SELECT id, email FROM users WHERE email = :email');
$stmt->execute(['email' => 'anna@example.test']);
$user = $stmt->fetch();

if ($user === false) {
    // Здесь можно вернуть HTTP 404.
    return;
}

// $user содержит ключи id и email.

Для небольшой страницы результатов подходит fetchAll(). Параметр LIMIT привязывайте как целое число, а допустимый размер страницы ограничивайте в приложении.

PHP
$stmt = $pdo->prepare(
    'SELECT id, email FROM users WHERE status = :status ORDER BY id LIMIT :limit'
);
$stmt->bindValue(':status', 'active');
$stmt->bindValue(':limit', 20, PDO::PARAM_INT);
$stmt->execute();
$users = $stmt->fetchAll();

Для подсчёта записей используйте SELECT COUNT(*) с нужным фильтром и прочитайте значение через fetchColumn(). Поведение rowCount() для SELECT зависит от драйвера. Для больших выгрузок можно читать строки циклом while (($row = $stmt->fetch()) !== false). Это убирает массив всех строк из кода приложения, но драйвер MySQL по умолчанию может буферизовать результат. Для выгрузок с ограниченной памятью используйте отдельное подключение с PDO::MYSQL_ATTR_USE_BUFFERED_QUERY со значением false и дочитывайте результат или закрывайте курсор до следующего запроса на том же подключении.

Транзакции PDO: фиксация и откат

Транзакция нужна, когда несколько записей должны сохраниться вместе. Например, при создании пользователя и записи в журнале аудита обе операции выполняются через один объект PDO. Таблицу журнала создайте заранее. Команды вроде CREATE TABLE и ALTER TABLE в MySQL могут неявно завершить транзакцию.

SQL
CREATE TABLE user_audit (
    id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    user_id BIGINT UNSIGNED NOT NULL,
    action VARCHAR(32) NOT NULL,
    FOREIGN KEY (user_id) REFERENCES users(id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
PHP
$pdo->beginTransaction();

try {
    $insertUser = $pdo->prepare('INSERT INTO users (email) VALUES (:email)');
    $insertUser->execute(['email' => 'ivan@example.test']);
    $userId = $pdo->lastInsertId();

    $insertAudit = $pdo->prepare(
        'INSERT INTO user_audit (user_id, action) VALUES (:user_id, :action)'
    );
    $insertAudit->execute(['user_id' => $userId, 'action' => 'created']);

    $pdo->commit();
} catch (Throwable $error) {
    // Откатываем изменения, если транзакция ещё открыта.
    if ($pdo->inTransaction()) {
        $pdo->rollBack();
    }
    throw $error;
}

Идентификатор получен сразу после вставки на том же подключении. Обработчик Throwable позволяет откатить изменения и при ошибках приложения внутри транзакции. Вложенные вызовы beginTransaction() PDO не поддерживает. Для частичного отката внутри открытой транзакции MySQL и SQLite предоставляют точки сохранения SAVEPOINT.

SQLite в PHP через PDO

Для SQLite нужен драйвер pdo_sqlite. DSN sqlite: с абсолютным путём открывает файл базы, а sqlite::memory: создаёт временную базу для текущего подключения. После его закрытия данные из памяти исчезают.

PHP
<?php
declare(strict_types=1);

$db = new PDO('sqlite::memory:');
// Проверка внешних ключей включается для каждого подключения.
$db->exec('PRAGMA foreign_keys = ON');
$db->exec('CREATE TABLE notes (id INTEGER PRIMARY KEY, body TEXT NOT NULL)');

$stmt = $db->prepare('INSERT INTO notes (body) VALUES (:body)');
$stmt->execute(['body' => 'Первая заметка']);

$notes = $db->query('SELECT id, body FROM notes')->fetchAll(PDO::FETCH_ASSOC);

Для файловой базы размещайте файл вне публичного каталога сайта. При записи процессу PHP нужны права на файл и каталог, где SQLite может создавать служебные файлы. Объявление INTEGER PRIMARY KEY в примере позволяет SQLite назначать идентификатор при вставке.

Типичные ошибки PDO и отличия PHP 8.3–8.5

  • could not find driver. Драйвер для указанного DSN отсутствует в среде, где выполняется скрипт. Вызов PDO::getAvailableDrivers() покажет доступные драйверы. CLI и PHP-FPM могут читать разные файлы конфигурации.
  • Access denied. Проверьте пароль, хост подключения и права учётной записи MySQL для этого хоста и базы.
  • SQLSTATE[HY093]. Сверьте плейсхолдеры с привязками и проверьте повторяющиеся имена. В одном запросе используйте либо именованные параметры, либо позиционные ?.
  • Неверный тип результата. declare(strict_types=1) применяется к скалярным типам при вызовах из PHP-кода и не задаёт типы столбцов результата. Преобразуйте данные явно при передаче в типизированный объект. Для точных денежных значений DECIMAL сохраняйте десятичное представление.

Все примеры работают с общим классом PDO в PHP 8.3–8.5. Начиная с PHP 8.4 доступны классы драйверов Pdo\Mysql и Pdo\Sqlite, а фабрика PDO::connect() возвращает объект соответствующего класса, если такой класс предусмотрен для драйвера. Если проект поддерживает PHP 8.3, используйте new PDO() и общий интерфейс.

В старом PHP для MySQL использовали функции mysql_*. При переносе такого кода замените mysql_connect() на создание объекта PDO, чтение строк через mysql_fetch_assoc() — на fetch(PDO::FETCH_ASSOC), а сборку SQL с пользовательскими значениями — на prepare() и execute().

Чек-лист перед запуском

  1. Проверьте драйвер в той среде PHP, где работает приложение. Для MySQL задайте utf8mb4 в DSN и проверьте кодировку текстовых столбцов.
  2. Передавайте значения параметрами, а имена столбцов и направление сортировки выбирайте из заданного в коде списка.
  3. Обработайте пустой результат fetch() и ограничьте объём выборок. Для подсчёта используйте COUNT(*).
  4. Объединяйте связанные записи в транзакцию и проверьте, что сбой второй операции откатывает первую.
  5. Храните пароль в настройках окружения. Подробности исключений записывайте во внутренний журнал, а клиенту возвращайте короткое сообщение об ошибке.

Частые вопросы

Как узнать, доступен ли PDO для MySQL или SQLite?

Вызовите PDO::getAvailableDrivers() в среде, где выполняется приложение. Для MySQL в списке должен быть mysql, для SQLite — sqlite.

Как получить одну строку из MySQL через PDO?

Подготовьте SELECT с параметром, вызовите execute(), затем fetch(). При режиме PDO::FETCH_ASSOC метод вернёт ассоциативный массив или false, если подходящей строки нет.

Можно ли передать имя таблицы через параметр PDO?

Плейсхолдеры PDO предназначены для значений. Если таблица выбирается динамически, сопоставьте входной ключ с одним из заранее заданных в коде имён.

Справка по теме

Ещё в разделе «Справочник PHP»

Ассоциативные и многомерные массивы в PHP

Как создавать ассоциативные и многомерные массивы в PHP, читать вложенные данные, получать ключи и значения через array_keys() и array_values().

10 мин

Вывод ошибок в PHP: display_errors, error_reporting и логи

Как включить вывод ошибок PHP через display_errors и ini_set, настроить error_reporting и error_log, найти логи и разобраться с deprecated в PHP 8.3–8.5.

9 мин

Дата и время в PHP: date, DateTime и часовые пояса

Как получить текущую дату и время в PHP, настроить часовой пояс, разобрать строку и отформатировать дату с date(), strtotime() и DateTimeImmutable.

8 мин

Загрузка файлов на сервер в PHP: $_FILES и безопасность

Как принять файл через $_FILES, проверить размер, MIME-тип и расширение, сохранить его вне публичной папки, выдать на скачивание и обработать ZIP.

10 мин