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.

For more info about what can be retrieved from Mailgun please visit the Mailgun API Reference

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.

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.

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
	]);
});

The Mailgun Events package is open-sourced software licensed under the MIT license.