PHP PDO: подготовленные запросы и хранимые процедуры

PHP PDO 参考手册Справочное руководство по PHP PDO

Многие более зрелые базы данных поддерживают концепцию подготовленных запросов.

Что такое подготовленный запрос? Его можно представить как скомпилированный шаблон SQL, который вы хотите выполнить, и который можно настраивать с помощью переменных параметров. Подготовленные запросы дают два основных преимущества:

  • Запрос нужно разобрать (или предварительно обработать) только один раз, но его можно выполнять многократно с теми же или другими параметрами. Когда запрос подготовлен, база данных анализирует, компилирует и оптимизирует план выполнения запроса. Для сложных запросов этот процесс может занимать много времени. Если один и тот же запрос нужно повторять много раз с разными параметрами, этот процесс сильно замедлит приложение. Используя подготовленные запросы, можно избежать повторяющихся циклов анализа/компиляции/оптимизации. Короче говоря, подготовленные запросы потребляют меньше ресурсов и поэтому выполняются быстрее.
  • Параметры, передаваемые в подготовленные выражения, не нужно заключать в кавычки; драйвер делает это автоматически. Если приложение использует только подготовленные выражения, можно быть уверенным, что SQL-инъекция не произойдет. (Однако, если другие части запроса строятся из неэкранированного ввода, риск SQL-инъекции все еще существует.)

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

Выполнение повторяющихся вставок с помощью подготовленных выражений

В следующем примере выполняется запрос на вставку путем подстановки соответствующих именованных заполнителей значениями name и value.

<?php
$stmt = $dbh->prepare("INSERT INTO REGISTRY (name, value) VALUES (:name, :value)");
$stmt->bindParam(':name', $name);
$stmt->bindParam(':value', $value);

// 插入一行
$name = 'one';
$value = 1;
$stmt->execute();

//  用不同的值插入另一行
$name = 'two';
$value = 2;
$stmt->execute();
?>

Выполнение повторяющихся вставок с помощью подготовленных выражений

В следующем примере выполняется запрос на вставку путем замены заполнителей ? на name и value.

<?php
$stmt = $dbh->prepare("INSERT INTO REGISTRY (name, value) VALUES (?, ?)");
$stmt->bindParam(1, $name);
$stmt->bindParam(2, $value);

// 插入一行
$name = 'one';
$value = 1;
$stmt->execute();

// 用不同的值插入另一行
$name = 'two';
$value = 2;
$stmt->execute();
?>

Извлечение данных с помощью подготовленных выражений

В следующем примере данные извлекаются на основе предоставленных значений ключа. Пользовательский ввод автоматически заключается в кавычки, поэтому опасность атак SQL-инъекций отсутствует.

<?php
$stmt = $dbh->prepare("SELECT * FROM REGISTRY where name = ?");
if ($stmt->execute(array($_GET['name']))) {
  while ($row = $stmt->fetch()) {
    print_r($row);
  }
}
?>

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

Вызов хранимых процедур с выходными параметрами

<?php
$stmt = $dbh->prepare("CALL sp_returns_string(?)");
$stmt->bindParam(1, $return_value, PDO::PARAM_STR, 4000); 

// 调用存储过程
$stmt->execute();

print "procedure returned $return_value\n";
?>

Вы также можете указать параметры, которые имеют как входные, так и выходные значения, с синтаксисом, аналогичным выходным параметрам. В следующем примере строка "hello" передается в хранимую процедуру, и когда хранимая процедура возвращает результат, hello заменяется значением, возвращенным хранимой процедурой.

Вызов хранимых процедур с входными/выходными параметрами

<?php
$stmt = $dbh->prepare("CALL sp_takes_string_returns_string(?)");
$value = 'hello';
$stmt->bindParam(1, $value, PDO::PARAM_STR|PDO::PARAM_INPUT_OUTPUT, 4000); 

// 调用存储过程
$stmt->execute();

print "procedure returned $value\n";
?>

Недопустимое использование заполнителя

<?php
$stmt = $dbh->prepare("SELECT * FROM REGISTRY where name LIKE '%?%'");
$stmt->execute(array($_GET['name']));

// 占位符必须被用在整个值的位置
$stmt = $dbh->prepare("SELECT * FROM REGISTRY where name LIKE ?");
$stmt->execute(array("%$_GET[name]%"));
?>

PHP PDO 参考手册Справочное руководство по PHP PDO

Другие расширения