PHPackages                             edgetelemetrics/eventcorrelation - 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 &amp; Helpers](/categories/utility)
4. /
5. edgetelemetrics/eventcorrelation

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

edgetelemetrics/eventcorrelation
================================

Event Stream correlation engine for PHP

v0.14.0(1w ago)34.8k2MITPHPPHP ^8.1CI failing

Since Apr 7Pushed 1w ago1 watchersCompare

[ Source](https://github.com/lucasnetau/php-ec)[ Packagist](https://packagist.org/packages/edgetelemetrics/eventcorrelation)[ RSS](/packages/edgetelemetrics-eventcorrelation/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (10)Dependencies (67)Versions (68)Used By (0)

PHP Event Correlator (Event Sourcing)
=====================================

[](#php-event-correlator-event-sourcing)

[![FOSSA Status](https://camo.githubusercontent.com/a4f7bfde3f8dbb8725681ea01f46f02e9f3a23a274550055e89962dac1ecd000/68747470733a2f2f6170702e666f7373612e696f2f6170692f70726f6a656374732f6769742532426769746875622e636f6d2532466c756361736e657461752532467068702d65632e7376673f747970653d736869656c64)](https://app.fossa.io/projects/git%2Bgithub.com%2Flucasnetau%2Fphp-ec?ref=badge_shield) [![GitHub](https://camo.githubusercontent.com/fc2938d0127997715dc9986fc4073224f0fadb2cdd46b6a0cc54806fa629b794/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6c756361736e657461752f7068702d6563)](https://camo.githubusercontent.com/fc2938d0127997715dc9986fc4073224f0fadb2cdd46b6a0cc54806fa629b794/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6c756361736e657461752f7068702d6563)

PHP Event Correlator is an event correlation tool to process a stream of events, make decisions based on Rules sets, and perform actions based on these Rules.

Event correlation is useful in many areas. For example, log processing, microservice coordination, IoT event processing.

PHP-EC is being used in production for multiple IoT projects, some processing 10M+ events per day from multiple disparate systems.

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

[](#requirements)

The package is compatible with PHP 8.0+

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

[](#installation)

You can add the library as project dependency using [Composer](https://getcomposer.org/):

```
composer require edgetelemetrics/eventcorrelation
```

Performance can be improved by installing optional PHP extensions (ext-libuv or ext-libev)

Examples
--------

[](#examples)

See [/examples](/examples) directory

- [Online shopping service](/examples/online_shop/online_shop.php)

Getting Started
---------------

[](#getting-started)

TBC.

Components are:

- Events: An event is made up of a type, date, id, and data
- Event Stream: A time ordered stream of events
- Input Processes: programs that provide event streams into PHP-EC. These can be PHP scripts, NodeJS, Bash script etc.
- Actions: Programs that perform tasks when requested. This may be writing to a database, sending an email etc.
- Rules: Rules define a set of events to be processed within a defined time period. Once a Rule is matched or a defined timeout period is exceeded the rule can:

    - run Actions (for example send email, write to database)
    - emit Events (emit a new or modified event for another Rule to handle \[chaining rules\])
    - run an additional input process (load more data into the system)

### Cron Like Rules

[](#cron-like-rules)

PHP-EC supports rules that can call actions based on Cron time expressions, system start and system shutdown.

License
-------

[](#license)

MIT, see [LICENSE file](LICENSE).

[![FOSSA Status](https://camo.githubusercontent.com/407c6789ef062d7151eb7d90d7fce82a79706daa84574462b233365a7c1ceeee/68747470733a2f2f6170702e666f7373612e696f2f6170692f70726f6a656374732f6769742532426769746875622e636f6d2532466c756361736e657461752532467068702d65632e7376673f747970653d6c61726765)](https://app.fossa.io/projects/git%2Bgithub.com%2Flucasnetau%2Fphp-ec?ref=badge_large)

### Contributing

[](#contributing)

Bug reports (and small patches) can be submitted via the [issue tracker](https://github.com/lucasnetau/php-ec/issues). Forking the repository and submitting a Pull Request is preferred for substantial patches.

###  Health Score

55

—

FairBetter than 97% of packages

Maintenance98

Actively maintained with recent releases

Popularity25

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 99.8% 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 ~34 days

Total

67

Last Release

13d ago

PHP version history (5 changes)0.1.0PHP &gt;=7.2

v0.2.0PHP ^7.4

v0.2.6PHP ^7.4||^8.0

v0.5.3PHP ^8.0

v0.8.0PHP ^8.1

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/9331242?v=4)[James Lucas](/maintainers/lucasnetau)[@lucasnetau](https://github.com/lucasnetau)

---

Top Contributors

[![lucasnetau](https://avatars.githubusercontent.com/u/9331242?v=4)](https://github.com/lucasnetau "lucasnetau (432 commits)")[![fossabot](https://avatars.githubusercontent.com/u/29791463?v=4)](https://github.com/fossabot "fossabot (1 commits)")

---

Tags

correlationevent-sourcingevent-streamingeventstreamstreameventphp-ec

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Psalm

Type Coverage Yes

### Embed Badge

![Health badge](/badges/edgetelemetrics-eventcorrelation/health.svg)

```
[![Health](https://phpackages.com/badges/edgetelemetrics-eventcorrelation/health.svg)](https://phpackages.com/packages/edgetelemetrics-eventcorrelation)
```

###  Alternatives

[composer/composer

Composer helps you declare, manage and install dependencies of PHP projects. It ensures you have the right stack everywhere.

29.5k196.2M3.1k](/packages/composer-composer)[friendsofphp/php-cs-fixer

A tool to automatically fix PHP code style

13.5k251.2M25.3k](/packages/friendsofphp-php-cs-fixer)[symfony/symfony

The Symfony PHP framework

31.4k87.2M2.2k](/packages/symfony-symfony)[ccxt/ccxt

A cryptocurrency trading API with more than 100 exchanges in JavaScript / TypeScript / Python / C# / PHP / Go

43.2k341.0k1](/packages/ccxt-ccxt)[ecotone/ecotone

Enterprise architecture layer for Laravel and Symfony — CQRS, Event Sourcing, Durable Workflows (Sagas, Orchestrators), Projections, and Outbox messaging via PHP attributes.

564576.7k53](/packages/ecotone-ecotone)[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k15](/packages/tempest-framework)

PHPackages © 2026

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