Debug Logger

As PHP moves forward, so must WordPress. This plugin helps WordPress use the tools of modern PHP. Monolog — PHP's most popular logging package — is a composer package. Since WordPress doesn't currently have a universal way to support composer, this WordPress plugin is meant to start bridging the gap. This logger is PSR-3 compliant, a PHP standard which Monolog also uses.

This section describes how to install the plugin and get it working.

1. Upload the wp-debug-logger folder to the /wp-content/plugins/ directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Enable debugging in your wp-config.php

` // in your wp-config.php define( 'WP_DEBUG', true ); define( 'WP_DEBUG_DISPLAY', false ); define( 'WP_DEBUG_LOG', true ); define( 'WP_DEBUG_MINIMUM_LEVEL', 'debug' ); // For good measure, this will hide errors from being displayed on-screen @ini_set('display_errors', 0); `

1. As you write your code, sprinkle in these Log methods.

Minimum Level WP_DEBUG_MINIMUM_LEVEL is a new constant that determines the minimum severity level you wish to write to your wp-content/debug.log file. In your development environment, I recommend using debug so you can see all the errors being written. For your production environment, I'd recommend the error level, so you can capture all the significant problems. Here are the values to use: emergency, alert, critical, error, warning, notice, info, debug. Note: they're all lowercase, as the value is case-sensitive. Displaying Errors In your development environment, you may choose to set WP_DEBUG_DISPLAY to true, so the error messages show in your browser. However, I strongly recommend that you do not change it, for your production environment. These settings can be placed anywhere above the line. /* That’s all, stop editing! Happy blogging. */

0.3.0

• Add the ability to log WP_Error objects
• Add Log::wp_error() and its corresponding Logger->log_wp_error method
• Add method Logger->has_level() to ensure a level exists

0.2.0

• Add Log::print() and Log::dump() methods
• Improve documentation

0.1.0

• Import PSR-3 from PHP FIG into lib directory
• Create Logger class to write log
• Create Log class to statically interact with Logger class
• Add usage instructions and logging levels