Current File : /home/q/g/b/qgbqkvz/www/wp-content/plugins/wp-optimize/vendor/simplehtmldom/simplehtmldom/Debug.php
<?php namespace simplehtmldom;
/**
* Implements functions for debugging purposes. Debugging can be enabled and
* disabled on demand. Debug messages are send to error_log by default but it
* is also possible to register a custom debug handler.
*/
class Debug {
private static $enabled = false;
private static $debugHandler = null;
private static $callerLock = array();
/**
* Checks whether debug mode is enabled.
*
* @return bool True if debug mode is enabled, false otherwise.
*/
public static function isEnabled()
{
return self::$enabled;
}
/**
* Enables debug mode
*/
public static function enable()
{
self::$enabled = true;
self::log('Debug mode has been enabled');
}
/**
* Disables debug mode
*/
public static function disable()
{
self::log('Debug mode has been disabled');
self::$enabled = false;
}
/**
* Sets the debug handler.
*
* `null`: error_log (default)
*/
public static function setDebugHandler($function = null)
{
if ($function === self::$debugHandler) return;
self::log('New debug handler registered');
self::$debugHandler = $function;
}
/**
* This is the actual log function. It allows to set a custom backtrace to
* eliminate traces of this class.
*/
private static function log_trace($message, $backtrace)
{
$idx = 0;
$debugmessage = '';
foreach($backtrace as $caller)
{
if (!isset($caller['file']) && !isset($caller['line'])) {
break; // Unknown caller
}
$debugmessage .= ' [' . $caller['file'] . ':' . $caller['line'];
if ($idx > 1) { // Do not include the call to Debug::log
$debugmessage .= ' '
. $caller['class']
. $caller['type']
. $caller['function']
. '()';
}
$debugmessage .= ']';
// Stop at the first caller that isn't part of simplehtmldom
if (!isset($caller['class']) || strpos($caller['class'], 'simplehtmldom\\') !== 0) {
break;
}
}
$output = '[DEBUG] ' . trim($debugmessage) . ' "' . $message . '"';
if (is_null(self::$debugHandler)) {
error_log($output);
} else {
call_user_func_array(self::$debugHandler, array($output));
}
}
/**
* Adds a debug message to error_log if debug mode is enabled. Does nothing
* if debug mode is disabled.
*
* @param string $text The message to add to error_log
*/
public static function log($message)
{
if (!self::isEnabled()) return;
$backtrace = debug_backtrace(DEBUG_BACKTRACE_PROVIDE_OBJECT);
self::log_trace($message, $backtrace);
}
/**
* Adds a debug message to error_log if debug mode is enabled. Does nothing
* if debug mode is disabled. Each message is logged only once.
*
* @param string $text The message to add to error_log
*/
public static function log_once($message)
{
if (!self::isEnabled()) return;
// Keep track of caller (file & line)
$backtrace = debug_backtrace(DEBUG_BACKTRACE_PROVIDE_OBJECT);
if (in_array($backtrace[0], self::$callerLock, true)) return;
self::$callerLock[] = $backtrace[0];
self::log_trace($message, $backtrace);
}
}
Mini Shell