uno/event-sdk

Reusable Symfony Event SDK with Publisher, Subscriber, and Messenger integration

v1.0.0 2025-12-05 12:35 UTC

Requires

• php: >=7.4
• psr/log: ^1.1 || ^2.0 || ^3.0
• symfony/framework-bundle: ^4.4 || ^5.0 || ^6.0 || ^7.0
• symfony/http-client: ^4.4 || ^5.0 || ^6.0 || ^7.0
• symfony/messenger: ^4.4 || ^5.0 || ^6.0 || ^7.0

MIT

• symfony
• event
• sdk
• publisher
• subscriber
• Messenger

README

A reusable and lightweight Event SDK for Symfony applications that simplifies event publishing and event subscribing across microservices.

This SDK is built using Symfony Messenger, supports Redis transport, and provides a clean, unified structure for asynchronous communication.

Features

• Publish events with a standard EventMessage format
• Subscribe to events using Symfony Messenger workers
• Extendable subscriber system using a registry pattern
• Optional HTTP forwarding subscriber (e.g., send events to any service like Spring Boot)
• Automatic dependency injection configuration
• Compatible with Symfony 4.4 → 7.x
• Can be used via:
  • Local path
  • GitHub repository
  • Composer (Packagist)

Installation

1. Install via Composer (Packagist)

composer require uno/event-sdk

2. Install from GitHub (without Packagist)

composer require uno/event-sdk:dev-main

3. Use Locally (development mode)

In your main project composer.json:

{
  "repositories": [
    {
      "type": "path",
      "url": "../uno-event-sdk"
    }
  ]
}

Then:

composer require uno/event-sdk:* --dev

Configuration

Enable the bundle automatically (Flex) or in config/bundles.php:

return [
    Uno\EventSdk\UnoEventSdkBundle::class => ['all' => true],
];

Configure the messenger transport (Redis example):

framework:
  messenger:
    transports:
      async: "%env(MESSENGER_TRANSPORT_DSN)%"

Example DSN:

redis://localhost:6379/messages

Publishing an Event

$publisher->publish('user.registered', [
    'id' => 1,
    'email' => '[e-mail]'
]);

Subscribing to Events

Run worker:

php bin/console messenger:consume async -vv

Project Structure

src/
├── Contract/
├── Publisher/
├── Subscriber/
├── Message/
├── Exception/
├── EventListener/
├── DependencyInjection/
├── Resources/config/services.yaml
└── UnoEventSdkBundle.php