PDO::commit
(PHP 5 >= 5.1.0, PHP 7, PECL pdo >= 0.1.0)
PDO::commit — Фиксирует транзакцию
Описание
Фиксирует транзакцию, возвращая соединение с базой данных в режим автоматической фиксации до тех пор, пока следующий вызов PDO::beginTransaction() не начнет новую транзакцию.
Возвращаемые значения
Возвращает true
в случае успешного завершения или false
в случае возникновения ошибки.
Ошибки
Вызывает исключение PDOException, если нет активной транзакции.
Замечание: Исключение будет вызвано, даже если атрибут
PDO::ATTR_ERRMODE
не выставлен вPDO::ERRMODE_EXCEPTION
.
Примеры
Пример #1 Фиксация обычной транзакции
<?php
/* Начало транзакции, отключение автоматической фиксации */
$dbh->beginTransaction();
/* Вставка множества записей по принципу "все или ничего" */
$sql = 'INSERT INTO fruit
(name, colour, calories)
VALUES (?, ?, ?)';
$sth = $dbh->prepare($sql);
foreach ($fruits as $fruit) {
$sth->execute(array(
$fruit->name,
$fruit->colour,
$fruit->calories,
));
}
/* Фиксация изменений */
$dbh->commit();
/* Соединение с базой данных снова в режиме автоматической фиксации */
?>
Пример #2 Фиксация DDL-транзакции
<?php
/* Начало транзакции, отключение автоматической фиксации */
$dbh->beginTransaction();
/* Изменение схемы базы данных */
$sth = $dbh->exec("DROP TABLE fruit");
/* Фиксация изменений */
$dbh->commit();
/* Соединение с базой данных снова в режиме автоматической фиксации */
?>
Замечание: Не все базы данных позволяют транзакциям работать с DDL-выражениями: в некоторых генерируются ошибки, тогда как в других (включая MySQL) транзакция автоматически фиксируется после первого встретившегося DDL-выражения.
Смотрите также
- PDO::beginTransaction() - Инициализация транзакции
- PDO::rollBack() - Откат транзакции
- Транзакции и автоматическая фиксация