В чем разница между bindParam и bindValue в PDO? Подробное объяснение с примерами

Основное различие: передача по ссылке vs по значению

Главное отличие между bindParam() и bindValue() в том, как они работают с переменными:

• bindParam() — связывает переменную по ссылке. Значение будет считано из переменной в момент выполнения запроса (execute()), а не в момент вызова bindParam().
• bindValue() — связывает конкретное значение. Значение фиксируется в момент вызова bindValue().

Наглядный пример с циклом

Рассмотрим ситуацию, которая часто путает новичков. Допустим, мы хотим вставить несколько пользователей:

<?php
$users = [
    ['name' => 'Alice', 'email' => 'alice@example.com'],
    ['name' => 'Bob', 'email' => 'bob@example.com'],
];

$stmt = $pdo->prepare('INSERT INTO users (name, email) VALUES (:name, :email)');

// Пробуем через bindParam (НЕПРАВИЛЬНО)
foreach ($users as $user) {
    $stmt->bindParam(':name', $user['name']);
    $stmt->bindParam(':email', $user['email']);
    $stmt->execute();
}
// Результат: вставятся два раза "Bob" и "bob@example.com"!
?>

Почему? Потому что bindParam сохраняет ссылку на переменную $user['name']. В конце цикла эта переменная указывает на последний элемент массива. Когда вызывается execute() (даже на первой итерации), PDO смотрит на текущее значение переменной по ссылке — а там уже "Bob".

Теперь правильный вариант через bindValue:

<?php
$stmt = $pdo->prepare('INSERT INTO users (name, email) VALUES (:name, :email)');

foreach ($users as $user) {
    $stmt->bindValue(':name', $user['name']);
    $stmt->bindValue(':email', $user['email']);
    $stmt->execute();
}
// Результат: вставятся Alice и Bob — корректно!
?>

С bindValue значение копируется сразу в момент вызова, поэтому каждая итерация работает с правильными данными.

Когда использовать bindParam?

bindParam полезен, когда вы хотите изменить переменную и выполнить тот же запрос снова без повторного связывания:

<?php
$stmt = $pdo->prepare('SELECT * FROM products WHERE price > :min_price');
$minPrice = 100;
$stmt->bindParam(':min_price', $minPrice);
$stmt->execute(); // Ищем товары дороже 100

$minPrice = 500;
$stmt->execute(); // Ищем товары дороже 500 — без повторного bindParam!
?>

Важное замечание про типы данных

У bindParam есть третий необязательный параметр — тип данных (PDO::PARAM_INT, PDO::PARAM_STR и т.д.). У bindValue он тоже есть. Но с bindParam этот параметр может быть критичен, если вы передаете переменную, которая может изменить тип:

<?php
$id = '5abc'; // строка
$stmt->bindParam(':id', $id, PDO::PARAM_INT);
// PDO попытается привести к int — получится 5, ошибки не будет
$stmt->execute();
?>

Итоговое правило

Если вы не уверены — используйте bindValue(). Это безопаснее и предсказуемее. bindParam() используйте только когда:

• Нужно выполнить один запрос много раз с разными значениями одной переменной (как в примере с ценами).
• Работаете с OUT-параметрами хранимых процедур (там bindParam обязателен).
• Хотите передавать большие данные (BLOB) — bindParam может быть эффективнее по памяти.

В 90% случаев bindValue() — это то, что вам нужно.

<?php
$stmt = $pdo->prepare('SELECT * FROM users WHERE id = :id AND status = :status');
$stmt->execute([
    ':id' => 5,
    ':status' => 'active'
]);
// Или с плейсхолдерами ?:
$stmt = $pdo->prepare('SELECT * FROM users WHERE id = ? AND status = ?');
$stmt->execute([5, 'active']);
?>