public static function decorateTrace($traceData)
{
$output = '';
foreach ($traceData as $i => $step) {
$output .= $i + 1 . ': ';
if (isset($step['file'])) {
$output .= self::_buildCalleeString($step);
} else {
$output .= 'PHP internal call';
}
$output .= ' ' . $step['function'];
if (isset($step['args'])) {
$output .= '(' . implode(', ', array_keys($step['args'])) . ')';
}
$output .= "\n";
if (!empty($step['object'])) {
$calleeDump = kintParser::factory($step['object']);
$output .= "## Callee object ##\n";
$output .= self::decorate($calleeDump, 1);
}
if (!empty($step['args'])) {
$output .= "## Arguments ##\n";
foreach ($step['args'] as $k => $arg) {
kintParser::reset();
$output .= self::decorate(kintParser::factory($arg, $k), 1);
}
}
}
return $output;
}
protected static function _dump($var, $name = '')
{
kintParser::reset();
return Kint_Decorators_Rich::decorate(kintParser::factory($var, $name));
}
public static function dump($data = null)
{
if (!self::enabled()) {
return '';
}
list($names, $modifiers, $callee, $previousCaller, $miniTrace) = self::_getCalleeInfo(defined('DEBUG_BACKTRACE_IGNORE_ARGS') ? debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS) : debug_backtrace());
$modeOldValue = self::enabled();
$firstRunOldValue = self::$_firstRun;
# process modifiers: @, +, !, ~ and -
if (strpos($modifiers, '-') !== false) {
self::$_firstRun = true;
while (ob_get_level()) {
ob_end_clean();
}
}
if (strpos($modifiers, '!') !== false) {
$expandedByDefaultOldValue = self::$expandedByDefault;
self::$expandedByDefault = true;
}
if (strpos($modifiers, '+') !== false) {
$maxLevelsOldValue = self::$maxLevels;
self::$maxLevels = false;
}
if (strpos($modifiers, '@') !== false) {
$returnOldValue = self::$returnOutput;
self::$returnOutput = true;
self::$_firstRun = true;
}
if (strpos($modifiers, '~') !== false) {
self::enabled(self::MODE_WHITESPACE);
}
# set mode for current run
$mode = self::enabled();
if ($mode === true) {
$mode = PHP_SAPI === 'cli' ? self::MODE_CLI : self::MODE_RICH;
}
self::enabled($mode);
$decorator = self::enabled() === self::MODE_RICH ? 'Kint_Decorators_Rich' : 'Kint_Decorators_Plain';
$output = '';
if (self::$_firstRun) {
$output .= call_user_func(array($decorator, 'init'));
}
$trace = false;
if ($names === array(null) && func_num_args() === 1 && $data === 1) {
# Kint::dump(1) shorthand
$trace = KINT_PHP53 ? debug_backtrace(true) : debug_backtrace();
} elseif (func_num_args() === 1 && is_array($data)) {
$trace = $data;
# test if the single parameter is result of debug_backtrace()
}
$trace and $trace = self::_parseTrace($trace);
$output .= call_user_func(array($decorator, 'wrapStart'));
if ($trace) {
$output .= call_user_func(array($decorator, 'decorateTrace'), $trace);
} else {
$data = func_num_args() === 0 ? array("[[no arguments passed]]") : func_get_args();
foreach ($data as $k => $argument) {
kintParser::reset();
# when the dump arguments take long to generate output, user might have changed the file and
# Kint might not parse the arguments correctly, so check if names are set and while the
# displayed names might be wrong, at least don't throw an error
$output .= call_user_func(array($decorator, 'decorate'), kintParser::factory($argument, isset($names[$k]) ? $names[$k] : ''));
}
}
$output .= call_user_func(array($decorator, 'wrapEnd'), $callee, $miniTrace, $previousCaller);
self::enabled($modeOldValue);
self::$_firstRun = false;
if (strpos($modifiers, '~') !== false) {
self::$_firstRun = $firstRunOldValue;
} else {
self::enabled($modeOldValue);
}
if (strpos($modifiers, '!') !== false) {
self::$expandedByDefault = $expandedByDefaultOldValue;
}
if (strpos($modifiers, '+') !== false) {
self::$maxLevels = $maxLevelsOldValue;
}
if (strpos($modifiers, '@') !== false) {
self::$returnOutput = $returnOldValue;
self::$_firstRun = $firstRunOldValue;
return $output;
}
if (self::$returnOutput) {
return $output;
}
echo $output;
}
public static function decorateTrace($traceData)
{
$output = '<dl class="kint-trace">';
foreach ($traceData as $i => $step) {
$class = 'kint-parent';
if (Kint::$expandedByDefault) {
$class .= ' kint-show';
}
$output .= '<dt class="' . $class . '">' . '<b>' . ($i + 1) . '</b> ' . '<nav></nav>' . '<var>';
if (isset($step['file'])) {
$output .= self::_ideLink($step['file'], $step['line']);
} else {
$output .= 'PHP internal call';
}
$output .= '</var>';
$output .= $step['function'];
if (isset($step['args'])) {
$output .= '(' . implode(', ', array_keys($step['args'])) . ')';
}
$output .= '</dt><dd>';
$firstTab = ' class="kint-active-tab"';
$output .= '<ul class="kint-tabs">';
if (!empty($step['source'])) {
$output .= "<li{$firstTab}>Source</li>";
$firstTab = '';
}
if (!empty($step['args'])) {
$output .= "<li{$firstTab}>Arguments</li>";
$firstTab = '';
}
if (!empty($step['object'])) {
kintParser::reset();
$calleeDump = kintParser::factory($step['object']);
$output .= "<li{$firstTab}>Callee object [{$calleeDump->type}]</li>";
}
$output .= '</ul><ul>';
if (!empty($step['source'])) {
$output .= "<li><pre class=\"kint-source\">{$step['source']}</pre></li>";
}
if (!empty($step['args'])) {
$output .= "<li>";
foreach ($step['args'] as $k => $arg) {
kintParser::reset();
$output .= self::decorate(kintParser::factory($arg, $k));
}
$output .= "</li>";
}
if (!empty($step['object'])) {
$output .= "<li>" . self::decorate($calleeDump) . "</li>";
}
$output .= '</ul></dd>';
}
$output .= '</dl>';
return $output;
}
/**
* Dump information about variables, accepts any number of parameters, supports modifiers:
*
* clean up any output before kint and place the dump at the top of page:
* - Kint::dump()
* *****
* expand all nodes on display:
* ! Kint::dump()
* *****
* dump variables disregarding their depth:
* + Kint::dump()
* *****
* return output instead of displaying it:
* @ Kint::dump()
* *****
* force output as plain text
* ~ Kint::dump()
*
* Modifiers are supported by all dump wrapper functions, including Kint::trace(). Space is optional.
*
*
* You can also use the following shorthand to display debug_backtrace():
* Kint::dump( 1 );
*
* Passing the result from debug_backtrace() to kint::dump() as a single parameter will display it as trace too:
* $trace = debug_backtrace( true );
* Kint::dump( $trace );
* Or simply:
* Kint::dump( debug_backtrace() );
*
*
* @param mixed $data
*
* @return void|string
*/
public static function dump($data = null)
{
if (!self::enabled()) {
return '';
}
list($names, $modifiers, $callee, $previousCaller, $miniTrace) = self::_getCalleeInfo(defined('DEBUG_BACKTRACE_IGNORE_ARGS') ? debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS) : debug_backtrace());
$modeOldValue = self::enabled();
# process modifiers: @, +, !, ~ and -
if (strpos($modifiers, '-') !== false) {
self::$_firstRun = true;
while (ob_get_level()) {
ob_end_clean();
}
}
if (strpos($modifiers, '!') !== false) {
$expandedByDefaultOldValue = self::$expandedByDefault;
self::$expandedByDefault = true;
}
if (strpos($modifiers, '+') !== false) {
$maxLevelsOldValue = self::$maxLevels;
self::$maxLevels = false;
}
if (strpos($modifiers, '@') !== false) {
$returnOldValue = self::$returnOutput;
$firstRunOldValue = self::$_firstRun;
self::$returnOutput = true;
self::$_firstRun = true;
}
if (strpos($modifiers, '~') !== false) {
self::enabled(self::MODE_WHITESPACE);
}
# set mode for current run
$mode = self::enabled();
if ($mode === true) {
$mode = PHP_SAPI === 'cli' ? self::MODE_CLI : self::MODE_RICH;
}
self::enabled($mode);
/** @var Kint_Decorators_Rich|Kint_Decorators_Plain $decorator */
$decorator = self::enabled() === self::MODE_RICH ? 'Kint_Decorators_Rich' : 'Kint_Decorators_Plain';
$output = '';
if (self::$_firstRun) {
$output .= $decorator::init();
}
$trace = false;
if ($names === array(null) && func_num_args() === 1 && $data === 1) {
$trace = debug_backtrace(true);
# Kint::dump(1) shorthand
} elseif (func_num_args() === 1 && is_array($data)) {
$trace = $data;
# test if the single parameter is result of debug_backtrace()
}
$trace and $trace = self::_parseTrace($trace);
$output .= $decorator::wrapStart();
if ($trace) {
$output .= $decorator::decorateTrace($trace);
} else {
$data = func_num_args() === 0 ? array("[[no arguments passed]]") : func_get_args();
foreach ($data as $k => $argument) {
kintParser::reset();
$output .= $decorator::decorate(kintParser::factory($argument, $names[$k]));
}
}
$output .= $decorator::wrapEnd($callee, $miniTrace, $previousCaller);
self::enabled($modeOldValue);
if (strpos($modifiers, '~') === false) {
self::enabled($modeOldValue);
}
if (strpos($modifiers, '!') !== false) {
self::$expandedByDefault = $expandedByDefaultOldValue;
}
if (strpos($modifiers, '+') !== false) {
self::$maxLevels = $maxLevelsOldValue;
}
if (strpos($modifiers, '@') !== false) {
self::$returnOutput = $returnOldValue;
self::$_firstRun = $firstRunOldValue;
return $output;
}
if (self::$returnOutput) {
return $output;
}
echo $output;
return '';
}
/**
* Dump information about variables, accepts any number of parameters, supports modifiers:
*
* clean up any output before kint and place the dump at the top of page:
* - Kint::dump()
* *****
* expand all nodes on display:
* ! Kint::dump()
* *****
* dump variables disregarding their depth:
* + Kint::dump()
* *****
* return output instead of displaying it (also disables ajax/cli detection):
* @ Kint::dump()
* *****
* disable ajax and cli auto-detection and just output as requested (plain/rich):
* ~ Kint::dump()
*
* Modifiers are supported by all dump wrapper functions, including Kint::trace(). Space is optional.
*
*
* You can also use the following shorthand to display debug_backtrace():
* Kint::dump( 1 );
*
* Passing the result from debug_backtrace() to kint::dump() as a single parameter will display it as trace too:
* $trace = debug_backtrace( true );
* Kint::dump( $trace );
* Or simply:
* Kint::dump( debug_backtrace() );
*
*
* @param mixed $data
*
* @return void|string
*/
public static function dump($data = null)
{
if (!Kint::enabled()) {
return '';
}
# find caller information
list($names, $modifiers, $callee, $previousCaller, $miniTrace) = self::_getPassedNames(defined('DEBUG_BACKTRACE_IGNORE_ARGS') ? debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS) : debug_backtrace());
# process modifiers: @, +, !, ~ and -
if (strpos($modifiers, '-') !== false) {
self::$_firstRun = true;
while (ob_get_level()) {
ob_end_clean();
}
}
if (strpos($modifiers, '!') !== false) {
$expandedByDefaultOldValue = self::$expandedByDefault;
self::$expandedByDefault = true;
}
if (strpos($modifiers, '+') !== false) {
$maxLevelsOldValue = self::$maxLevels;
self::$maxLevels = false;
}
if (strpos($modifiers, '@') !== false) {
$firstRunOldValue = self::$_firstRun;
self::$_firstRun = true;
}
# disable mode detection
if (strpos($modifiers, '@') !== false || strpos($modifiers, '~') === false) {
$modeOldValue = self::$mode;
$isAjaxOldValue = self::$_isAjax;
if (self::$_detected === 'ajax') {
self::$_isAjax = true;
} elseif (self::$_detected === 'cli' && self::$cliDetection) {
# cli detection is checked here as you can toggle the feature for individual dumps
self::$mode = self::$cliColors ? 'cli' : 'whitespace';
}
}
$decoratorsMap = array('cli' => 'Kint_Decorators_Cli', 'plain' => 'Kint_Decorators_Plain', 'rich' => 'Kint_Decorators_Rich', 'whitespace' => 'Kint_Decorators_Whitespace');
$decorator = $decoratorsMap[self::$mode];
$output = $decorator::wrapStart($callee);
$trace = false;
if ($names === array(null) && func_num_args() === 1 && $data === 1) {
$trace = debug_backtrace(true);
# Kint::dump(1) shorthand
} elseif (func_num_args() === 1 && is_array($data)) {
$trace = $data;
# test if the single parameter is result of debug_backtrace()
}
$trace and $trace = self::_parseTrace($trace);
if ($trace) {
$output .= $decorator::decorateTrace($trace);
} else {
$data = func_num_args() === 0 ? array("[[no arguments passed]]") : func_get_args();
foreach ($data as $k => $argument) {
kintParser::reset();
$output .= $decorator::decorate(kintParser::factory($argument, $names[$k]));
}
}
$output .= $decorator::wrapEnd($callee, $miniTrace, $previousCaller);
if (strpos($modifiers, '~') === false) {
self::$mode = $modeOldValue;
}
if (strpos($modifiers, '!') !== false) {
self::$expandedByDefault = $expandedByDefaultOldValue;
}
if (strpos($modifiers, '+') !== false) {
self::$maxLevels = $maxLevelsOldValue;
}
if (strpos($modifiers, '@') !== false) {
self::$_firstRun = $firstRunOldValue;
return $output;
}
if (self::$_isAjax) {
$data = rawurlencode($output);
$chunks = array();
while (strlen($data) > 4096) {
$chunks[] = substr($data, 0, 4096);
$data = substr($data, 4096);
}
$chunks[] = $data;
for ($i = 0, $c = count($chunks); $i < $c; $i++) {
$index = self::$_headerNo++;
$name = 'kint' . ($index > 0 ? "-{$index}" : '');
header("{$name}: {$chunks[$i]}");
}
if (strpos($modifiers, '~') === false) {
self::$_isAjax = $isAjaxOldValue;
}
return '';
}
echo $output;
return '';
}
