PDO::exec

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

PDO::exec — Выполняет SQL-инструкцию и возвращает количество затронутых строк (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)

Описание

Синтаксис

int PDO::exec ( string $statement )

PDO::exec() выполняет SQL-инструкцию за один вызов функции, возвращая количество строк, затронутых инструкцией.

PDO::exec() не возвращает результаты из инструкции SELECT. Для инструкции SELECT, которую нужно выполнить только один раз в вашей программе, рассмотрите возможность использования PDO::query().

Параметры:

statement: SQL-инструкция, которую нужно подготовить и выполнить.

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

PDO::exec() возвращает количество строк, затронутых изменяющей или удаляющей SQL-инструкцией. Если затронутых строк нет, PDO::exec() возвращает 0.

В следующем примере неправильно используется возвращаемое значение PDO::exec(); инструкция с 0 затронутых строк приведёт к вызову die():

<?php
$db->exec() or die(print_r($db->errorInfo(), true));
?>

Примеры

Выполнить инструкцию DELETE

Подсчитать количество строк, удалённых инструкцией DELETE без предложения WHERE.

<?php
$dbh = new PDO('odbc:sample', 'db2inst1', 'ibmdb2');

/*  删除 FRUIT 数据表中满足条件的所有行 */
$count = $dbh->exec("DELETE FROM fruit WHERE colour = 'red'");

/* 返回被删除的行数 */
print("Deleted $count rows.\n");
?>

Приведённый выше пример выведет:

Deleted 1 rows.

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

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