Subversion-Projekte lars-tiefland.laravel_shop

<?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;

	}

}