docs: add "Resetting Transaction Status"

codeigniter4 · Apr 12, 2024 · 4c1ecf1 · 4c1ecf1
1 parent c121e78
commit 4c1ecf1
Show file tree

Hide file tree

Showing 2 changed files with 19 additions and 1 deletion.
diff --git a/user_guide_src/source/database/transactions.rst b/user_guide_src/source/database/transactions.rst
@@ -14,7 +14,7 @@ transactions.
 
 .. contents::
     :local:
-    :depth: 2
+    :depth: 3
 
 CodeIgniter's Approach to Transactions
 ======================================
@@ -64,6 +64,21 @@ Strict Mode can be disabled as follows:
 
 .. literalinclude:: transactions/002.php
 
+.. _transactions-resetting-transaction-status:
+
+Resetting Transaction Status
+----------------------------
+
+.. versionadded:: 4.6.0
+
+When strict mode is enabled, if one transaction fails, all subsequent transactions
+will be rolled back.
+
+If you wan to restart transactions after a failure, you can reset the transaction
+status:
+
+.. literalinclude:: transactions/009.php
+
 .. _transactions-managing-errors:
 
 Managing Errors

diff --git a/user_guide_src/source/database/transactions/009.php b/user_guide_src/source/database/transactions/009.php
@@ -0,0 +1,3 @@
+<?php
+
+$this->db->resetTransStatus();