Use WPCLIHandler in a command

Use this guide when you already have a WP-CLI command and want to route logs through Monolog.

Steps

1. Install the package:

composer require mhcg/monolog-wp-cli

2. In your command callback, create a logger and attach the handler:

<?php

use Monolog\Level;
use Monolog\Logger;
use MHCG\Monolog\Handler\WPCLIHandler;

function mycommand_command( $args ) {
    $logger = new Logger( 'mycommand' );
    $logger->pushHandler( new WPCLIHandler( Level::Info ) );

    $logger->info( 'Starting' );
    $logger->warning( 'Potential issue detected' );
    $logger->error( 'Failed to process one item' );
}

WP_CLI::add_command( 'mycommand', 'mycommand_command' );

3. Optional: if you need pre-v2.2 NOTICE behaviour (warning output), pass a logger-map override:

$logger->pushHandler(
    new WPCLIHandler(
        Level::Info,
        true,
        false,
        [
            Level::Notice->value => [
                'method' => 'warning',
                'includeLevelName' => true,
            ],
        ]
    )
);

4. Optional: if you want Monolog context and extra data in output, enable verbose mode:

$logger->pushHandler( new WPCLIHandler( Level::Info, true, true ) );
$logger->notice( 'Processed batch', [ 'batch' => 12 ] );

You can also enable the same formatter behaviour through WP_DEBUG.

5. Run the command normally:

wp mycommand

6. Optional: run with debug visibility:

wp mycommand --debug

7. Optional: run in quiet mode:

wp mycommand --quiet

Notes

• The handler is intended for WP-CLI runtime. Constructing it outside WP-CLI raises a runtime exception.
• Use the Monolog Level enum for handler thresholds and logger-map keys on Monolog 3.
• debug messages rely on WP-CLI debug mode.
• Monolog context and extra data are only shown when the handler is in verbose mode, either via the constructor flag or WP_DEBUG.
• From v2.2, notice maps to WP_CLI::log() by default.
• Error-level output is sent through WP-CLI error handling.