Transakce v PHP s mysqli a MariaDB

Pokud ve spolupráci s databází MariaDB (svobodný nástupce MySQL) využíváte programovací jazyk 
PHP verze => 8.4 (rok 2025) a k MariaDB přistupujete přes objektové rozhraní mysqli, můžete využívat speciálních objektových metod tohoto rozhraní, které práci s transakcemi zastřešují. Navíc je žádoucí v transakcích používat parametrizované dotazy.

Základem objektového přístupu k rozhraní mysqli a transakcím v PHP jsou tyto klíčové prvky:

1. $mysqli = new mysqli("localhost", "testik", "testik", "testik");   // přihlášení uživatele k databázi
   //============ zde transakce začíná ==============
2. $mysqli->begin_transaction();  // začátek transakce
3. Provedení potřebných databázových operaccí uvnitř bloku try-catch, například:
   ✅ odečtení častky z účtu odesílatele, 
   ✅ přičtení částky na účet příjemce,
   ✅ zapsání do tabulky provedených transakcí
   
   
4. $mysqli->commit();    // pokud předcházející SQL dotazy proběhly bezchybně, potvrdit transakci
   
   nebo
   
   $mysqli->rollback();   // zrušit transakci (storno transakce, vrácení zpět) při chybě
   //============ zde transakce končí ===============
5. $mysqli->close();   // ukončení spojení k MariaDB

Viz transakce v PHP s mysqli rozhraním.

Transakce jsou důležitým nástrojem pro zajištění konzistence dat v databázi. Umožňují seskupit více databázových operací do jednoho celku, který se buď celý provede, nebo se neprovedou žádné z jeho částí. 
Chcete-li používat transakce, musíte používat tabulky typu InnoDB. Jde o zachování integrity databáze. Zjednodušeně se to přirovnává k převodům peněz u bankovních účtů. Pokud odešleme nějakou čásku na bankovní účet příjemce, nejdříve se nám odečte částka z účtu a poté se přičte na účet příjemce.
Ale co když po odečtení částky z našeho účtu se něco pokazí a částka se na účet příjemce nepřipíše? V takovém případě by odeslaná částka byla ztracena, zmizela. Je jasné, že takový případ nesmí nikdy nastat, v takovém případě je nutno používat transakce.

ACID

Transakce by měly splňovat takzvaná ACID pravidla. Tato zkratka je složena z počátečních písmen 4 vlastností správné transakce (angl. atomicity - A, consistency - C, isolation - I, durability - D):

• atomicita - znamená že se operace provede celá, nebo vůbec. Neexistuje možnost že se provede pouze část
• konzistence - transakce nenaruší integritu databáze
• izolovanost - pokud běží více transakcí zároveň, neovlivňují se
• trvalost - změny provedené transakcí jsou trvale uložené

Všechna pravidla ACID splňuje v PHP objektové mysqli rozhraní nad databází MariaDB (používá i google).

Příklad implementace transakce v PHP objektově s mysqli

Pro praktické vyzkoušení transakcí je třeba si v PHPMyadmin vytvořit databázi "testik", uživatele "testik" s heslem "testik", tabulky "ucty" a "prevody". V tabulce převody budou uložené všechny uskutečněné transakce. Samozřejmě to vytváříme na lokálním notebooku (PC), ne na serveru.

SQL pro vytvoření tabulky v konzoli nebo například v MyPHPadmin:

START TRANSACTION;
CREATE TABLE `prevody` (
 `prevod_id` int(10) UNSIGNED NOT NULL,
 `cas` timestamp NOT NULL DEFAULT current_timestamp(),
 `z_uctu_id` int(10) UNSIGNED DEFAULT NULL,
 `na_ucet_id` int(10) UNSIGNED DEFAULT NULL,
 `castka` decimal(19,2) UNSIGNED DEFAULT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_czech_ci;
CREATE TABLE `ucty` (
 `ucet_id` int(10) UNSIGNED NOT NULL,
 `klient` varchar(50) DEFAULT NULL,
 `aktualni_zustatek` decimal(19,2) DEFAULT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_czech_ci;
INSERT INTO `ucty` (`ucet_id`, `klient`, `aktualni_zustatek`) VALUES
(1, 'Petr Novák', 10000),
(2, 'Josef Lux', 10000),
(3, 'Anna Bílá', 10000);
ALTER TABLE `prevody`
 ADD PRIMARY KEY (`prevod_id`);
ALTER TABLE `ucty`
 ADD PRIMARY KEY (`ucet_id`);
ALTER TABLE `prevody`
 MODIFY `prevod_id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT;
ALTER TABLE `ucty`
 MODIFY `ucet_id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT, AUTO_INCREMENT=4;
COMMIT;

Pokud máte tabulky úspěšně vytvořeny, je možno začat psát kód v PHP. Nejdříve si vytvoříme soubor "config.ini.php":

<?php
define ("DB_HOST", "localhost");
define ("DATABAZE", "testik");
define ("DB_USER", "testik");
define ("PASVORTO", "testik");
?>

Ještě styl "mysql.css" pro zobrazení tabulek:

.tb_vypis {
font-size: smaller;
border-collapse: collapse;
height:auto;
margin: 2px;
}
.tb_vypis th {
background-color: #000000;
color: #FFFFFF;
text-align: center !important;
border: 1px solid #AAAAAA;
}
.tb_vypis td {
border: 1px solid #AAAAAA;
}
.tb_vypis a {
text-decoration: none;
}
.vypis_vpravo {
text-align: right !important;
}

A nyní je již možno si vytvořit soubor "index.php":

Klíčové kroky u transakcí

1. Zahájíte transakci voláním $mysqli->begin_transaction().
2. Provedete potřebné databázové operace uvnitř bloku try-catch.
3. Pokud vše proběhne v pořádku, uložíte změny voláním $mysqli->commit().
4. V případě chyby vrátíte databázi do předchozího stavu voláním $mysqli->rollback().

Tento přístup zajistí, že se buď všechny operace provedou, nebo se neprovedou žádné.

U výše uvedeného výpisu php kódu je třeba si všimnout u přihlašování k databázi ošetření chyb pomocí vyjímek. Často se stává, že vývojáři sice tvoří kód v objektovém stylu, ale zapomínají na ošetření chyb pomocí vyjímek. Místo toho používají zastaralý způsob ošetření chyb v objektovém programování pomocí návratové hodnoty funkce, což je špatně!
Pro názornost takového špatného kódu si uvedeme příklad:

$conn = new mysqli(DB_HOST, DB_USER, PASVORTO, DATABAZE);
if ($conn->connect_error) {
die("Connection failed: " . $conn->connect_error);
}

Správné ošetření chybného přihlášení k databázi pomocí vyjímky

try {
  $mysqli = new mysqli(DB_HOST, DB_USER, PASVORTO, DATABAZE);    // přihlášení uživatele k databázi
  if ($mysqli->character_set_name()!="utf8mb4") { $mysqli->set_charset("utf8mb4"); }  // zjištění / změna kódování
} catch (Exception $e) {
  exit("Do databáze se nelze připojit!<br />".$e->getMessage()); // při chybě ukončení s výpisem chybové hlášky
}

ošetřená vyjímka

Na řádku 57 v souboru "index.php" je úmyslná chyba (místo '...ucty3...' má být '...ucty...'). Tímto se při zadání účtů a částky ve formuláři vyvolá vyjímka a její ošetření. Transakce je tím zrušena - stornována.

Objektové zpracování chybného přihlášení, ošetření zadávání a zobrazování českého formátu čísel (částek, zůstatků a měny), české zobrazování datumů, zpracování vyjímek

1. MySQLi objektově v PHP (ošetření PHP vyjímek v objektovém programování)
   Objektové zpracování přihlášení do databáze pomocí ošetření PHP vyjímek, ošetření transakcí pomocí vyjímek (commit = potvrzení transakce, rollback = zrušení transakce).
   try { ... } catch (Exception $e) {  $mysqli->rollback(); ".$e->getMessage()."<br>"; }
2. Návod na zkrácený zápis parametrizovaného dotazu s execute_query
   Je možno používat execute_query() od PHP 8.2 a vyšší.
3. zadávání českého formátu čísel, částek
   // konverze českého čísla na number mariaDB standard
   PHP:
   $zdroj = array(" ",","); $cil = array("",".");
   $castka = str_replace($zdroj, $cil, $castka);
   
   
4. zobrazování českého formátu čísel, částek
   PHP: number_format($zaznam['aktualni_zustatek'],2,',',' ')
   SQL: CONCAT(FORMAT(castka, 2, 'cs_CZ'),' Kč') as 'částka'
5. české zobrazování datumů
   SQL: select date_format(cas,'%d.%m.%Y %H:%i:%s') as 'čas'

Upozornění

Interní funkce PHP používají hlavně hlášení chyb, výjimky používají pouze moderní objektově orientovaná rozšíření.
Chyby však lze snadno převést na výjimky pomocí ErrorException.
Tato technika však funguje pouze s nefatálními chybami.

Error exception

function exceptions_error_handler($severity, $message, $filename, $lineno) {
throw new ErrorException($message, 0, $severity, $filename, $lineno);
}
set_error_handler('exceptions_error_handler');

Odkazy

1. Jak správně provádět transakce