Подготовить запрос к выполнению
Назначение
Подготовка 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); ? >