programster/email-logger

A logger that logs via email and is compatible with PSR-3

1.0.0 2023-04-25 16:37 UTC

Requires

• php: >=8.1.0
• programster/emailers: ^3.0
• programster/log: ^2.0
• psr/log: ^3.0

MIT

• Stuart Page

• log
• logging
• email

README

A PSR-3 logger for PHP that sends logs via email.

Installation

composer require programster/email-logger

Example Usage

# Create an emailer, in this case using PHPMailer.
# Any emailer that implements the EmailerInterface will work
$emailer = new Programster\Emailers\PhpMailerEmailer(
    "smtp.gmail.com",
    "[e-mail]",
    "app-specific-password-goes-here",
    SecurityProtocol::TLS,
    "[e-mail]",
    "Senders Name",
    587,
    "[e-mail]",
    "noreply"
);

# Create the email logger
$logger = new EmailLogger(
    $emailer,
    "my-service-name-here",
    new EmailSubscriber("Jenn", "[e-mail]"),
    new EmailSubscriber("Roy", "[e-mail]"),
);

# Create some useful context for the log that might help debugging/resolving what went wrong...
$context = [
    'some' => 'details'
];

# Send the log (email)
$logger->critical("There was a critical error!", $context);

Testing

When developing this package, please be sure to test, even if it's very basic. For now, one can test by removing the .example extension from the settings.php.example file, and filling it in. Then execute the main.php script to send emails to the subscribers specified in your settings.