Add defer method to PendingDispatch

Author: bram-pkg

src/Illuminate/Foundation/Bus/PendingDispatch.php

@@ -27,6 +27,13 @@ class PendingDispatch
      */
     protected $afterResponse = false;
 
+    /**
+     * Indicates if the job should be dispatched to the queue after the current request.
+     *
+     * @var bool
+     */
+    protected $defer = true;
+
     /**
      * Create a new pending job dispatch.
      *
@@ -163,6 +170,18 @@ public function afterResponse()
         return $this;
     }
 
+    /**
+     * Indicate that the job should be dispatched to the queue after the current request.
+     *
+     * @return $this
+     */
+    public function defer(): static
+    {
+        $this->defer = true;
+
+        return $this;
+    }
+
     /**
      * Determine if the job should be dispatched.
      *
@@ -217,6 +236,8 @@ public function __destruct()
             return;
         } elseif ($this->afterResponse) {
             app(Dispatcher::class)->dispatchAfterResponse($this->job);
+        } elseif ($this->defer) {
+            defer(fn () => app(Dispatcher::class)->dispatch($this->job));
         } else {
             app(Dispatcher::class)->dispatch($this->job);
         }

tests/Bus/BusPendingDispatchTest.php

@@ -103,6 +103,14 @@ public function testAfterResponse()
         );
     }
 
+    public function testDefer()
+    {
+        $this->pendingDispatch->defer();
+        $this->assertTrue(
+            (new ReflectionClass($this->pendingDispatch))->getProperty('defer')->getValue($this->pendingDispatch)
+        );
+    }
+
     public function testGetJob()
     {
         $this->assertSame($this->job, $this->pendingDispatch->getJob());