Доступные версии документации

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

Назначение

Подготовка 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);
?>
Заметили ошибку?
Выделите текст и нажмите Ctrl + Enter