Add test for dispatch of deferred jobs

Author: bram-pkg

src/Illuminate/Foundation/Bus/Dispatchable.php

@@ -87,6 +87,14 @@ public static function dispatchAfterResponse(...$arguments)
         return self::dispatch(...$arguments)->afterResponse();
     }
 
+    /**
+     * Defer dispatching a command to its appropriate handler.
+     */
+    public static function dispatchDefer(...$arguments)
+    {
+        return self::dispatch(...$arguments)->defer();
+    }
+
     /**
      * Set the jobs that should run if this job is successful.
      *

src/Illuminate/Foundation/Bus/PendingDispatch.php

@@ -28,7 +28,7 @@ class PendingDispatch
     protected $afterResponse = false;
 
     /**
-     * Indicates if the job should be dispatched to the queue after the current request.
+     * Indicates if the job dispatch should be deferred.
      *
      * @var bool
      */
@@ -171,7 +171,7 @@ public function afterResponse()
     }
 
     /**
-     * Indicate that the job should be dispatched to the queue after the current request.
+     * Indicate that the job dispatch should be deferred.
      *
      * @return $this
      */

tests/Integration/Queue/JobDispatchingTest.php

@@ -10,6 +10,7 @@
 use Illuminate\Queue\Events\JobQueued;
 use Illuminate\Queue\Events\JobQueueing;
 use Illuminate\Queue\InteractsWithQueue;
+use Illuminate\Support\Defer\DeferredCallbackCollection;
 use Illuminate\Support\Facades\Bus;
 use Illuminate\Support\Facades\Config;
 use Orchestra\Testbench\Attributes\WithMigration;
@@ -139,6 +140,17 @@ public function testUniqueJobLockIsReleasedForJobDispatchedAfterResponse()
         $this->assertFalse(UniqueJob::$ran);
     }
 
+    public function testDispatchDeferDelaysDispatchingUntilDeferredCallbacksAreRun()
+    {
+        $this->assertFalse(Job::$ran);
+
+        Job::dispatchDefer('test');
+
+        $this->assertFalse(Job::$ran);
+        $this->app[DeferredCallbackCollection::class]->invoke();
+        $this->assertTrue(Job::$ran);
+    }
+
     public function testQueueMayBeNullForJobQueueingAndJobQueuedEvent()
     {
         Config::set('queue.default', 'database');