PHPackages                             decahedron/laravel-app-events - 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. decahedron/laravel-app-events

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

decahedron/laravel-app-events
=============================

Manage application-wide events for SOAs with Google Cloud PubSub

v1.5.9(2y ago)517.2k3[1 PRs](https://github.com/decahedronio/laravel-app-events/pulls)MITPHPPHP >= 7.3CI failing

Since Jan 8Pushed 1y ago5 watchersCompare

[ Source](https://github.com/decahedronio/laravel-app-events)[ Packagist](https://packagist.org/packages/decahedron/laravel-app-events)[ RSS](/packages/decahedron-laravel-app-events/feed)WikiDiscussions master Synced yesterday

READMEChangelog (10)Dependencies (8)Versions (30)Used By (0)

Laravel App Events for Google Cloud PubSub
==========================================

[](#laravel-app-events-for-google-cloud-pubsub)

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

[](#installation)

Install through Composer with `composer require decahedron/laravel-app-events`

Usage
-----

[](#usage)

The App Event as implemented in this package is just a regular Laravel job class that gets dispatched as usual with the `dispatch` method.

### Dispatching ("broadcasting") events

[](#dispatching-broadcasting-events)

When you dispatch an app event, you must provide an event name, and a payload in the form of a protobuf message.

```
dispatch(new AppEvent('user.created', new User(['name' => $user->name])));
```

In order for this to get properly encoded, you also need to provide a mapping from a name to the class implementation. This allows the package to encode the message in a way that is not bound exclusively to PHP, and thus allows decoding the message into a protobuf structure in any language that protobuf supports.

#### Configuration for broadcasting

[](#configuration-for-broadcasting)

```
return [
    'enabled' => true,
    'project_id' => 'your-google-project',
    'topic' => 'app-events',
    'subscription' => 'login-handler'

    'mappings' => [
        'User' => App\Proto\User::class,
    ],
];
```

### Handling events

[](#handling-events)

Events can be handled by any application that is able to communicate with Google Cloud PubSub, and is written in a language that can use protobuf.

To handle events with this package, your handling application (which may be the same as the dispatching one) must contain the following configuration.

```
return [
    'enabled' => true,
    'project_id' => 'your-google-project',
    'topic' => 'app-events',
    'subscription' => 'user-registrator',

    'mappings' => [
        'User' => App\Proto\User::class,
    ],

    'handlers' => [
        'user.created' => App\Auth\RegisterUser::class,
    ],
];
```

The handler specified here must be a class with a `handle` method, which accepts the protobuf message as an argument. This class gets resolved through the Laravel container, so you may use constructor injection:

```
class RegisterUser
{
    protected $registrator;

    public function __construct(Registrator $registrator)
    {
        $this->registrator = $registrator;
    }

    public function handle(User $user)
    {
        $this->registrator->register(
            $user->getName(),
            $user->getEmail(),
        );
    }
}
```

Note that the `mappings` are still required here, in order to convert the data back into the correct protobuf message. Therefore, it might be beneficial to place your base configuration (not including the subscription name and handlers) in a shared location so it can be updated in all places at once.

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance26

Infrequent updates — may be unmaintained

Popularity27

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 81% 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 ~147 days

Total

28

Last Release

915d ago

Major Versions

v0.4.2 → v1.0.02019-07-30

### Community

Maintainers

![](https://www.gravatar.com/avatar/1f7c369fe9e0f2394fa77dfd669ab045a4743a517fc08dcfdbc65dbe17928178?d=identicon)[phroggyy](/maintainers/phroggyy)

---

Top Contributors

[![phroggyy](https://avatars.githubusercontent.com/u/7256451?v=4)](https://github.com/phroggyy "phroggyy (34 commits)")[![andvla](https://avatars.githubusercontent.com/u/12616998?v=4)](https://github.com/andvla "andvla (6 commits)")[![svenluijten](https://avatars.githubusercontent.com/u/11269635?v=4)](https://github.com/svenluijten "svenluijten (2 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/decahedron-laravel-app-events/health.svg)

```
[![Health](https://phpackages.com/badges/decahedron-laravel-app-events/health.svg)](https://phpackages.com/packages/decahedron-laravel-app-events)
```

###  Alternatives

[illuminate/queue

The Illuminate Queue package.

20331.4M1.2k](/packages/illuminate-queue)[qruto/laravel-flora

Install and update Laravel application with single command

13197.8k](/packages/qruto-laravel-flora)[flarum/core

Delightfully simple forum software.

211.3M1.9k](/packages/flarum-core)[prwnr/laravel-streamer

Events streaming package for Laravel that uses Redis 5 streams

110196.9k1](/packages/prwnr-laravel-streamer)[saeedvaziry/laravel-async

Run asynchronous code in Laravel without waiting for results

15310.0k](/packages/saeedvaziry-laravel-async)[palpalani/laravel-sqs-queue-json-reader

Custom SQS queue reader for Laravel

26109.8k](/packages/palpalani-laravel-sqs-queue-json-reader)

PHPackages © 2026

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