Merge tag 'v12.25.0'

crynobone · crynobone · commit 28e071e7c492 · 2025-08-26T12:40:57.000+08:00
Signed-off-by: Mior Muhammad Zaki &lt;crynobone@gmail.com&gt;
diff --git a/Pipeline.php b/Pipeline.php
@@ -6,12 +6,14 @@
 use Illuminate\Contracts\Container\Container;
 use Illuminate\Contracts\Pipeline\Pipeline as PipelineContract;
 use Illuminate\Support\Traits\Conditionable;
+use Illuminate\Support\Traits\Macroable;
 use RuntimeException;
 use Throwable;
 
 class Pipeline implements PipelineContract
 {
     use Conditionable;
+    use Macroable;
 
     /**
      * The container implementation.
@@ -48,6 +50,13 @@ class Pipeline implements PipelineContract
      */
     protected $finally;
 
+    /**
+     * Indicates whether to wrap the pipeline in a database transaction.
+     *
+     * @var string|null|\UnitEnum|false
+     */
+    protected $withinTransaction = false;
+
     /**
      * Create a new class instance.
      *
@@ -123,7 +132,9 @@ public function then(Closure $destination)
         );
 
         try {
-            return $pipeline($this->passable);
+            return $this->withinTransaction !== false
+                ? $this->getContainer()->make('db')->connection($this->withinTransaction)->transaction(fn () => $pipeline($this->passable))
+                : $pipeline($this->passable);
         } finally {
             if ($this->finally) {
                 ($this->finally)($this->passable);
@@ -245,6 +256,19 @@ protected function pipes()
         return $this->pipes;
     }
 
+    /**
+     * Execute each pipeline step within a database transaction.
+     *
+     * @param  string|null|\UnitEnum|false  $withinTransaction
+     * @return $this
+     */
+    public function withinTransaction($withinTransaction = null)
+    {
+        $this->withinTransaction = $withinTransaction;
+
+        return $this;
+    }
+
     /**
      * Get the container instance.
      *
diff --git a/composer.json b/composer.json
@@ -16,13 +16,17 @@
     "require": {
         "php": "^8.3",
         "illuminate/contracts": "^13.0",
+        "illuminate/macroable": "^13.0",
         "illuminate/support": "^13.0"
     },
     "autoload": {
         "psr-4": {
             "Illuminate\\Pipeline\\": ""
         }
     },
+    "suggest": {
+        "illuminate/database": "Required to use database transactions (^12.0)."
+    },
     "extra": {
         "branch-alias": {
             "dev-master": "13.0.x-dev"
