/** * 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 ''; }