Подготовленные выражения в PDOот mysql_query к безопасным запросам в PHP 8
Функций mysql_* нет с PHP 7, а склейка SQL со строками из формы до сих пор встречается. Показываем, как правильно готовить запросы в PDO и где ждут ловушки.
- Раздел
- PHP
- Стек
- PHP 8PDOMySQL
- Уровень
- Средний
- Опубликовано
- Обновлено
- Чтение
- 9 мин
- Расширение mysql_* удалено в PHP 7.0.
- SQL и данные передавайте раздельно, через метки.
- Метки подставляют только значения, не имена столбцов.
- С PHP 8.0 PDO по умолчанию бросает исключения.
- Создайте PDO с charset=utf8mb4 в DSN
- Включите исключения и отключите эмуляцию
- Замените склейку строк на prepare и execute
- Для IN сгенерируйте метки по числу значений
- LIMIT передавайте через bindValue с PARAM_INT
Откуда взялась проблема#
Долгое время типичный PHP-код работал с MySQL через функции mysql_*: соединились, склеили SQL-строку с данными из формы, выполнили. Расширение объявили устаревшим в PHP 5.5 и полностью удалили в PHP 7.0, так что на актуальном интерпретаторе такой код просто падает с ошибкой о неизвестной функции. Но вторая беда хуже первой: склейка строк открывает дорогу SQL-инъекциям.
<?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
// 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
$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
$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
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 и белом списке для имён столбцов действуют везде.
Короткий чек-лист миграции#
- Найдите в проекте все вызовы
mysql_иmysqli_queryсо склейкой строк:grep -rn "mysql_" src/. - Создавайте одно соединение PDO на запрос и передавайте его в классы через конструктор, а не через глобальную переменную.
- Каждое значение из
$_GET,$_POST, cookies и заголовков отправляйте только через метки. - Имена столбцов и направление сортировки сверяйте с белым списком.
- Запустите тесты на строках с кавычками, обратной косой чертой и эмодзи.
Дальше по теме: в разделе PHP есть разбор функции slugify для кириллицы, которая обычно соседствует с запросами по полю slug.
«Подготовленное выражение не экранирует данные, оно просто не даёт им стать частью SQL.»
Главный вывод заметки


