PHPackages                             saeedvaziry/laravel-async - 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. saeedvaziry/laravel-async

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

saeedvaziry/laravel-async
=========================

Run asynchronous code in Laravel without waiting for results

1.4.0(3mo ago)15310.8k↓77.8%13[6 issues](https://github.com/saeedvaziry/laravel-async/issues)MITPHPPHP ^8.1CI failing

Since Nov 29Pushed 3mo ago8 watchersCompare

[ Source](https://github.com/saeedvaziry/laravel-async)[ Packagist](https://packagist.org/packages/saeedvaziry/laravel-async)[ RSS](/packages/saeedvaziry-laravel-async/feed)WikiDiscussions main Synced today

READMEChangelog (9)Dependencies (12)Versions (10)Used By (0)

Laravel Async
=============

[](#laravel-async)

[![Packagist License](https://camo.githubusercontent.com/ad7b539a762caf98e1156ee6e04a85d8bd967ef9748bd1604fb71054c1a2d57b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f736165656476617a6972792f6c61726176656c2d6173796e633f7374796c653d706c6173746963)](https://packagist.org/packages/saeedvaziry/laravel-async)[![Packagist Version](https://camo.githubusercontent.com/d53f0bb2a053df10224787f1ba8be160a895790889c6c814223c7637a0385467/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f736165656476617a6972792f6c61726176656c2d6173796e633f7374796c653d706c6173746963)](https://packagist.org/packages/saeedvaziry/laravel-async)[![Packagist Downloads](https://camo.githubusercontent.com/d1d30f87b353ec64fa4c333ebf844db48d141b2cdcef36f40b7fc7227be339ed/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f736165656476617a6972792f6c61726176656c2d6173796e633f7374796c653d706c6173746963)](https://packagist.org/packages/saeedvaziry/laravel-async/stats)[![PHP Dependency Version](https://camo.githubusercontent.com/3a6ca9c903a238285b62e05adce40f885141709987996c9e7c8513bcb4401346/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f736165656476617a6972792f6c61726176656c2d6173796e632f7068703f7374796c653d706c6173746963266c6162656c3d504850)](https://packagist.org/packages/saeedvaziry/laravel-async)[![GitHub Actions Workflow Status](https://github.com/saeedvaziry/laravel-async/actions/workflows/tests.yml/badge.svg)](https://github.com/saeedvaziry/laravel-async/actions/workflows/tests.yml)[![GitHub Repo Stars](https://camo.githubusercontent.com/4892eaef92d89ef17798d5a0c69ec4ae31cd63c9801ae42f67714e84effc94a8/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f736165656476617a6972792f6c61726176656c2d6173796e63)](https://github.com/saeedvaziry/laravel-async)

    laravel-async-demo.mp4    Laravel Async is a simple package for Laravel that enables you to run your code asynchronously without using the workers and Supervisor!

Unlike the Laravel Process, Symfony Process, or other similar packages, You don't need to wait for the sub-processes in the main process to finish!

```
use SaeedVaziry\LaravelAsync\Facades\AsyncHandler;

AsyncHandler::dispatch(function () {
    sleep(10);

    info("Hello from Async process after 10 seconds!");
});

info("dispatched the process!");
```

Demo
----

[](#demo)

How it works?
-------------

[](#how-it-works)

You can call it a hack or a trick! but Laravel Async uses the background process of the OS to run your code.

It provides a simple Laravel Console Command that unserializes your code and runs it in the background of the OS.

Do note, because we do not wait for the async code to finish, if you need to know the results of your async code, you should read/write the results using other ways, e.g. through a database.

Supported OS
------------

[](#supported-os)

Currently, it only supports Linux and Unix-based operating systems.

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

[](#installation)

You can install the package via Composer:

```
composer require saeedvaziry/laravel-async
```

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

[](#configuration)

To publish the configuration file, you can run the following command:

```
php artisan vendor:publish --provider="SaeedVaziry\LaravelAsync\LaravelAsyncServiceProvider"
```

This will create a `laravel-async.php` file in your `config` directory.

**php\_path**

The path to the PHP executable. The default value which is the path to the PHP binary should work for CLI usage. However, If you want to use it in web, You should set the path to the PHP binary because the default value will be the path to the web server's PHP binary like php-fpm.

You can also set via the `.env` file.

```
LARAVEL_ASYNC_PHP_PATH=/path/to/php
```

Usage
-----

[](#usage)

The usage is very simple and straightforward. You can provide the Closure or your Laravel Job class to the `AsyncHandler` facade.

### Closure

[](#closure)

```
use SaeedVaziry\LaravelAsync\Facades\AsyncHandler;

AsyncHandler::dispatch(function () {
    info("Hello from Async process!");
});
```

### Job

[](#job)

You can send Jobs or any other classes that have a `handle` method.

```
use SaeedVaziry\LaravelAsync\Facades\AsyncHandler;

AsyncHandler::dispatch(new MyJob());
```

### Timeouts

[](#timeouts)

The default timeout is 60 seconds.

This will set a timeout of 10 seconds to the process and if it didn't finish in 10 seconds it will kill the process.

```
use SaeedVaziry\LaravelAsync\Facades\AsyncHandler;

AsyncHandler::timeout(10)->dispatch(function () {
    info("Hello from Async process!");
});
```

You can also dispatch without a timeout!

!!! Be careful about this because if your code gets stuck in an infinite loop, it will drain your server resources.

```
use SaeedVaziry\LaravelAsync\Facades\AsyncHandler;

AsyncHandler::withoutTimeout()->dispatch(function () {
    info("Hello from Async process!");
});
```

Testing
-------

[](#testing)

You can fake the `AsyncHandler`'s facade in your tests and check if the code is dispatched or not.

```
use SaeedVaziry\LaravelAsync\Facades\AsyncHandler;

AsyncHandler::fake();

// Your code that dispatches the AsyncHandler

AsyncHandler::assertDispatchedCounts(1);
```

You can test to see how many times you dispatched an async process.

Contributing
------------

[](#contributing)

Please feel free to submit an issue or open a PR.

License
-------

[](#license)

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

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance80

Actively maintained with recent releases

Popularity41

Moderate usage in the ecosystem

Community17

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 79.4% 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 ~105 days

Recently: every ~211 days

Total

9

Last Release

102d ago

Major Versions

0.0.2 → 1.0.02023-11-30

PHP version history (2 changes)0.0.1PHP ^8.0

1.0.0PHP ^8.1

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/61919774?v=4)[Saeed Vaziry](/maintainers/saeedvaziry)[@saeedvaziry](https://github.com/saeedvaziry)

---

Top Contributors

[![saeedvaziry](https://avatars.githubusercontent.com/u/61919774?v=4)](https://github.com/saeedvaziry "saeedvaziry (27 commits)")[![Vectorial1024](https://avatars.githubusercontent.com/u/17726797?v=4)](https://github.com/Vectorial1024 "Vectorial1024 (6 commits)")[![prabowosd](https://avatars.githubusercontent.com/u/5931987?v=4)](https://github.com/prabowosd "prabowosd (1 commits)")

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/saeedvaziry-laravel-async/health.svg)

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

###  Alternatives

[laravel/sail

Docker files for running a basic Laravel application.

1.9k205.7M1.3k](/packages/laravel-sail)[illuminate/queue

The Illuminate Queue package.

21332.6M1.6k](/packages/illuminate-queue)[laravel/ai

The official AI SDK for Laravel.

1.0k3.2M194](/packages/laravel-ai)[laravel/mcp

Rapidly build MCP servers for your Laravel applications.

77022.3M151](/packages/laravel-mcp)[tallstackui/tallstackui

TallStackUI is a powerful suite of Blade components that elevate your workflow of Livewire applications.

725173.0k14](/packages/tallstackui-tallstackui)[propaganistas/laravel-disposable-email

Disposable email validator

6023.0M6](/packages/propaganistas-laravel-disposable-email)

PHPackages © 2026

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