Add database afterRollback callback support and tests (#57180)

* Add database afterRollback callback support and tests

* Update ManagesTransactions.php

* Update DB.php

* Update DatabaseTransactionsTest.php

---------

Co-authored-by: Taylor Otwell <[email protected]>

Author: maltekuhr

src/Illuminate/Database/Concerns/ManagesTransactions.php

@@ -353,4 +353,21 @@ public function afterCommit($callback)
 
         throw new RuntimeException('Transactions Manager has not been set.');
     }
+
+    /**
+     * Execute the callback after a transaction rolls back.
+     *
+     * @param  callable  $callback
+     * @return void
+     *
+     * @throws \RuntimeException
+     */
+    public function afterRollBack($callback)
+    {
+        if ($this->transactionsManager) {
+            return $this->transactionsManager->addCallbackForRollback($callback);
+        }
+
+        throw new RuntimeException('Transactions Manager has not been set.');
+    }
 }

src/Illuminate/Support/Facades/DB.php

@@ -114,6 +114,7 @@
  * @method static void rollBack(int|null $toLevel = null)
  * @method static int transactionLevel()
  * @method static void afterCommit(callable $callback)
+ * @method static void afterRollBack(callable $callback)
  *
  * @see \Illuminate\Database\DatabaseManager
  */

tests/Integration/Database/DatabaseTransactionsTest.php

@@ -105,6 +105,31 @@ public function testTransactionsDoNotAffectDifferentConnections()
         $this->assertTrue($secondObject->ran);
         $this->assertFalse($thirdObject->ran);
     }
+
+    public function testAfterRollbackCallbacksAreExecuted()
+    {
+        $afterCommitRan = false;
+        $afterRollbackRan = false;
+
+        try {
+            DB::transaction(function () use (&$afterCommitRan, &$afterRollbackRan) {
+                DB::afterCommit(function () use (&$afterCommitRan) {
+                    $afterCommitRan = true;
+                });
+
+                DB::afterRollBack(function () use (&$afterRollbackRan) {
+                    $afterRollbackRan = true;
+                });
+
+                throw new \RuntimeException('rollback');
+            });
+        } catch (\RuntimeException) {
+            // Ignore the expected rollback exception.
+        }
+
+        $this->assertFalse($afterCommitRan);
+        $this->assertTrue($afterRollbackRan);
+    }
 }
 
 class TestObjectForTransactions