Download the PHP package maatify/channel-delivery without Composer

Maatify Channel Delivery

Overview

Maatify Channel Delivery is a standalone async multi-channel delivery microservice for sending notifications across channels like Email, Telegram, SMS, and Push.

It offloads delivery processing from your core applications, ensuring:

• High availability
• Background delivery processing
• Retry mechanisms
• Secure payload encryption
• Controlled API ingestion

Currently, the Email channel is fully implemented and production-ready. Additional channels such as SMS, Telegram, and Push notifications are planned for future releases.

Features

• Async Multi-Channel Queue Process notifications asynchronously using background workers.

• Encrypted Payloads Built-in AES-256-GCM encryption for recipients and message contexts via maatify/crypto.

• Template Rendering Uses Twig to render dynamic email templates safely.

• Reply-To Support Optional reply_to field for admin notification emails — email goes to the admin, replies go to the customer.

• Robust Delivery Exponential retry strategy for transient delivery failures.

• API Key & IP Whitelisting Secure ingestion endpoints allowing only trusted origin servers.

• Rate Limiting Redis-backed sliding window rate limiter to prevent abuse.

• Containerized Dependency Injection Built on Slim 4 + PHP-DI for modular and testable architecture.

Architecture

The system operates as an API ingestion layer combined with background workers.

Applications enqueue notification jobs via HTTP. Workers then process the queue and deliver messages asynchronously.

The email delivery pipeline is powered internally by the maatify/email-delivery library, which provides the rendering, transport abstraction, and delivery engine.

Email Delivery Pipeline

Detailed processing steps:

1. Enqueue Client calls /api/v1/email/enqueue.

2. Encryption EnqueueEmailHandler encrypts recipient and context via Maatify\Crypto.

3. Persistence Job stored securely in cd_email_queue.

4. Worker Polling EmailQueueWorker polls pending jobs.

5. Template Rendering Context is decrypted and injected into Twig templates.

6. SMTP Delivery Email is sent via SmtpEmailTransport. If replyTo was set, a Reply-To header is added so replies go to the specified address.

Requirements

• PHP 8.2+
• MySQL / MariaDB
• Redis
• SMTP server
• Composer

Related Projects

• maatify/email-delivery – email delivery engine
• maatify/crypto – encryption layer

Installation

Clone the repository or install via Composer:

Install dependencies:

Configuration

Create the environment configuration file:

Edit .env and configure the following variables.

Application

Database

Example:

Encryption (Crypto)

Queue payloads and sensitive data are encrypted using AES-256-GCM through maatify/crypto.

Example:

Key requirements:

• Key must be exactly 32 bytes
• Keys support rotation
• Old keys remain for decryption only

Generate a secure 32-byte key:

This will generate a 32-character string, for example:

Then place it inside the .env configuration:

Key requirements:

• Must be exactly 32 characters
• Used as the symmetric encryption key for AES-256-GCM
• Keys support rotation

SMTP

SMTP configuration used by the email delivery worker.

Redis

Redis is used for rate limiting.

Example:

Quick Examples

Customer-facing email

Enqueue a transactional email (e.g., welcome, OTP, verification) sent to the customer:

Admin notification with Reply-To (v1.1.0+)

Enqueue an admin notification where the email goes to the admin, and replies go to the customer:

Worker Usage

Run the email worker:

This worker should normally run under a process manager like Supervisor or systemd.

See the worker setup guide:

Run Worker Guide

Documentation

• Run Worker Guide
• Send Email Guide
• API Documentation: Email Enqueue
• Basic Usage Example

License

This project is open-sourced software licensed under the MIT License.

See the LICENSE file for details.