PHP PDO::beginTransaction() Method: Usage and Examples

Starts a database transaction so subsequent statements can be committed or rolled back together.

The objective is to understand the behavior and operational limits, not only the method name.

What It Does

Starts a database transaction so subsequent statements can be committed or rolled back together.

Syntax and Return Value

PDO::beginTransaction(): mixed

The return value and exceptional cases depend on the call described here: DDL may cause implicit commits on MySQL; transaction support depends on the driver and storage engine.

Example 1: Basic Use

This self-contained SQLite example uses in-memory demo data; it requires the pdo_sqlite driver.

<?php
$pdo = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$pdo->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT NOT NULL, price INTEGER NOT NULL, active INTEGER)');
$pdo->exec("INSERT INTO products (id,name,price,active) VALUES (1,'Desk',120,1),(2,'Lamp',35,1),(3,'Chair',85,0)");
$pdo->beginTransaction();
try { $pdo->exec("UPDATE products SET price = price + 48 WHERE id = 1"); $pdo->commit(); } catch (Throwable $e) { if ($pdo->inTransaction()) $pdo->rollBack(); throw $e; }
echo $pdo->query("SELECT price FROM products WHERE id = 1")->fetchColumn();

Example 2: A Second Scenario

This self-contained SQLite example uses in-memory demo data; it requires the pdo_sqlite driver.

<?php
$pdo = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$pdo->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT NOT NULL, price INTEGER NOT NULL, active INTEGER)');
$pdo->exec("INSERT INTO products (id,name,price,active) VALUES (1,'Desk',120,1),(2,'Lamp',35,1),(3,'Chair',85,0)");
$pdo->beginTransaction();
try { $pdo->exec("UPDATE products SET price = price + 62 WHERE id = 2"); $pdo->commit(); } catch (Throwable $e) { if ($pdo->inTransaction()) $pdo->rollBack(); throw $e; }
echo $pdo->query("SELECT price FROM products WHERE id = 2")->fetchColumn();

Example 3: Practical Checks

This self-contained SQLite example uses in-memory demo data; it requires the pdo_sqlite driver.

<?php
$pdo = new PDO('sqlite::memory:', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$pdo->exec('CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT NOT NULL, price INTEGER NOT NULL, active INTEGER)');
$pdo->exec("INSERT INTO products (id,name,price,active) VALUES (1,'Desk',120,1),(2,'Lamp',35,1),(3,'Chair',85,0)");
$pdo->beginTransaction();
try { $pdo->exec("UPDATE products SET price = price + 79 WHERE id = 3"); $pdo->commit(); } catch (Throwable $e) { if ($pdo->inTransaction()) $pdo->rollBack(); throw $e; }
echo $pdo->query("SELECT price FROM products WHERE id = 3")->fetchColumn();

Important Behavior and Edge Cases

DDL may cause implicit commits on MySQL; transaction support depends on the driver and storage engine.

For production use, also account for error handling, data validation, resource limits and environment-specific driver behavior.

Comparison with Related Approaches

Common Beginner Mistakes

Key Takeaways

• Starts a database transaction so subsequent statements can be committed or rolled back together.
• DDL may cause implicit commits on MySQL; transaction support depends on the driver and storage engine.
• commit makes changes permanent; rollBack discards eligible uncommitted changes.

Choose this API or pattern when its exact semantics match your task, and verify the result against the database driver and runtime used by your application.