PHPackages                             mxl/laravel-job - 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. mxl/laravel-job

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

mxl/laravel-job
===============

Laravel job tools

v1.7.0(1y ago)661.3M—2.2%7[1 PRs](https://github.com/mxl/laravel-job/pulls)MITPHPPHP >=7.0CI failing

Since Sep 26Pushed 1y ago1 watchersCompare

[ Source](https://github.com/mxl/laravel-job)[ Packagist](https://packagist.org/packages/mxl/laravel-job)[ Docs](https://github.com/mxl/laravel-job)[ RSS](/packages/mxl-laravel-job/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (2)Versions (12)Used By (0)

laravel-job
===========

[](#laravel-job)

[![Current version](https://camo.githubusercontent.com/285b183d31e545e6c19deb46313c05bd2f220d5d3dbaeaafdc560c75129a038b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d786c2f6c61726176656c2d6a6f622e7376673f6c6f676f3d636f6d706f736572)](https://packagist.org/packages/mxl/laravel-job)[![Monthly Downloads](https://camo.githubusercontent.com/5c1afa81b39b2762c69400b1a2933868147ceceb6ffa120b90e21cd8f715df5f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f6d786c2f6c61726176656c2d6a6f622e737667)](https://packagist.org/packages/mxl/laravel-job/stats)[![Total Downloads](https://camo.githubusercontent.com/cb8ea24cf01c630dec4cd583c80f777f17f8b2b67af794571098a7558cfe4bb2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d786c2f6c61726176656c2d6a6f622e737667)](https://packagist.org/packages/mxl/laravel-job/stats)[![Build Status](https://camo.githubusercontent.com/c3c81b67b1f47c138a1ec04f8756f7fe8578fa0200c5f39d8a036c8b71a3957c/68747470733a2f2f7472617669732d63692e6f72672f6d786c2f6c61726176656c2d6a6f622e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/mxl/laravel-job)

Laravel job tools:

- dispatch job from command line with parameters to queue or run synchronously;
- `Job` base class with boilerplate.

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

[](#installation)

```
$ composer require mxl/laravel-job
```

Laravel 5.5+ will use the [auto-discovery](https://medium.com/@taylorotwell/package-auto-discovery-in-laravel-5-5-ea9e3ab20518) feature to add `MichaelLedin\LaravelJob\LaravelJobServiceProvider::class` to providers.

This package is not compatible with older Laravel versions.

Usage
-----

[](#usage)

### Dispatching job from command line to the queue

[](#dispatching-job-from-command-line-to-the-queue)

Make sure that you either use `sync` connection (see `default` property in `config/queue.php`) or run queue worker:

```
$ php artisan queue:work
```

Then dispatch command with:

```
$ php artisan job:dispatch YourJob
```

if `YourJob` class is located under `\App\Jobs` or specify full class name with namespace:

```
$ php artisan job:dispatch '\Path\To\YourJob'
```

### Running jobs immediately

[](#running-jobs-immediately)

If you want to run job right now without posting it to queue use `job:dispatchNow` command:

```
$ php artisan job:dispatchNow YourJob
```

### Dispatching jobs with parameters

[](#dispatching-jobs-with-parameters)

```
$ php artisan job:dispatch YourJob John 1990-01-01
```

`John` and `1990-01-01` values will be passed to `YourJob` constructor as `$name` and `$birthDate` arguments:

```
class YourJob implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;

    __constructor($name, $birthDate)
   {
       // ...
   }

   public function handle()
   {
       // ...
   }
}
```

### Using job with parameters from command line and PHP code

[](#using-job-with-parameters-from-command-line-and-php-code)

Often a job is already in use somewhere from PHP code and if it has constructor arguments that must have specific type, then it can be required to parse command line parameters.

For this purpose implement `FromParameters` interface:

```
use MichaelLedin\LaravelJob\FromParameters;
use Carbon\Carbon;

class YourJob implements ShouldQueue, FromParameters
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;

    __constructor(string $name, Carbon $birthDate)
    {
        // ...
    }

    public function handle()
    {
        // ...
    }

    public static function fromParameters(...$parameters)
    {
        return new self($parameters[0], Carbon::parse($parameters[1]));
    }
}
```

### Job boilerplate

[](#job-boilerplate)

Job classes always use the same interface `ShouldQueue` and `Dispatchable`, `InteractsWithQueue`, `Queueable`, `SerializesModels` traits.

To avoid such boilerplate your jobs can extend `MichaelLedin\LaravelJob\Job` class:

```
use MichaelLedin\LaravelJob\Job;
use Carbon\Carbon;

class YourJob extends Job
{
    // ...
}
```

It also includes default `FromParameters` interface implementation that is equivalent to calling constructor with arguments provided by command line parameters without any parsing.
To add parsing override `fromParameters` method.

Maintainers
-----------

[](#maintainers)

- [@mxl](https://github.com/mxl)

Other useful Laravel packages from the author
---------------------------------------------

[](#other-useful-laravel-packages-from-the-author)

- [mxl/laravel-api-key](https://github.com/mxl/laravel-api-key) - API Key Authorization for Laravel with replay attack prevention;
- [mxl/laravel-queue-rate-limit](https://github.com/mxl/laravel-queue-rate-limit) - simple Laravel queue rate limiting;

License
-------

[](#license)

See the [LICENSE](https://github.com/mxl/laravel-job/blob/master/LICENSE) file for details.

###  Health Score

46

—

FairBetter than 93% of packages

Maintenance43

Moderate activity, may be stable

Popularity52

Moderate usage in the ecosystem

Community15

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 72.2% 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 ~198 days

Recently: every ~272 days

Total

11

Last Release

447d ago

Major Versions

v0.0.2 → v1.0.02019-09-26

### Community

Maintainers

![](https://www.gravatar.com/avatar/390a1532618e5aa4206e92972c78fcc83395fce410e935c8ed6db32d26160578?d=identicon)[mxl](/maintainers/mxl)

---

Top Contributors

[![mxl](https://avatars.githubusercontent.com/u/1078685?v=4)](https://github.com/mxl "mxl (13 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (3 commits)")[![EnhydraV](https://avatars.githubusercontent.com/u/36769987?v=4)](https://github.com/EnhydraV "EnhydraV (1 commits)")[![repat](https://avatars.githubusercontent.com/u/516807?v=4)](https://github.com/repat "repat (1 commits)")

---

Tags

laraveljobcommandtoolsdispatch

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/mxl-laravel-job/health.svg)

```
[![Health](https://phpackages.com/badges/mxl-laravel-job/health.svg)](https://phpackages.com/packages/mxl-laravel-job)
```

###  Alternatives

[lorisleiva/laravel-actions

Laravel components that take care of one specific task

2.8k7.5M115](/packages/lorisleiva-laravel-actions)[anourvalar/eloquent-serialize

Laravel Query Builder (Eloquent) serialization

11120.2M21](/packages/anourvalar-eloquent-serialize)[mpbarlow/laravel-queue-debouncer

A wrapper job for debouncing other queue jobs.

63714.4k1](/packages/mpbarlow-laravel-queue-debouncer)[pmatseykanets/artisan-beans

Easily manage your Beanstalkd job queues right from the Laravel artisan command

4482.1k](/packages/pmatseykanets-artisan-beans)[tochka-developers/queue-promises

Promises for Laravel queue jobs

1912.3k](/packages/tochka-developers-queue-promises)[maqe/laravel-sqs-fifo

Laravel package that enables support for SQS FIFO Queue

15137.2k](/packages/maqe-laravel-sqs-fifo)

PHPackages © 2026

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