Подготовить запрос к выполнению

Назначение

Подготовка SQL-оператора к выполнению.

Синтаксические правила
 
PDOStatement PDO::prepare (string statement[, array driver_options]);
statement

SQL-оператор, подготавливаемый для обработки СУБД ЛИНТЕР.

driver_options

Массив пар < атрибут >=< значение >, которые будут присвоены новому PDOStatement-объекту.

Описание

Функция подготавливает SQL-оператор для последующего выполнения его функцией PDOStatement::execute. Текст SQL-оператора может содержать ноль или более именованных (:< имя >) или неименованных (?) параметров, значение которым будет присваиваться в момент обработки SQL-оператора ядром СУБД ЛИНТЕР.

Требования к тексту SQL-оператора:

  • если SQL-оператор содержит параметры, то они должны быть однотипными: либо все именованные, либо все нумерованные;

  • уникальный параметр можно задавать для любого значения, которое должно быть передано на обработку (функции PDOStatement::execute кроме имен объектов БД);

  • дублирование именованных параметров запрещается;

  • нельзя привязывать несколько значений одному именованному параметру;

  • для выполнения SQL-оператора с различными значениями параметров необходимо каждый раз вызывать функцию PDO::prepare, а затем PDOStatement::execute.

Возвращаемое значение

PDOStatement-объект, соответствующий заданному SQL-оператору.

Пример
< ?php
…
$select = $dbh- >prepare('SELECT COUNT(*) FROM auto where color=:color_auto');
$select- >execute(array('color_auto'= >'BLACK'));
$res = $select- >fetchColumn();
echo ('BLACK auto: '.$res);
? >