adrianhl / mailgun-events
Mailgun Events
Requires
- php: >=5.5.9
- illuminate/console: ~5.1
- illuminate/database: ~5.1
- illuminate/support: ~5.1
- mailgun/mailgun-php: 2.1.*
- nesbot/carbon: ^1.21
- php-http/message: ^1.3
This package is auto-updated.
Last update: 2024-04-06 13:49:20 UTC
README
Mailgun API does not offer a persistent storage of the statistics and reporting data. This package offers a layer to retrieve and store the data in a persistent layer (database) for its later access.
Mailgun API
For more info about what can be retrieved from Mailgun please visit the Mailgun API Reference
Installation
Install the package via composer
composer require adrianhl/mailgun-events
Register the ServiceProvider and (optionally) the Facade
// config/app.php 'providers' => [ ... MailgunEvents\MailgunEventsServiceProvider::class ]; ... 'aliases' => [ ... 'MailgunEvents' => MailgunEvents\Facades\MailgunEvents::class ],
Next, publish the config file with the following artisan
command.
php artisan vendor:publish --provider="MailgunEvents\MailgunEventsServiceProvider"
After publishing, configure the package in config/mailgun_events/config.php
.
HTTP Client Dependency
To remove the dependency for a specific HTTP client library (e.g. Guzzle) the mailgun-php library has a dependency on the virtual package php-http/client-implementation which allows you to install any supported client adapter, it does not care which one. Please refer to the documentation for more information.
This gives you the freedom to use any (supported) client for communicating with the Mailgun API.
To register your driver you must register it in the Service Container with the mailgun.client
key.
The registration must occur before the MailgunServiceProvider
is being registered.
Guzzle 6 example implementation
Install the dependencies:
$ composer require php-http/guzzle6-adapter
Add the following to your AppServiceProvider
register()
method.
$this->app->bind('mailgun.client', function() { return \Http\Adapter\Guzzle6\Client::createWithConfig([ // your Guzzle6 configuration ]); });
License
The Mailgun Events package is open-sourced software licensed under the MIT license.