Подготовленные выражения в PDO

Подготовленные выражения в PDOот mysql_query к безопасным запросам в PHP 8

Функций mysql_* нет с PHP 7, а склейка SQL со строками из формы до сих пор встречается. Показываем, как правильно готовить запросы в PDO и где ждут ловушки.

Раздел
PHP
Стек
PHP 8PDOMySQL
Уровень
Средний
Опубликовано
Обновлено
Чтение
9 мин
Коротко
  • Расширение mysql_* удалено в PHP 7.0.
  • SQL и данные передавайте раздельно, через метки.
  • Метки подставляют только значения, не имена столбцов.
  • С PHP 8.0 PDO по умолчанию бросает исключения.
Как решаем
  1. Создайте PDO с charset=utf8mb4 в DSN
  2. Включите исключения и отключите эмуляцию
  3. Замените склейку строк на prepare и execute
  4. Для IN сгенерируйте метки по числу значений
  5. LIMIT передавайте через bindValue с PARAM_INT

Откуда взялась проблема#

Долгое время типичный PHP-код работал с MySQL через функции mysql_*: соединились, склеили SQL-строку с данными из формы, выполнили. Расширение объявили устаревшим в PHP 5.5 и полностью удалили в PHP 7.0, так что на актуальном интерпретаторе такой код просто падает с ошибкой о неизвестной функции. Но вторая беда хуже первой: склейка строк открывает дорогу SQL-инъекциям.

PHP
<?php
// так писали до PHP 7: уязвимо и больше не работает
$link = mysql_connect('localhost', 'app', $password);
mysql_select_db('shop', $link);

$email = $_POST['email'];
$sql = "SELECT id, name FROM users WHERE email = '$email'";
$res = mysql_query($sql, $link) or die(mysql_error());
$user = mysql_fetch_assoc($res);

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

Подготовленные выражения в PDO#

PDO (PHP Data Objects) входит в стандартную поставку PHP и даёт один интерфейс для MySQL, PostgreSQL, SQLite и других баз. Идея подготовленного выражения проста: сначала отправляем шаблон запроса с плейсхолдерами, затем отдельно значения. Сервер разбирает SQL до того, как увидит данные, поэтому кавычка в email остаётся просто символом в строке.

PHP
<?php
// 2013: PDO и подготовленное выражение
$pdo = new PDO(
    'mysql:host=localhost;dbname=shop;charset=utf8mb4',
    'app',
    $password,
    [
        PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION,
        PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
        PDO::ATTR_EMULATE_PREPARES   => false,
    ]
);

$stmt = $pdo->prepare('SELECT id, name FROM users WHERE email = :email');
$stmt->execute([':email' => $_POST['email']]);
$user = $stmt->fetch();      // массив или false, если строки нет

Три опции в конструкторе стоит ставить всегда:

  • ATTR_ERRMODE => ERRMODE_EXCEPTION: ошибки SQL превращаются в PDOException, а не тихо возвращают false. Без этого опечатка в имени столбца проявится где-то ниже, как вызов метода у false.
  • ATTR_DEFAULT_FETCH_MODE => FETCH_ASSOC: строки приходят ассоциативными массивами, без дублирования по числовым индексам.
  • ATTR_EMULATE_PREPARES => false: драйвер MySQL по умолчанию эмулирует подготовку и сам подставляет экранированные значения в строку. С отключённой эмуляцией запрос действительно готовит сервер.

Кодировку задавайте прямо в DSN через charset=utf8mb4, а не отдельным запросом SET NAMES: так её знает и сам драйвер, и экранирование при эмуляции работает в правильной кодировке. Именно utf8mb4, а не utf8, нужен, чтобы в базу попадали эмодзи и редкие символы.

Для чтения результатов есть несколько методов, и выбирать стоит по задаче. fetch() возвращает одну строку или false, fetchAll() сразу весь набор в массив, а fetchColumn() одно значение из первого столбца, что удобно для COUNT(*). Для больших выборок не собирайте всё в PHP-массив: перебирайте сам объект выражения в foreach, он отдаёт строки по одной. Учтите, что драйвер MySQL по умолчанию всё равно буферизует весь результат на стороне клиента; для действительно огромных выгрузок эту буферизацию отключают атрибутом PDO::MYSQL_ATTR_USE_BUFFERED_QUERY.

Плейсхолдеры: именованные и позиционные#

PDO понимает два вида меток, и смешивать их в одном запросе нельзя:

ВидПримерКогда удобен
ПозиционныеWHERE a = ? AND b = ?Короткие запросы, динамические списки значений
ИменованныеWHERE a = :a AND b = :bДлинные запросы, где порядок легко перепутать

Значения можно передать массивом в execute() или по одному через bindValue(). Важная деталь: всё, что передано через execute(), уходит как строки. Для WHERE это неважно, MySQL сам приведёт тип, а вот LIMIT в режиме эмуляции получит число в кавычках, и запрос упадёт с синтаксической ошибкой. Поэтому для LIMIT и OFFSET используйте bindValue с PDO::PARAM_INT.

Есть и то, что плейсхолдером передать нельзя: имена таблиц и столбцов, направление сортировки, ключевые слова. Метка подставляет только значение. Если сортировка приходит из запроса пользователя, сверяйте её с белым списком, например in_array($sort, ['id', 'created_at'], true), и только потом вставляйте в SQL.

Список значений в IN и LIMIT#

Частый вопрос: как передать массив в IN (...). Одна метка на весь массив не сработает, потому что значение подставится как одна строка. Нужно сгенерировать столько меток, сколько элементов в массиве:

PHP
<?php
$ids = array_map('intval', $ids);
if ($ids === []) {
    return [];                       // пустой IN () не пройдёт
}
$marks = implode(',', array_fill(0, count($ids), '?'));
$stmt  = $pdo->prepare("SELECT id, title FROM posts WHERE id IN ($marks)");
$stmt->execute($ids);

// LIMIT: тип задаём явно
$stmt = $pdo->prepare('SELECT id, title FROM posts ORDER BY id DESC LIMIT :lim');
$stmt->bindValue(':lim', $limit, PDO::PARAM_INT);
$stmt->execute();

Пустой массив проверяем отдельно: IN () без значений MySQL не принимает. Приведение к int здесь не для защиты, плейсхолдеры и так безопасны, а для того, чтобы в запрос не ушли пустые строки и null из грязных входных данных.

Тот же подход нужен в любом месте, где приложение принимает параметры из адреса. Если вы собирали свой маршрутизатор по нашей заметке о простом роутере на PHP, параметры маршрута тоже передавайте в запросы только через метки.

Транзакции и повторное выполнение#

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

PHP
<?php
$pdo->beginTransaction();
try {
    $pdo->prepare('INSERT INTO orders (user_id, total) VALUES (?, ?)')
        ->execute([$userId, $total]);
    $orderId = (int) $pdo->lastInsertId();

    $item = $pdo->prepare('INSERT INTO order_items (order_id, sku, qty) VALUES (?, ?, ?)');
    foreach ($cart as $sku => $qty) {
        $item->execute([$orderId, $sku, $qty]);   // один prepare, много execute
    }
    $pdo->commit();
} catch (Throwable $e) {
    $pdo->rollBack();
    throw $e;
}

Несколько деталей, о которых часто забывают. lastInsertId() возвращает строку, поэтому приводим её к числу. В блоке catch ловим Throwable, а не только PDOException: ошибка может случиться и в вашем коде между запросами, и транзакцию в этом случае тоже нужно откатить. После отката исключение пробрасываем дальше, чтобы его увидел общий обработчик и записал в лог, а не проглатываем молча. Наконец, транзакции работают только в таблицах с движком, который их поддерживает, в MySQL это InnoDB.

Что изменилось к 2026 году#

Начиная с PHP 8.0 режим ошибок PDO по умолчанию уже ERRMODE_EXCEPTION, так что исключения вы получите даже без явной опции. Оставлять её в конструкторе всё равно полезно: код становится самодокументирующим и не зависит от версии. Остальные изменения касаются не столько PDO, сколько кода вокруг него.

Строки из базы удобно сразу превращать в типизированные объекты. Классы readonly появились в PHP 8.2 и хорошо подходят для DTO: объект создаётся один раз и больше не меняется. Репозиторий с ними выглядит так:

PHP
<?php
declare(strict_types=1);

final readonly class User
{
    public function __construct(
        public int $id,
        public string $email,
        public string $name,
    ) {}
}

final class UserRepository
{
    public function __construct(private PDO $pdo) {}

    public function findByEmail(string $email): ?User
    {
        $stmt = $this->pdo->prepare(
            'SELECT id, email, name FROM users WHERE email = :email'
        );
        $stmt->execute(['email' => $email]);
        $row = $stmt->fetch(PDO::FETCH_ASSOC);

        return $row === false
            ? null
            : new User((int) $row['id'], $row['email'], $row['name']);
    }
}

Явное создание объекта через конструктор надёжнее, чем PDO::FETCH_CLASS: типы проверяются при создании, а не всплывают позже. В PHP 8.4 у PDO появились отдельные подклассы драйверов, например Pdo\Mysql, и фабрика PDO::connect(), которая возвращает подходящий подкласс; старый конструктор new PDO(...) продолжает работать.

Когда хватает чистого PDO, а когда брать библиотеку:

  • PDO: небольшой сервис, десяток запросов, полный контроль над SQL.
  • Doctrine DBAL: нужен построитель запросов, поддержка нескольких баз, удобные массивы для IN через типы параметров, транзакции с вложенностью.
  • ORM фреймворка: Laravel, Symfony или Query Builder в CodeIgniter 4, если проект уже на нём. Как устроена работа с сессиями и запросами в этом фреймворке, мы разбирали в заметке про AJAX и сессии в CodeIgniter.

Любой из этих слоёв под капотом использует те же подготовленные выражения, так что правила о метках, LIMIT и белом списке для имён столбцов действуют везде.

Короткий чек-лист миграции#

  1. Найдите в проекте все вызовы mysql_ и mysqli_query со склейкой строк: grep -rn "mysql_" src/.
  2. Создавайте одно соединение PDO на запрос и передавайте его в классы через конструктор, а не через глобальную переменную.
  3. Каждое значение из $_GET, $_POST, cookies и заголовков отправляйте только через метки.
  4. Имена столбцов и направление сортировки сверяйте с белым списком.
  5. Запустите тесты на строках с кавычками, обратной косой чертой и эмодзи.

Дальше по теме: в разделе PHP есть разбор функции slugify для кириллицы, которая обычно соседствует с запросами по полю slug.

PHP 7.0удалено расширение mysql_*
PHP 8.0исключения в PDO по умолчанию
PHP 8.2readonly-классы для DTO

«Подготовленное выражение не экранирует данные, оно просто не даёт им стать частью SQL.»

Главный вывод заметки

Вопросы и ответы

Вопросы и ответы

Защищают ли подготовленные выражения от всех SQL-инъекций?
Они защищают значения. Имена таблиц, столбцов и направление сортировки через метку передать нельзя, и если вы вставляете их в SQL из пользовательского ввода, инъекция возможна. Такие части сверяйте с белым списком допустимых вариантов.
Нужно ли отключать ATTR_EMULATE_PREPARES?
Для MySQL мы рекомендуем отключать: запрос готовит сервер, а не драйвер, и пропадают сюрпризы с LIMIT. При правильной кодировке в DSN эмуляция тоже безопасна, так что на старом проекте это не срочная правка, а улучшение.
Почему LIMIT с меткой даёт синтаксическую ошибку?
Значения из execute передаются как строки, и в режиме эмуляции LIMIT получает число в кавычках, которое MySQL не принимает. Привяжите значение через bindValue с типом PDO::PARAM_INT или отключите эмуляцию подготовки.
Как передать массив в условие IN?
Одна метка на массив не подходит: значение подставится как одна строка. Сгенерируйте столько вопросительных знаков, сколько элементов, через array_fill и implode, передайте массив в execute и отдельно обработайте пустой список.
Заметка обновлена 12 ноября 2026: код проверен на актуальных версиях, добавлены современные варианты.

Читайте также