Repository navigation
v1.0.0 – Initial Release
Maatify Email Delivery v1.0.0
Initial public release of the Maatify Email Delivery library.
This package provides a framework-agnostic asynchronous email delivery pipeline for PHP applications.
✨ Features
- Async transactional email queue
- Twig-based email rendering
- SMTP transport via PHPMailer
- Background worker processing
- Encrypted queue payloads using
maatify/crypto - Retry mechanism with backoff strategies
- Batch processing support
- Scheduled email delivery
- Framework-agnostic architecture
🧱 Architecture
The email pipeline is built around four core components:
-
Queue Writer
Encrypts and stores email jobs in the database queue. -
Renderer
Renders Twig email templates with payload data. -
Worker
Processes queued jobs, handles retries, and manages delivery lifecycle. -
SMTP Transport
Sends emails using PHPMailer.
🔐 Security
Sensitive data stored in the queue is encrypted using the maatify/crypto library:
- recipient email encryption
- payload encryption
- key rotation support
This ensures queue data remains protected even if the database is compromised.
🧪 Testing
The library includes a full PHPUnit test suite:
- Unit tests for DTOs, renderer, and queue writer
- Integration tests for the worker pipeline
- Retry mechanism validation
- Encryption round-trip validation
- SQLite in-memory test database
23 tests, 132 assertions
All tests pass through the CI pipeline.
📚 Documentation
Full documentation is available in the repository:
- Book documentation →
docs/book - Guides →
docs/how-to - Examples →
docs/examples
📦 Installation
composer require maatify/email-delivery🧩 Part of the Maatify Ecosystem
This package integrates with:
maatify/crypto
License
MIT License