PHPackages                             jdavidbakr/multi-server-event - 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. [Utility & Helpers](/categories/utility)
4. /
5. jdavidbakr/multi-server-event

Abandoned → [laravel/laravel:5.6](/?search=laravel%2Flaravel%3A5.6)Library[Utility & Helpers](/categories/utility)

jdavidbakr/multi-server-event
=============================

This package extends Laravel's native Command Event class to allow for managing events fired on the same system with multiple servers, preventing an event from firing more than once

2.0.5(8y ago)36179.4k↓29.1%17MITPHPPHP >=5.5.9

Since Aug 11Pushed 8y ago3 watchersCompare

[ Source](https://github.com/jdavidbakr/MultiServerEvent)[ Packagist](https://packagist.org/packages/jdavidbakr/multi-server-event)[ RSS](/packages/jdavidbakr-multi-server-event/feed)WikiDiscussions master Synced yesterday

READMEChangelog (10)Dependencies (3)Versions (17)Used By (0)

Multi Server Event
==================

[](#multi-server-event)

[![Latest Version on Packagist](https://camo.githubusercontent.com/6f9dd42adcae688d61f632a6870bbdcef618aad627ac6eabf2e520022468314a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6a646176696462616b722f6d756c74692d7365727665722d6576656e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/jdavidbakr/multi-server-event)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Total Downloads](https://camo.githubusercontent.com/dfb307e1b21285c75382bebe868f4694f71a90ef815e8f465557f98afb68b62b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6a646176696462616b722f6d756c74692d7365727665722d6576656e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/jdavidbakr/multi-server-event)

This package extends Laravel's native Event class to include the ability to block events from occurring aross multiple servers, as would be the case if you have a laravel instance behind a load balancer in an auto-scaling situation.

It uses a database table to track the currently running process, and each server generates a unique key to lock the command. In order to prevent a condition where a short-running command's lock doesn't last long enough, we are implementing a minimum 10 second break between the completion of the command and its next execution time, so if a command runs every minute but takes between 50 and 59 seconds to complete, the next command will be delayed one more minute.

NOTE: Laravel 5.6 now contains a function `onOneServer()` that solves the issue that this package was built to fix. Therefore, it is recommended that you use the core function instead of this package.
========================================================================================================================================================================================================

[](#note-laravel-56-now-contains-a-function-ononeserver-that-solves-the-issue-that-this-package-was-built-to-fix-therefore-it-is-recommended-that-you-use-the-core-function-instead-of-this-package)

#### For Laravel < 5.4, please use version 1.X

[](#for-laravel--54-please-use-version-1x)

#### Upgrading from version 1.X

[](#upgrading-from-version-1x)

If upgrading from version 1.X, please note the change in the defineConsoleSchedule() command in app\\Console\\Kernel.php.

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

[](#installation)

```
$ composer require jdavidbakr/multi-server-event

```

The new event structure uses a database table to track which server is currently executing an event. You must create the database table using the provided migration. To do this, add the following to the $commands array in \\App\\Console\\Kernel.php:

```
\jdavidbakr\MultiServerEvent\Commands\MultiServerMigrationService::class,
```

then perform the migration

```
php artisan make:migration:multi-server-event
php artisan migrate

```

Now we want to change the default schedule IoC to use this alternate one. In app\\Console\\Kernel.php add the following function:

```
/**
 * Define the application's command schedule.
 *
 * @return void
 */
protected function defineConsoleSchedule()
{
    $this->app->instance(
        Schedule::class,
        $schedule = new \jdavidbakr\MultiServerEvent\Scheduling\Schedule()
    );

    $this->schedule($schedule);
}
```

Usage
-----

[](#usage)

When composing your schedule, simply add "withoutOverlappingMultiServer()" to the command, i.e.

```
$schedule->command('inspire')
    ->daily()
    ->withoutOverlappingMultiServer();
```

This will prevent multiple servers from executing the same event at the same time.

When composing your schedule, you can also ensure that cron is not stuck, simply add "ensureFinishedMultiServer()" to the command, i.e.

```
$schedule->command('inspire')
    ->daily()
    ->withoutOverlappingMultiServer()
    ->ensureFinishedMultiServer(30);
```

This will prevent from stuck commands during lost connection or deployment. Note, choose time to be enough to mark as "stuck", fox example, long running command should have bigger tolerance time. You can track such events how ofter it happens by binding listeners on `EnsureCleanUpExecuted` event

Testing
-------

[](#testing)

```
phpunit

```

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity45

Moderate usage in the ecosystem

Community16

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 80% 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 ~65 days

Recently: every ~92 days

Total

15

Last Release

3065d ago

Major Versions

1.0.6 → 2.0.02017-02-02

1.0.8 → 2.0.22017-05-01

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/25177?v=4)[J David Baker](/maintainers/jdavidbakr)[@jdavidbakr](https://github.com/jdavidbakr)

---

Top Contributors

[![jdavidbakr](https://avatars.githubusercontent.com/u/25177?v=4)](https://github.com/jdavidbakr "jdavidbakr (12 commits)")[![pulkitjalan](https://avatars.githubusercontent.com/u/4124930?v=4)](https://github.com/pulkitjalan "pulkitjalan (2 commits)")[![investonline](https://avatars.githubusercontent.com/u/20278343?v=4)](https://github.com/investonline "investonline (1 commits)")

---

Tags

schedulerlaravelload balancingMulti-Server

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/jdavidbakr-multi-server-event/health.svg)

```
[![Health](https://phpackages.com/badges/jdavidbakr-multi-server-event/health.svg)](https://phpackages.com/packages/jdavidbakr-multi-server-event)
```

###  Alternatives

[grumpydictator/firefly-iii

Firefly III: a personal finances manager.

23.9k69.5k](/packages/grumpydictator-firefly-iii)[firefly-iii/data-importer

Firefly III Data Import Tool.

8035.8k](/packages/firefly-iii-data-importer)[markwalet/nova-modal-response

A Laravel Nova asset for Modal responses on an action.

17878.9k](/packages/markwalet-nova-modal-response)[ronasit/laravel-helpers

Provided helpers function and some helper class.

2085.6k31](/packages/ronasit-laravel-helpers)[team-nifty-gmbh/tall-datatables

Server-side rendered datatables for Laravel and Livewire

1320.9k4](/packages/team-nifty-gmbh-tall-datatables)[tomshaw/electricgrid

A feature-rich Livewire package designed for projects that require dynamic, interactive data tables.

119.4k](/packages/tomshaw-electricgrid)

PHPackages © 2026

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