Add delete when for throttle exceptions job middleware #55717

moshe-autoleadstar · 2025-05-12T14:30:10Z

What

Adds ->deleteWhen(..) to ThrottlesExceptions job middleware (and of course ThrottlesExceptionsWithRedis)

Examples

use Illuminate\Queue\Middleware\ThrottlesExceptions;
 
public function middleware(): array
{
    return [
        new ThrottlesExceptions(10, 5)
            ->deleteWhen(ExceptionThatIsOk::class),
    ];
}

use Illuminate\Queue\Middleware\ThrottlesExceptions;
 
public function middleware(): array
{
    return [
        new ThrottlesExceptions(10, 5)
            ->deleteWhen(fn (\Throwable $throwable) => str($throwable)->contains('its all ok'))
            ->deleteWhen(fn (\Throwable $throwable) => $throwable instanceof \Illuminate\Database\QueryException
                && str($throwable->getMessage())->contains('a foreign key constraint fails')
            ),
    ];
}

Details

When using ThrottlesExceptions job middleware, we can pass a callback for ->when(..) the job should not be released back and instead throw an exception. But for most use cases, you will likely be retrying this job and therefore the job will be attempted again. The new ->deleteWhen(..) functionality allows you to exit the circuit of either throw exception or release back onto the queue, and instead to just delete the job. In this way, the job will just be deleted when this exception occurs. (Of course, you can still choose to report the exception just like before.)

…ng Arr::first with an empty generator and no callback

…ns-job-middleware

moshe-autoleadstar · 2025-05-12T14:50:43Z

i see that i have here commits from another branch. im reopening with clean working repository. see #55718

moshe-autoleadstar and others added 6 commits October 29, 2023 07:21

fix Exception: Cannot traverse an already closed generator when runni…

f7c99c1

…ng Arr::first with an empty generator and no callback

styling

4836f8b

should use default return

a8b7d3e

Merge branch 'laravel:master' into master

6ac0ed3

add deleteWhen for throttle exceptions job middleware

c739197

Merge branch 'laravel:12.x' into add-deleteWhen-for-throttle-exceptio…

b166f63

…ns-job-middleware

moshe-autoleadstar closed this May 12, 2025

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add delete when for throttle exceptions job middleware #55717

Add delete when for throttle exceptions job middleware #55717

Add delete when for throttle exceptions job middleware #55717

Add delete when for throttle exceptions job middleware #55717

Conversation

What

Examples

Details