PHPackages                             smitmartijn/laravel-pausable-jobs - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Queues & Workers](/categories/queues)
4. /
5. smitmartijn/laravel-pausable-jobs

ActiveLibrary[Queues & Workers](/categories/queues)

smitmartijn/laravel-pausable-jobs
=================================

Pause and resume Laravel jobs individually, instead of having to pause the entire queue.

v1.1.0(9mo ago)32.6k↓50%MITPHPPHP ^8.1

Since Feb 8Pushed 9mo ago1 watchersCompare

[ Source](https://github.com/smitmartijn/laravel-pausable-jobs)[ Packagist](https://packagist.org/packages/smitmartijn/laravel-pausable-jobs)[ RSS](/packages/smitmartijn-laravel-pausable-jobs/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (1)Versions (3)Used By (0)

Laravel Pausable Jobs
=====================

[](#laravel-pausable-jobs)

Pause and resume individual Laravel job classes without stopping your entire queue. Imagine you have a ton of queue jobs running, and you need to do maintenance on a part of the application, and only a select few jobs touch that part of the application.

Being able to pause specific job classes will let you run your maintenance without slowing down the rest of the application jobs.

Features
--------

[](#features)

- Pause/resume individual job classes
- Works with multiple queue workers
- Redis or Cache driver support to store pause states
- Optional logging of pause/resume actions
- Compatible with Laravel Horizon
- No impact on other running jobs
- Configurable retry and max retry times.

Installation
------------

[](#installation)

```
composer require smitmartijn/laravel-pausable-jobs

php artisan vendor:publish --tag=pausable-jobs-config
```

Usage
-----

[](#usage)

1. Add the trait to your job:

```
use Smitmartijn\PausableJobs\Concerns\PausableJob;

class ProcessVideoJob implements ShouldQueue
{
    use PausableJob;

    public function handle()
    {
        // Your job logic
    }
}
```

2. Control job execution:

```
use App\Jobs\ProcessVideoJob;
use Smitmartijn\PausableJobs\Facades\JobPause;

// Pause ProcessVideoJob
JobPause::pauseJobClass(ProcessVideoJob::class);

// Resume ProcessVideoJob
JobPause::resumeJobClass(ProcessVideoJob::class);

// Check status
if (JobPause::isPaused(ProcessVideoJob::class)) {
    // Job is paused
}
```

Configuration
-------------

[](#configuration)

`config/pausable-jobs.php`:

```
return [
    // Use the 'redis' or 'cache' driver - this is where the job pause state is stored
    'driver' => env('PAUSABLE_JOBS_DRIVER', 'redis'),
    // The number of seconds to wait before retrying a paused job
    'retry_after' => env('PAUSABLE_JOBS_RETRY_AFTER', 30),
    // The maximum number of seconds a job can be retried before it is deleted
    'max_retry_time' => env('PAUSABLE_JOBS_MAX_RETRY_TIME', 3600),
    // Logging configuration, which will log when a job is retried because its paused
    'logging' => [
        'enabled' => env('PAUSABLE_JOBS_LOGGING', true),
        'channel' => env('PAUSABLE_JOBS_LOG_CHANNEL', 'stack'),
    ],
];
```

Pause State Manager with Filament v3
------------------------------------

[](#pause-state-manager-with-filament-v3)

I've included an example Filament v3 widget that you can use to get an overview of all pausable jobs, and easily pause and resume them. Find more information in [examples/FilamentWidgetExample](./examples/FilamentWidgetExample/README.md). Here's what it looks like:

[![Filament Widget Example](examples/FilamentWidgetExample/assets/screenshot.gif)](examples/FilamentWidgetExample/assets/screenshot.gif)

Requirements
------------

[](#requirements)

- PHP 8.1+
- Laravel 10+
- Redis (optional)

License
-------

[](#license)

MIT License (MIT). Please see [License File](./LICENSE.md) for more information.

Support me
----------

[](#support-me)

If you've found this package useful and want to support my work, feel free to look at purchasing one of [my paid products listed on lostdomain.org](https://lostdomain.org/). You can also find me on [Bluesky](https://bsky.app/profile/lostdomain.org) 😊

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance56

Moderate activity, may be stable

Popularity23

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~169 days

Total

2

Last Release

289d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3a21fee55a7eb0a7b9b3eb2f2904b60e65627041e1c2b515cf59133dc2cccbb5?d=identicon)[smitmartijn](/maintainers/smitmartijn)

---

Top Contributors

[![smitmartijn](https://avatars.githubusercontent.com/u/6500836?v=4)](https://github.com/smitmartijn "smitmartijn (2 commits)")

### Embed Badge

![Health badge](/badges/smitmartijn-laravel-pausable-jobs/health.svg)

```
[![Health](https://phpackages.com/badges/smitmartijn-laravel-pausable-jobs/health.svg)](https://phpackages.com/packages/smitmartijn-laravel-pausable-jobs)
```

###  Alternatives

[mpbarlow/laravel-queue-debouncer

A wrapper job for debouncing other queue jobs.

63714.4k1](/packages/mpbarlow-laravel-queue-debouncer)[eyewitness/eye

Eyewitness.io client for Laravel 5 applications

116151.8k](/packages/eyewitness-eye)[therezor/laravel-transactional-jobs

Submit laravel jobs inside transaction. Cancel job after rollback. Proceed after successful commit.

44449.4k](/packages/therezor-laravel-transactional-jobs)[convenia/pigeon

3233.0k](/packages/convenia-pigeon)[baklysystems/laravel-chat-messenger

Laravel chat package

121.8k](/packages/baklysystems-laravel-chat-messenger)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)