PHP: полный мануал с примерами, функциями и ООП

PHP 5.1+; примеры PHP 8.2+ · pdo_sqlite

PDO::beginTransaction(): bool

<?php
require __DIR__ . '/catalog.php';
$db->beginTransaction();
$db->exec('UPDATE products SET stock = stock - 2 WHERE id = 1');
$db->commit();
echo "Резерв подтверждён\n";
$statement = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $statement->fetch(PDO::FETCH_ASSOC);
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Резерв подтверждён
Молоток — 6 шт.

Объединить несколько SQL-изменений в одну подтверждаемую или отменяемую работу.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

true при начале, false при отказе; уже активная транзакция либо отсутствие поддержки драйвером — PDOException даже при SILENT. Проверка относится к драйверу, не гарантирует транзакционность каждой таблицы (пример: MyISAM). Обычный autocommit меняется до commit/rollBack. DDL в MySQL/Oracle может неявно зафиксировать изменения: не смешивайте миграцию схемы с бизнес-транзакцией. Изоляция и блокировки зависят от СУБД/уровня; транзакция не означает автоматический запрет любых изменений другими клиентами.

Как читать этот вариант. Свои незавершённые изменения соединение видит. Откат вернул прежнюю цену. Это управление данными БД: отправленное письмо или HTTP-запрос rollback не отменит.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT NOT NULL, price INTEGER NOT NULL)');
$db->exec("INSERT INTO products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$db->beginTransaction();
$db->exec('UPDATE products SET price = 999 WHERE id = 1');
echo $db->query('SELECT price FROM products WHERE id = 1')->fetchColumn(), "\n";
$db->rollBack();
echo $db->query('SELECT price FROM products WHERE id = 1')->fetchColumn(), "\n";

999
120

Как читать этот вариант. У PDO нет универсальных вложенных транзакций. Подзадачи должны знать, кто владеет внешней транзакцией; при необходимости изучают SAVEPOINT конкретной СУБД.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->beginTransaction();
try { $db->beginTransaction(); } catch (PDOException $error) { echo "Уже открыта\n"; }
$db->rollBack();

Уже открыта

Рядом: PDO::commit(), PDO::rollBack(), PDO::inTransaction().

Дополнительные ранее разобранные сценарии.

Переводит соединение из autocommit в транзакцию и возвращает bool. Если транзакция уже активна или драйвер не поддерживает её, возможно исключение.

Как читать этот вариант. Явно завершаем учебную транзакцию.

<?php
declare(strict_types=1);

$db=new PDO('sqlite::memory:',null,null,[PDO::ATTR_ERRMODE=>PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT, stock INTEGER)');
$db->exec("INSERT INTO products VALUES (1,'Tea',3),(2,'Coffee',0)");
$db->beginTransaction();
echo $db->inTransaction() ? "active\n" : "none\n";
$db->rollBack();

active

Как читать этот вариант. В рабочем сценарии добавьте try/catch с откатом при любом Throwable.

<?php
declare(strict_types=1);

$db=new PDO('sqlite::memory:',null,null,[PDO::ATTR_ERRMODE=>PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT, stock INTEGER)');
$db->exec("INSERT INTO products VALUES (1,'Tea',3),(2,'Coffee',0)");
$db->beginTransaction();
$db->exec('UPDATE products SET stock=stock+2 WHERE id=1');
$db->exec('UPDATE products SET stock=stock+1 WHERE id=2');
$db->commit();
echo $db->query('SELECT SUM(stock) FROM products')->fetchColumn()."\n";

6

Рядом по задаче. commit фиксирует, rollBack отменяет; условный UPDATE и outbox.

• PHP: PDO::beginTransaction
• PHP: pdo.begintransaction

PHP 5.1+; примеры PHP 8.2+ · pdo_sqlite

PDO::commit(): bool

<?php
require __DIR__ . '/catalog.php';
$db->beginTransaction();
$db->exec('UPDATE products SET stock = stock - 2 WHERE id = 1');
$db->commit();
echo "Резерв подтверждён\n";
$statement = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $statement->fetch(PDO::FETCH_ASSOC);
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Резерв подтверждён
Молоток — 6 шт.

Подтвердить изменения открытой транзакции и вернуться в autocommit.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

true/false; без активной транзакции PDOException независимо от ERRMODE. Сам commit тоже может не удаться, например из-за блокировки/отложенного ограничения или потери соединения. При неясном результате сетевого отказа не повторяйте платёж или INSERT вслепую: нужны идентификатор операции и сверка. Для локального rollback после ошибки сначала проверяют inTransaction; не подавляют исходную ошибку ошибкой очистки.

Как читать этот вариант. После commit нет активной транзакции, цена сохранена. Последующий rollback не является кнопкой отмены уже подтверждённого заказа.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT NOT NULL, price INTEGER NOT NULL)');
$db->exec("INSERT INTO products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$db->beginTransaction();
$db->exec('UPDATE products SET price = 130 WHERE id = 1');
$ok = $db->commit();
var_dump($ok, $db->inTransaction());
echo $db->query('SELECT price FROM products WHERE id = 1')->fetchColumn(), "\n";

bool(true)
bool(false)
130

Как читать этот вариант. Если вспомогательная функция неожиданно сделала commit чужой транзакции, внешнему коду уже нечего фиксировать. Поэтому границы транзакции задают на уровне законченного действия приложения.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
try { $db->commit(); } catch (PDOException $error) { echo "Нечего фиксировать\n"; }

Нечего фиксировать

Рядом: PDO::beginTransaction(), PDO::inTransaction().

Дополнительные ранее разобранные сценарии.

Подтверждает изменения и возвращает соединение к autocommit. Возвращает bool; отсутствие активной транзакции или сбой фиксации может вызвать исключение.

Как читать этот вариант. Значение доступно после завершения транзакции.

<?php
declare(strict_types=1);

$db=new PDO('sqlite::memory:',null,null,[PDO::ATTR_ERRMODE=>PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT, stock INTEGER)');
$db->exec("INSERT INTO products VALUES (1,'Tea',3),(2,'Coffee',0)");
$db->beginTransaction();
$db->exec('UPDATE products SET stock=7 WHERE id=1');
$db->commit();
echo $db->query('SELECT stock FROM products WHERE id=1')->fetchColumn()."\n";

7

Как читать этот вариант. Даже пустая транзакция должна иметь понятное завершение.

<?php
declare(strict_types=1);

$db=new PDO('sqlite::memory:',null,null,[PDO::ATTR_ERRMODE=>PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT, stock INTEGER)');
$db->exec("INSERT INTO products VALUES (1,'Tea',3),(2,'Coffee',0)");
$db->beginTransaction();
$db->commit();
echo $db->inTransaction() ? "active\n" : "finished\n";

finished

Рядом по задаче. rollBack для отмены до фиксации; outbox для надёжных внешних реакций.

• PHP: PDO::commit
• PHP: pdo.commit

PHP 5.1+; примеры PHP 8.2+ · pdo_sqlite

PDO::rollBack(): bool

<?php
require __DIR__ . '/catalog.php';
$db->beginTransaction();
$db->exec('UPDATE products SET stock = stock - 2 WHERE id = 1');
$db->rollBack();
echo "Заказ отменён, остаток восстановлен\n";
$statement = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $statement->fetch(PDO::FETCH_ASSOC);
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Заказ отменён, остаток восстановлен
Молоток — 8 шт.

Отменить изменения текущей незавершённой транзакции.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

true/false; без активной транзакции исключение независимо от ERRMODE. Возвращает autocommit. Не отменяет внешние эффекты, прошлый commit, изменения нетранзакционных таблиц и уже выполненную DDL с implicit commit. PDO автоматически откатывает незавершённую транзакцию при закрытии, если она начата через beginTransaction; не стройте договор на ручном SQL BEGIN и не оставляйте очистку только завершению процесса.

Как читать этот вариант. Второй INSERT нарушил уникальность ID. Мы вернули также первое обновление. В реальном приложении после записи безопасной диагностики ошибку передают обработчику либо возвращают явный отказ, а не сообщают успех.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT NOT NULL, price INTEGER NOT NULL)');
$db->exec("INSERT INTO products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$db->beginTransaction();
try {
    $db->exec('UPDATE products SET price = 1 WHERE id = 1');
    $db->exec("INSERT INTO products VALUES (1, 'Duplicate', 20)");
    $db->commit();
} catch (PDOException $error) {
    if ($db->inTransaction()) { $db->rollBack(); }
    echo "Отменено\n";
}
echo $db->query('SELECT price FROM products WHERE id = 1')->fetchColumn(), "\n";

Отменено
120

Как читать этот вариант. Защитная проверка относится к своей операции очистки. Она не разрешает вложенной функции отменять транзакцию, принадлежащую вызывающему коду.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
if ($db->inTransaction()) { $db->rollBack(); } else { echo "Открытой транзакции нет\n"; }

Открытой транзакции нет

Рядом: PDO::beginTransaction(), PDO::inTransaction().

Дополнительные ранее разобранные сценарии.

Откатывает поддерживаемые изменения и завершает транзакцию. Возвращает bool; без активной транзакции возможно исключение.

Как читать этот вариант. Исходный остаток восстановлен.

<?php
declare(strict_types=1);

$db=new PDO('sqlite::memory:',null,null,[PDO::ATTR_ERRMODE=>PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT, stock INTEGER)');
$db->exec("INSERT INTO products VALUES (1,'Tea',3),(2,'Coffee',0)");
$db->beginTransaction();
$db->exec('UPDATE products SET stock=99 WHERE id=1');
$db->rollBack();
echo $db->query('SELECT stock FROM products WHERE id=1')->fetchColumn()."\n";

3

Как читать этот вариант. Удаление не сохранилось после отмены сценария.

<?php
declare(strict_types=1);

$db=new PDO('sqlite::memory:',null,null,[PDO::ATTR_ERRMODE=>PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT, stock INTEGER)');
$db->exec("INSERT INTO products VALUES (1,'Tea',3),(2,'Coffee',0)");
try {
    $db->beginTransaction();
    $db->exec('DELETE FROM products WHERE id=2');
    throw new DomainException('cancelled');
} catch (DomainException) { if ($db->inTransaction()) $db->rollBack(); }
echo $db->query('SELECT COUNT(*) FROM products')->fetchColumn()."\n";

2

Рядом по задаче. commit фиксирует; finally полезен для ресурсов, но выбор commit/rollback должен быть явным.

• PHP: PDO::rollBack
• PHP: pdo.rollback

PHP 5.1+; примеры PHP 8.2+ · pdo_sqlite

PDO::inTransaction(): bool

<?php
require __DIR__ . '/catalog.php';
$db->beginTransaction();
$db->exec('UPDATE products SET stock = stock - 2 WHERE id = 1');
if ($db->inTransaction()) { echo "Резерв ещё не подтверждён\n"; }
$db->rollBack();
$statement = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $statement->fetch(PDO::FETCH_ASSOC);
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Резерв ещё не подтверждён
Молоток — 8 шт.

Узнать, остаётся ли на этом соединении активная транзакция.

$db обозначает соединение, $statement — подготовленную команду и её текущий результат. -> вызывает метод конкретного объекта, :: — статический метод или константу класса. Круглые скобки содержат аргументы; результат справа от = сохраняется в переменной. Это отдельные шаги: выполнить SQL и прочитать полученные строки. Основы: объекты, аргументы и возврат.

true при активной транзакции, false иначе; работает для поддерживающих транзакции драйверов. Это не доказательство того, что конкретная таблица умеет rollback или что вы владеете найденной транзакцией. После SQL-ошибки СУБД могут оставлять разное состояние; проверяйте её договор.

Как читать этот вариант. Метод спрашивает состояние данного драйвера/соединения, а не всего приложения. У второго PDO может быть другая транзакция.

<?php
$db = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
var_dump($db->inTransaction());
$db->beginTransaction();
var_dump($db->inTransaction());
$db->commit();
var_dump($db->inTransaction());

bool(false)
bool(true)
bool(false)

Как читать этот вариант. Объекты соединений владеют разным состоянием. Два новых :memory: к тому же имеют разные базы; общий файл не сделал бы транзакции общими.

<?php
$first = new PDO('sqlite::memory:');
$second = new PDO('sqlite::memory:');
$first->beginTransaction();
var_dump($first->inTransaction(), $second->inTransaction());
$first->rollBack();

bool(true)
bool(false)

Рядом: PDO::beginTransaction(), PDO::rollBack().

Дополнительные ранее разобранные сценарии.

Возвращает bool о состоянии, которое знает драйвер. Не сообщает уровень изоляции и не доказывает отсутствие блокировок.

Как читать этот вариант. Новое соединение не начинает прикладную транзакцию автоматически.

<?php
declare(strict_types=1);

$db=new PDO('sqlite::memory:',null,null,[PDO::ATTR_ERRMODE=>PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT, stock INTEGER)');
$db->exec("INSERT INTO products VALUES (1,'Tea',3),(2,'Coffee',0)");
echo $db->inTransaction() ? "active\n" : "autocommit\n";

autocommit

Как читать этот вариант. Вторая проверка не вызывает ошибочный повторный rollback.

<?php
declare(strict_types=1);

$db=new PDO('sqlite::memory:',null,null,[PDO::ATTR_ERRMODE=>PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT, stock INTEGER)');
$db->exec("INSERT INTO products VALUES (1,'Tea',3),(2,'Coffee',0)");
$db->beginTransaction();
if ($db->inTransaction()) $db->rollBack();
if ($db->inTransaction()) $db->rollBack();
echo "cleanup finished\n";

cleanup finished

Рядом по задаче. beginTransaction/commit/rollBack задают жизненный цикл.

• PHP: PDO::inTransaction
• PHP: pdo.intransaction