ttskch/monolog-mailgun

Monolog handler for Mailgun

1.0.5 2020-04-16 08:05 UTC

Requires

• php: ^7.2
• guzzlehttp/psr7: ^1.4
• mailgun/mailgun-php: ^2.4
• monolog/monolog: ^2.0
• php-http/curl-client: ^1.7

Requires (Dev)

• phpunit/phpunit: ^6.0 || ^7.0 || ^8.0

MIT

• Takashi Kanemoto

• monolog
• mailgun

README

Monolog handler for Mailgun using mailgun/mailgun-php.

Requirements

• php:^7.2
• monolog/monolog:^2.0

Installation

$ composer require ttskch/monolog-mailgun

Usage

$mg = \Mailgun\Mailgun::create('api_key');
$domain = 'mg.example.com';
$from = 'Alice <[e-mail]>';
$to = ['[e-mail]'];
$subject = '[Monolog] Error Report';

$handler = new \Ttskch\Monolog\Handler\MailgunHandler($mg, $domain, $from, $to, $subject);
$logger = new \Monolog\Logger('mailgun');
$logger->pushHandler($handler);
$logger->critical('Critical Error!');

Examples of framework integrations

Symfony4/5

# config/packages/mailgun.yaml
services:
    Mailgun\Mailgun:
        class: Mailgun\Mailgun
        factory: ['Mailgun\Mailgun', create]
        arguments: ['%env(MAILGUN_API_KEY)%']

# config/packages/prod/monolog.yaml
monolog:
    handlers:

        # ...

        email:
            type: fingers_crossed
            action_level: critical
            level: debug
            channels: ["!event"]
            handler: deduplicated
        deduplicated:
            type: deduplication # prevent multiply sending
            handler: mailgun
        mailgun:
            type: service
            id: Ttskch\Monolog\Handler\MailgunHandler

services:
    Ttskch\Monolog\Handler\MailgunHandler:
        arguments:
            - '@Mailgun\Mailgun'
            - mg.example.com # mailgun domain
            - Alice <[e-mail]> # from
            - [[e-mail]] # to
            - '[Monolog] Error Report' # subject

# .env
MAILGUN_API_KEY=api_key

Other

Feel free to send me a PR🙏