Awesome Open Source
Awesome Open Source

Wolnociowiec Notification

Deploy Docker Build Status MicroBadger Layers

API gateway for sending notifications, with queue support.


  • Ready to use application that sends notifications with just one REST call
  • Queue support (Redis or SQLite3)
  • Sync and async interfaces
  • Builtin Twitter and Facebook support
  • Easily extensible (Queue storage could be easily added and switched, also the senders could be easily added eg. support for mail sending)
  • Written in Symfony 3 should be understandable for most PHP programmers

How it works?

The application is taking as input ANY TYPE of message that implements the Message interface. Message interface is a definition of minimum required fields and a mark for a class that its an input message.

Messenger is a message sending implementation that is able to handle specific message types, and possibly the basic message type.

To create a custom message format you have to:

  1. Create a new class that implements MessageInterface or extends Message
  2. Register it in your notification.yml under allowed_entities section
  3. Make create a Messenger, in other words a MESSAGE HANDLER, A SENDER that implements MessengerInterface
  4. Register your Messenger in notification.yml under enabled_messengers section, add the configuration in messengers section

To retrieve a configuration in your Messenger you have to inject the MessengerConfigurationProvider service using the container


cp app/config/notification.yml.dist app/config/notification.yml
nano app/config/notification.yml
composer install --dev


Edit the configuration in app/config/notification.yml (if it does not exists then just create the file)

    queue: "notificationbundle.queue.redis"
        scheme: tcp
        host: localhost
        port: 6379

        Message: "NotificationBundle\\Model\\Entity\\Message"

            class: NotificationBundle\Messenger\TwitterMessenger
                - short_content_update_notification

            consumer_key: aaa
            consumer_secret: bbb
            access_token: ccc
            access_token_secret: ddd

            app_id: xxx
            app_secret: yyy


Example HTTP request:

POST /message/queue/add?message_type=Message

    "message":    "This will go on to Twitter",
    "group_name": "short_content_update_notification",
    "could_be_truncated": true
GET /message/queue/process


  1. Use wolnosciowiec/wolnosciowiec-notification image as your base image, extend it by adding a configuration file "notification.yml" to the app/config directory. The image is exposing 9000 and 80 port, the first is for PHP-FPM 7.x and the second from configured nginx.

  2. Configure rest of things with environment variables

See the list of env variables

You can attach a single redis instance as a storage, then scale notifications service with Docker Swarm or Kubernetes easily. Accessibility of nginx in a container gives ability to use service discovery such as Traefik.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Microservice (5,940
Php7 (4,470
Twitter (3,906
Slack (2,946
Notifications (2,674
Facebook (2,062
Messenger (791
Error Handling (632
Notifier (243
Error Monitoring (174
Notification Service (153
Related Projects