nextcloud / lognormalizer
Parses variables and converts them to string so that they can be logged
Installs: 3 857
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 2
Forks: 3
Open Issues: 0
Requires
- php: >=7.2.0
- ext-json: *
Requires (Dev)
- phpunit/phpunit: 8.*
This package is not auto-updated.
Last update: 2024-11-01 04:02:17 UTC
README
Parses variables and converts them to string so that they can be logged
Based on the Monolog formatter/normalizer.
How to use
Initialisation in your class
use Nextcloud\LogNormalizer\Normalizer; $normalizer = new Normalizer();
The constructor supports the following optional arguments
int $maxRecursionDepth
: The maximum depth at which you want to go in objects and arraysint $maxArrayItems
: The maximum number of elements you want to show, when parsing an array or an objectstring $dateFormat
: The format to apply to dates
Format variables before logging them
This is what your logging function could look like
/** * Converts the variables in the received log message to string before * sending everything to the real logger * * @param string $level * @param string $message * @param array $variables * * @return mixed */ public function log($level, $message, array $variables= []) { array_walk($variables, [$this->normalizer, 'format']); // Then use your current PSR-3 compatible logging system $this->logger->log($level, $message, $variables); }
And you would call it like this from another class
$myLogger->log('debug', 'Logger test {var1}, {var2}', [ 'var1' => $var1, 'var2' => $var2 ] );
Convert a single variable to a string
$normalizedVariable = $this->normalizer->format($variable);