Gravity PDF API – get_log_class()

Description

Gravity PDF implements the PSR-3 logging library, Monolog, to handle all it's logging requirements. When in production the logger doesn't save any logs unless it's enabled through Gravity Forms in-built logging setting, or when using the Gravity Forms Logging Add-on. Once you've enabled logging, we'll save the appropriate logs to disk for later review – errors and higher or notices and higher, depending on the log setting you selected.

When using the logging class all logs will automatically include the following details:

• Function/method being called
• Class called from (if applicable)
• URL
• Peak memory usage
• File and line number called from
• User IP
• Timestamp

Version

This method was introduced in Gravity PDF 4.0.

Return

\Monolog\Logger | object

• The logging class

Usage

The following snippet shows you how to use this method and write to our log file:

add_action( 'init', function() {
    if ( class_exists( 'GPDFAPI' ) ) {
        /* Get Gravity PDF logging class */
        $logs = GPDFAPI::get_log_class();

        /* Write logs to file */
        $logs->addNotice( 'My plugin started operation X' );
        $logs->addWarning( 'Nonce Check Failed' );
        $logs->addError( 'Invalid ID number' );
        $logs->addCritical( 'Security issue: lack of User Capabilities' );
        $logs->addAlert( 'Plugin compatibility issue' );
        $logs->addEmergency( 'Plugin exploded' );

        /* You can also pass additional properties to the log by included a second argument as an array */
        $logs->addError( 'Invalid ID number', array(
            'form_id' => '5', /* This would usually be a variable */
        ) );
    }
} );

Source Code

This method is located in api.php.