erwane/whep-mailgun

Mailgun (Sinch) webhooks handler

2.2.0 2025-08-13 08:47 UTC

Requires

• php: ^8.1
• dflydev/dot-access-data: ^3.0
• erwane/whep-client: ^2.2

Requires (Dev)

• cakephp/cakephp-codesniffer: ^5.0
• erwane/phpunit-resource-helper: ^2.0
• phpunit/phpunit: ^10.5
• symfony/var-dumper: ^v6.0

MIT

• Erwane

• mailgun
• webhook
• sinch

README

Webhook handler for Mailgun (Sinch) emailing provider.

Usage

composer require erwane/whep-mailgun

use WHEP\Exception\SecurityException;  
use WHEP\Exception\WHEPException;  
use WHEP\Factory;  

try {
    $provider = Factory::provider('mailgun', [
        'signing_key' => 'my-private-signing-key',
        'callbacks' => [
            ProviderInterface::EVENT_BLOCKED => [$this, 'callbackInvalidate'],
            ProviderInterface::EVENT_BOUNCE_QUOTA => [$this, 'callbackUnsub'],
        ],
    ]);

    // process the data.
    $provider->process($webhookData);
    
    // Data available from provider getters.
    $recipient = $provider->getRecipient();
    
    // Launch callbacks
    $provider->callback();
} catch (SecurityException $e) {
    // log ?
} catch (WHEPException $e) {
    // log ?
}

See WHEP Client README for options, events and getters.