clock-work
This commit is contained in:
127
vendor/itsgoingd/clockwork/Clockwork/Helpers/StackTrace.php
vendored
Normal file
127
vendor/itsgoingd/clockwork/Clockwork/Helpers/StackTrace.php
vendored
Normal file
@@ -0,0 +1,127 @@
|
||||
<?php namespace Clockwork\Helpers;
|
||||
|
||||
// A stack trace
|
||||
class StackTrace
|
||||
{
|
||||
use Concerns\ResolvesViewName;
|
||||
|
||||
protected $frames;
|
||||
|
||||
protected $basePath;
|
||||
protected $vendorPath;
|
||||
|
||||
// Capture a new stack trace, accepts an array of options, "arguments" to include arguments in the trace and "limit"
|
||||
// to limit the trace length
|
||||
public static function get($options = [])
|
||||
{
|
||||
$backtraceOptions = isset($options['arguments'])
|
||||
? DEBUG_BACKTRACE_PROVIDE_OBJECT : DEBUG_BACKTRACE_PROVIDE_OBJECT | DEBUG_BACKTRACE_IGNORE_ARGS;
|
||||
$limit = isset($options['limit']) ? $options['limit'] : 0;
|
||||
|
||||
return static::from(debug_backtrace($backtraceOptions, $limit));
|
||||
}
|
||||
|
||||
// Create a stack trace from an existing debug_backtrace output
|
||||
public static function from(array $trace)
|
||||
{
|
||||
$basePath = static::resolveBasePath();
|
||||
$vendorPath = static::resolveVendorPath();
|
||||
|
||||
return new static(array_map(function ($frame, $index) use ($basePath, $vendorPath, $trace) {
|
||||
return new StackFrame(
|
||||
static::fixCallUserFuncFrame($frame, $trace, $index), $basePath, $vendorPath
|
||||
);
|
||||
}, $trace, array_keys($trace)), $basePath, $vendorPath);
|
||||
}
|
||||
|
||||
public function __construct(array $frames, $basePath, $vendorPath)
|
||||
{
|
||||
$this->frames = $frames;
|
||||
$this->basePath = $basePath;
|
||||
$this->vendorPath = $vendorPath;
|
||||
}
|
||||
|
||||
// Get all frames
|
||||
public function frames()
|
||||
{
|
||||
return $this->frames;
|
||||
}
|
||||
|
||||
// Get the first frame, optionally filtered by a stack filter or a closure
|
||||
public function first($filter = null)
|
||||
{
|
||||
if (! $filter) return reset($this->frames);
|
||||
|
||||
if ($filter instanceof StackFilter) $filter = $filter->closure();
|
||||
|
||||
foreach ($this->frames as $frame) {
|
||||
if ($filter($frame)) return $frame;
|
||||
}
|
||||
}
|
||||
|
||||
// Get the last frame, optionally filtered by a stack filter or a closure
|
||||
public function last($filter = null)
|
||||
{
|
||||
if (! $filter) return $this->frames[count($this->frames) - 1];
|
||||
|
||||
if ($filter instanceof StackFilter) $filter = $filter->closure();
|
||||
|
||||
foreach (array_reverse($this->frames) as $frame) {
|
||||
if ($filter($frame)) return $frame;
|
||||
}
|
||||
}
|
||||
|
||||
// Get trace filtered by a stack filter or a closure
|
||||
public function filter($filter = null)
|
||||
{
|
||||
if ($filter instanceof StackFilter) $filter = $filter->closure();
|
||||
|
||||
return $this->copy(array_values(array_filter($this->frames, $filter)));
|
||||
}
|
||||
|
||||
// Get trace skipping a number of frames or frames matching a stack filter or a closure
|
||||
public function skip($count = null)
|
||||
{
|
||||
if ($count instanceof StackFilter) $count = $count->closure();
|
||||
if ($count instanceof \Closure) $count = array_search($this->first($count), $this->frames);
|
||||
|
||||
return $this->copy(array_slice($this->frames, $count));
|
||||
}
|
||||
|
||||
// Get trace with a number of frames from the top
|
||||
public function limit($count = null)
|
||||
{
|
||||
return $this->copy(array_slice($this->frames, 0, $count));
|
||||
}
|
||||
|
||||
// Get a copy of the trace
|
||||
public function copy($frames = null)
|
||||
{
|
||||
return new static($frames ?: $this->frames, $this->basePath, $this->vendorPath);
|
||||
}
|
||||
|
||||
protected static function resolveBasePath()
|
||||
{
|
||||
return substr(__DIR__, 0, strpos(__DIR__, DIRECTORY_SEPARATOR . 'vendor' . DIRECTORY_SEPARATOR));
|
||||
}
|
||||
|
||||
protected static function resolveVendorPath()
|
||||
{
|
||||
return static::resolveBasePath() . DIRECTORY_SEPARATOR . 'vendor' . DIRECTORY_SEPARATOR;
|
||||
}
|
||||
|
||||
// Fixes call_user_func stack frames missing file and line
|
||||
protected static function fixCallUserFuncFrame($frame, array $trace, $index)
|
||||
{
|
||||
if (isset($frame['file'])) return $frame;
|
||||
|
||||
$nextFrame = isset($trace[$index + 1]) ? $trace[$index + 1] : null;
|
||||
|
||||
if (! $nextFrame || ! in_array($nextFrame['function'], [ 'call_user_func', 'call_user_func_array' ])) return $frame;
|
||||
|
||||
$frame['file'] = $nextFrame['file'];
|
||||
$frame['line'] = $nextFrame['line'];
|
||||
|
||||
return $frame;
|
||||
}
|
||||
}
|
Reference in New Issue
Block a user