HEX
Server: Apache
System: Linux p3plzcpnl476737.prod.phx3.secureserver.net 4.18.0-553.54.1.lve.el8.x86_64 #1 SMP Wed Jun 4 13:01:13 UTC 2025 x86_64
User: p8pyefaexf70 (9161224)
PHP: 7.4.33
Disabled: NONE
Upload Files
File: //proc/thread-self/cwd/wp-content/plugins/woocommerce-payments/includes/class-logger.php
<?php
/**
 * Class Logger
 *
 * @package WooCommerce\Payments
 */

namespace WCPay;

use Throwable;
use WCPay\Internal\Logger as InternalLogger;

defined( 'ABSPATH' ) || exit; // block direct access.

/**
 * A wrapper class for interacting with WC_Logger.
 */
class Logger {

	/**
	 * Add a log entry.
	 *
	 * Note that this depends on WC_Payments gateway property to be initialized as
	 * we need this to access the plugins debug setting to figure out if the setting
	 * is turned on.
	 *
	 * @param string               $message Log message.
	 *
	 * @param string               $level One of the following:
	 *                   'emergency': System is unusable.
	 *                   'alert': Action must be taken immediately.
	 *                   'critical': Critical conditions.
	 *                   'error': Error conditions.
	 *                   'warning': Warning conditions.
	 *                   'notice': Normal but significant condition.
	 *                   'info': Informational messages.
	 *                   'debug': Debug-level messages.
	 *  @param array<string, mixed> $context Context data.
	 */
	public static function log( $message, $level = 'info', $context = [] ) {
		wcpay_get_container()->get( InternalLogger::class )->log( $message, $level, $context );
	}

	/**
	 * Checks if the gateway setting logging toggle is enabled.
	 *
	 * @return bool Depending on the enable_logging setting.
	 */
	public static function can_log() {
		return wcpay_get_container()->get( InternalLogger::class )->can_log();
	}

	/**
	 * Creates a log entry of type emergency
	 *
	 * @param string               $message To send to the log file.
	 * @param array<string, mixed> $context Context data.
	 */
	public static function emergency( $message, $context = [] ) {
		self::log( $message, 'emergency', $context );
	}

	/**
	 * Creates a log entry of type alert
	 *
	 * @param string               $message To send to the log file.
	 * @param array<string, mixed> $context Context data.
	 */
	public static function alert( $message, $context = [] ) {
		self::log( $message, 'alert', $context );
	}

	/**
	 * Creates a log entry of type critical
	 *
	 * @param string               $message To send to the log file.
	 * @param array<string, mixed> $context Context data.
	 */
	public static function critical( $message, $context = [] ) {
		self::log( $message, 'critical', $context );
	}

	/**
	 * Creates a log entry of type error
	 *
	 * @param string               $message to send to the log file.
	 * @param array<string, mixed> $context context data.
	 */
	public static function error( $message, $context = [] ) {
		self::log( $message, 'error', $context );
	}

	/**
	 * Creates a log entry for exception
	 *
	 * @param string               $message Message to prepend to an exception.
	 * @param Throwable            $e       Exception to log.
	 * @param array<string, mixed> $context Context data.
	 */
	public static function exception( $message, $e, $context = [] ) {
		self::error(
			$message . ' Exception: ' . $e->getMessage(),
			array_merge(
				[
					'exception' => get_class( $e ),
					'code'      => $e->getCode(),
					'trace'     => $e->getTraceAsString(),
				],
				$context
			)
		);
	}

	/**
	 * Creates a log entry of type warning
	 *
	 * @param string               $message To send to the log file.
	 * @param array<string, mixed> $context Context data.
	 */
	public static function warning( $message, $context = [] ) {
		self::log( $message, 'warning', $context );
	}

	/**
	 * Creates a log entry of type notice
	 *
	 * @param string               $message To send to the log file.
	 * @param array<string, mixed> $context Context data.
	 */
	public static function notice( $message, $context = [] ) {
		self::log( $message, 'notice', $context );
	}

	/**
	 * Creates a log entry of type info
	 *
	 * @param string               $message To send to the log file.
	 * @param array<string, mixed> $context Context data.
	 */
	public static function info( $message, $context = [] ) {
		self::log( $message, 'info', $context );
	}

	/**
	 * Creates a log entry of type debug
	 *
	 * @param string               $message To send to the log file.
	 * @param array<string, mixed> $context Context data.
	 */
	public static function debug( $message, $context = [] ) {
		self::log( $message, 'debug', $context );
	}
}