stechstudio / email-event-parser
Parses event data from a variety of email service providers
Requires
- illuminate/support: 5.*
Requires (Dev)
- phpunit/phpunit: ^5.5
This package is auto-updated.
Last update: 2024-11-12 04:32:09 UTC
README
Easily parse event data from a variety of email service providers. Currently supports SendGrid and Mailgun webhook formats.
Installation
composer require stechstudio/email-event-parser
Basic usage
When you know where the event is coming from, you can create the adapter yourself:
$event = new \STS\EmailEventParser\EmailEvent(
new \STS\EmailEventParser\Adapters\MailgunWebhook($payload)
);
The adapter $payload
should be an array of event data. It's up to you to json_decode
this if needed. In some cases it might be appropriate to just pass in $_POST
as the payload.
Automatic service detection
If you are expecting webhooks from multiple service providers, you can use the automatic detection:
$event = \STS\EmailEventParser\EmailEvent::detect($payload);
This will examine the event data and figure out which service sent the event, and which adapter to use.
API
Once you have an event object, here is a list of methods that are available: