sitecrafting / monolog-masking-formatter

1.0.1 2026-07-01 16:57 UTC

Requires

• monolog/monolog: ^2.0.0

MIT

• Coby Tamayo

Published on Packagist.org on 2026-07-01 16:57 UTC

README

Library for masking sensitive info in Monolog.

Currently only LineFormatter (the Monolog default) and Logstash formats are supported.

Usage

<?php

use Monolog\Handler\RotatingFileHandler;
use MaskingFormatter\LogstashFormatter as MaskingLogstashFormatter;

// configure a formatter
$formatter = new MaskingLogstashFormatter('my-app');
$formatter->maskFields(['sensitive', 'context', 'keys']);
$formatter->setMask('********');

// instantiate a handler and add our formatter
$handler = new RotatingFileHandler('./log/app.log', 7, Logger::DEBUG);
$handler->setFormatter($formatter);

// create a logger and push the handler per usual...

Installation

The best way is to install via composer:

{
  "require": {
    "sitecrafting/monolog-masking-formatter": "dev-master"
  }
}

Then just run composer install or composer udpate per usual.

TODO

• Other formats
• Tests

License

MIT