Formatters are responsible for converting a Log_Entry object into a string representation before it’s written by a handler. Each handler has a sensible default formatter, but you can customize the output by creating your own formatter instance and passing it to a handler.
You can set a formatter in two ways:
use WPTechnix\WP_Simple_Logger\Handlers\File_Handler;
use WPTechnix\WP_Simple_Logger\Formatters\Json_Formatter;
$formatter = new Json_Formatter();
$handler = new File_Handler( $path, 'debug', 0, $formatter );
set_formatter() Method:
use WPTechnix\WP_Simple_Logger\Handlers\File_Handler;
use WPTechnix\WP_Simple_Logger\Formatters\Json_Formatter;
$handler = new File_Handler( $path );
$handler->set_formatter( new Json_Formatter() );
Formats a log record into a single, customizable line of text. This is the default formatter for the File_Handler.
new Line_Formatter(?string $format = null, bool $ignore_empty_context = true)
$format (?string): A format string with placeholders. If null, it defaults to: [%timestamp%] %channel%.%level_name%: %message% %context%$ignore_empty_context (bool): If true, the %context% placeholder (and any preceding space) is removed if the context array is empty.%timestamp%: The formatted date and time of the log (e.g., 2023-10-27 15:30:00).%channel%: The channel name (e.g., payments).%level_name%: The uppercase log level name (e.g., INFO, ERROR).%message%: The log message itself.%context%: The context data, rendered as a JSON string.use WPTechnix\WP_Simple_Logger\Formatters\Line_Formatter;
// Create a custom TSV (Tab-Separated Values) format
$format = "%timestamp%\t%level_name%\t%channel%\t%message%\t%context%\n";
$tsv_formatter = new Line_Formatter($format);
$file_handler->set_formatter($tsv_formatter);
[2023-10-27 15:30:00] payments.INFO: Transaction successful. {"transaction_id":"txn_123"}
Serializes the entire log record into a JSON string, with each log on a new line. This is ideal for sending logs to external services like Elasticsearch or Datadog.
new Json_Formatter(?array $keys_to_include = null)
$keys_to_include (?array): An array of keys to include in the final JSON output. If null, it defaults to ['datetime', 'channel', 'level', 'levelName', 'message', 'context'].id: The database ID (only available when reading from DB).datetime: The full UTC datetime string (Y-m-d H:i:s).timestamp: The Unix timestamp.channel: The channel name.level: The integer priority of the log level.levelName: The string name of the log level (e.g., info).message: The log message.context: The context data object/array.use WPTechnix\WP_Simple_Logger\Formatters\Json_Formatter;
// Create a formatter that only includes a specific set of keys
$json_formatter = new Json_Formatter(
keys_to_include: ['timestamp', 'levelName', 'message', 'context']
);
$file_handler->set_formatter($json_formatter);
{"timestamp":1698409800,"levelName":"info","message":"Transaction successful.","context":{"transaction_id":"txn_123"}}
Formats a log record into a styled HTML table row. This is designed for human readability and is the default formatter for the Email_Handler.
new Html_Formatter()
This formatter has no constructor arguments.
This formatter is primarily used internally by the Email_Handler, but you could use it with a File_Handler to create an HTML log file.
use WPTechnix\WP_Simple_Logger\Formatters\Html_Formatter;
$html_formatter = new Html_Formatter();
$file_handler->set_formatter($html_formatter);
// The resulting file would be a full HTML document of log entries.
The Html_Formatter produces a block of HTML that is styled for readability in an email client. See the screenshot in the Handlers Guide for a visual example.