Syscodes\Debug\Handlers\PleasingPageHandler

Complexity

Total Complexity

48

Size/Duplication

Total Lines	426
Duplicated Lines	0 %

Importance

Changes	1
Bugs	0	Features	0

19 Methods

Rating	Name	Duplication	Size	Complexity
A	addTables()	0	3	1
A	getDefaultTables()	0	10	2
A	addEditor()	0	3	1
A	__construct()	0	4	1
A	contentType()	0	3	1
A	collectionVars()	0	27	1
A	getBrand()	0	3	1
A	getProcessTables()	0	25	6
C	getEditor()	0	29	14
A	handle()	0	12	2
A	getEditorAtHref()	0	16	4
A	setBrand()	0	3	1
A	getPageTitle()	0	3	1
A	getResource()	0	20	4
A	getEditorcode()	0	3	1
A	getExceptionFrames()	0	5	1
A	setPageTitle()	0	3	1
A	getExceptionCode()	0	10	2
A	setEditor()	0	9	3

<?php 

/**
 * Lenevor Framework
 *
 * LICENSE
 *
 * This source file is subject to the new BSD license that is bundled
 * with this package in the file license.md.
 * It is also available through the world-wide-web at this URL:
 * https://lenevor.com/license
 * If you did not receive a copy of the license and are unable to
 * obtain it through the world-wide-web, please send an email
 * to license@Lenevor.com so we can send you a copy immediately.
 *
 * @package     Lenevor
 * @subpackage  Base
 * @link        https://lenevor.com
 * @copyright   Copyright (c) 2019 - 2021 Alexander Campo <jalexcam@gmail.com>
 * @license     https://opensource.org/licenses/BSD-3-Clause New BSD license or see https://lenevor.com/license or see /license.md
 */

namespace Syscodes\Debug\Handlers;

use Throwable;
use Traversable;
use ErrorException;
use RuntimeException;
use InvalidArgumentException;
use Syscodes\Debug\Util\Misc;
use UnexpectedValueException;
use Syscodes\Debug\Util\ArrayTable;
use Syscodes\Contracts\Debug\Table;
use Syscodes\Debug\Util\TemplateHandler;
use Syscodes\Debug\FrameHandler\Formatter;  

/**
 * Generates exceptions in mode of graphic interface.
 * 
 * @author Alexander Campo <jalexcam@gmail.com>
 */
class PleasingPageHandler extends MainHandler
{
	/**
	 * The brand main of handler.
	 * 
	 * @var string $brand
	 */
	protected $brand = 'Lenevor Debug';

	/**
	 * A string identifier for a known IDE/text editor, or a closure
	 * that resolves a string that can be used to open a given file
	 * in an editor.
	 * 
	 * @var mixed $editor
	 */
	protected $editor;

	/**
	 * A list of known editor strings.
	 * 
	 * @var array $editors
	 */
	protected $editors = [
		"vscode"   => "vscode://file/%file:%line",
		"sublime"  => "subl://open?url=file://%file&line=%line",
		"phpstorm" => "phpstorm://open?file://%file&line=%line",
		"textmate" => "txmt://open?url=file://%file&line=%line",
		"atom"     => "atom://core/open/file?filename=%file&line=%line",
	];
	
	/**
	 * The page title main of handler.
	 * 
	 * @var string $pageTitle
	 */
	protected $pageTitle = 'Lenevor Debug! There was an error.';
	
	/**
	 * Fast lookup cache for known resource locations.
	 * 
	 * @var array $resourceCache
	 */
	protected $resourceCache = [];
	
	/**
	 * The path to the directory containing the html error template directories.
	 * 
	 * @var array $searchPaths
	 */
	protected $searchPaths = [];

	/**
	 * Gets the table of data.
	 * 
	 * @var array $tables
	 */
	protected $tables = [];
	
	/**
	 * The template handler system.
	 * 
	 * @var string $template
	 */
	protected $template;	
	
	/**
	 * Constructor. The PleasingPageHandler class.
	 * 
	 * @return void
	 */
	public function __construct()
	{
		$this->template      = new TemplateHandler;

It seems like new Syscodes\Debug\Util\TemplateHandler() of type Syscodes\Debug\Util\TemplateHandler is incompatible with the declared type string of property $template.

		$this->searchPaths[] = dirname(__DIR__).DIRECTORY_SEPARATOR.'Resources';
	}

	/**
	 * Adds an editor resolver, identified by a string name, and that may be a 
	 * string path, or a callable resolver.
	 * 
	 * @param  string            $identifier
	 * @param  string|\Callable  $resolver

The type Callable was not found. Maybe you did not declare it correctly or list all dependencies?

	 * 
	 * @return void
	 */
	public function addEditor($identifier, $resolver)
	{
		$this->editors[$identifier] = $resolver;
	}

	/**
	 * Adds an entry to the list of tables displayed in the template.
	 * The expected data is a simple associative array. Any nested arrays
	 * will be flattened with print_r.
	 * 
	 * @param  \Syscodes\Contracts\Debug\Table  $table
	 * 
	 * @return array
	 */
	public function addTables(Table $table)
	{
		$this->tables[] = $table;
	}
	
	/**
	 * Gathers the variables that will be made available to the view.
	 * 
	 * @return  array
	 */
	protected function collectionVars()
	{
		$supervisor = $this->getSupervisor();
		$style      = file_get_contents($this->getResource('css/debug.base.css'));
		$jscript    = file_get_contents($this->getResource('js/debug.base.js'));
		$tables     = array_merge($this->getDefaultTables(), $this->tables);
		
		return [ 
			'class'             => explode('\\', $supervisor->getExceptionName()),
			'stylesheet'        => preg_replace('#[\r\n\t ]+#', ' ', $style),
			'javascript'        => preg_replace('#[\r\n\t ]+#', ' ', $jscript),
			'header'            => $this->getResource('views/header.php'),
			'sidebar'           => $this->getResource('views/sidebar.php'),
			'frame_description' => $this->getResource('views/frame_description.php'),
			'frame_list'        => $this->getResource('views/frame_list.php'),
			'details_panel'     => $this->getResource('views/details_panel.php'),
			'code_source'       => $this->getResource('views/code_source.php'),
			'details_content'   => $this->getResource('views/details_content.php'),
			'footer'            => $this->getResource('views/footer.php'),
			'plain_exception'   => Formatter::formatExceptionAsPlainText($this->getSupervisor()),
			'handler'           => $this,
			'handlers'          => $this->getDebug()->getHandlers(),

The method getHandlers() does not exist on Syscodes\Contracts\Debug\Handler. Since it exists in all sub-types, consider adding an abstract or default implementation to Syscodes\Contracts\Debug\Handler.

			'debug'             => $this->getDebug(),
			'code'              => $this->getExceptionCode(),
			'message'           => $supervisor->getExceptionMessage(),
			'frames'            => $this->getExceptionFrames(),
			'tables'            => $this->getProcessTables($tables),
		];
	}
	
	/**
	 * The way in which the data sender (usually the server) can tell the recipient
	 * (the browser, in general) what type of data is being sent in this case, html format tagged.
	 * 
	 * @return string
	 */
	public function contentType()
	{
		return 'text/html;charset=UTF-8';
	}

	/**
	 * Gets the brand of project.
	 * 
	 * @return string
	 */
	public function getBrand()
	{
		return $this->brand;
	}

	/**
	 * Returns the default tables.
	 * 
	 * @return \Syscodes\Contracts\Debug\Table[]
	 */
	protected function getDefaultTables()
	{
		return [
			new ArrayTable('GET Data', $_GET),
			new ArrayTable('POST Data', $_POST),
			new ArrayTable('Files', $_FILES),
			new ArrayTable('Cookie', $_COOKIE),
			new ArrayTable('Session', isset($_SESSION) ? $_SESSION : []),
			new ArrayTable('Server/Request Data', $_SERVER),
			new ArrayTable(__('exception.environmentVars'), $_ENV),
		];
	}

	/**
	 * Get the code of the exception that is currently being handled.
	 * 
	 * @return string
	 */
	protected function getExceptionCode()
	{
		$exception = $this->getException();
		$code      = $exception->getCode();

		if ($exception instanceof ErrorException) {
			$code = Misc::translateErrorCode($exception->getSeverity());
		}

		return (string) $code;
	}

	/**
	 * Get the stack trace frames of the exception that is currently being handled.
	 * 
	 * @return \Syscodes\Debug\Engine\Supervisor;

The type Syscodes\Debug\Engine\Supervisor was not found. Maybe you did not declare it correctly or list all dependencies?

	 */
	protected function getExceptionFrames()
	{
		$frames = $this->getSupervisor()->getFrames();
		
		return $frames;
	}
	
	/**
	 * Gets the page title web.
	 * 
	 * @return string
	 */
	public function getPageTitle()
	{
		return $this->pageTitle;
	}

	/**
	 * Processes an array of tables making sure everything is allright.
	 * 
	 * @param  \Syscodes\Contracts\Debug\Table[]  $tables
	 * 
	 * @return array
	 */
	protected function getProcessTables(array $tables)
	{
		$processTables = [];

		foreach ($tables as $table) {
			if ( ! $table instanceof Table) {
				continue;
			}

			$label = $table->getLabel();

Are you sure the assignment to $label is correct as $table->getLabel() targeting Syscodes\Contracts\Debug\Table::getLabel() seems to always return null.

			try {
				$data = $table->getData();

Are you sure the assignment to $data is correct as $table->getData() targeting Syscodes\Contracts\Debug\Table::getData() seems to always return null.

				if ( ! (is_array($data) || $data instanceof Traversable)) {
					$data = [];
				}
			} catch (Exception $e) {

The type Syscodes\Debug\Handlers\Exception was not found. Did you mean Exception? If so, make sure to prefix the type with \.

				$data = [];
			}

			$processTables[$label] = $data;
		}

		return $processTables;
	}

	/**
	 * Finds a resource, by its relative path, in all available search paths.
	 *
	 * @param  string  $resource
	 * 
	 * @return string
	 * 
	 * @throws \RuntimeException
	 */
	protected function getResource($resource)
	{
		if (isset($this->resourceCache[$resource])) {
			return $this->resourceCache[$resource];
		}

		foreach ($this->searchPaths as $path) {
			$fullPath = $path.DIRECTORY_SEPARATOR.$resource;

			if (is_file($fullPath)) {
				// Cache:
				$this->resourceCache[$resource] = $fullPath;

				return $fullPath;
			}
		}

		throw new RuntimeException( 
				"Could not find resource '{$resource}' in any resource paths.". 
				"(searched: ".join(", ", $this->searchPaths).")");
	}
	
	/**
	 * Given an exception and status code will display the error to the client.
	 * 
	 * @return int|null
	 */
	public function handle()
	{	
		$templatePath = $this->getResource('debug.layout.php');

		$vars = $this->collectionVars();
		
		if (empty($vars['message'])) $vars['message'] = __('exception.noMessage');
		
		$this->template->setVariables($vars);
		$this->template->render($templatePath);
		
		return MainHandler::QUIT;
	}

	/**
	 * Set the editor to use to open referenced files, by a string identifier or callable
	 * that will be executed for every file reference. Should return a string.
	 * 
	 * @example  $debug->setEditor(function($file, $line) { return "file:///{$file}"; });
	 * @example  $debug->setEditor('vscode');
	 * 
	 * @param  string  $editor
	 * 
	 * @return void
	 * 
	 * @throws \InvalidArgumentException
	 */
	public function setEditor($editor)
	{
		if ( ! is_callable($editor) && ! isset($this->editors[$editor])) {
			throw new InvalidArgumentException("Unknown editor identifier: [{$editor}]. Known editors: " .
				implode(', ', array_keys($this->editors))
			);
		}

		$this->editor = $editor;
	}

	/**
	 * Given a string file path, and an integer file line,
	 * executes the editor resolver and returns.
	 * 
	 * @param  string  $file
	 * @param  int	   $line
	 * 
	 * @return string|bool
	 * 
	 * @throws \UnexpectedValueException
	 */
	public function getEditorAtHref($file, $line)
	{
		$editor = $this->getEditor($file, $line);

		if (empty($editor))	{
			return false;
		}

		if ( ! isset($editor['url']) || ! is_string($editor['url'])) {
			throw new UnexpectedValueException(__METHOD__.'should always resolve to a string or a valid editor array');
		}

		$editor['url'] = str_replace("%file", rawurldecode($file), $editor['url']);
		$editor['url'] = str_replace("%line", rawurldecode($line), $editor['url']);

		return $editor['url'];
	}

	/**
	 * The editor must be a valid callable function/closure.
	 * 
	 * @param  string  $file
	 * @param  int	   $line
	 * 
	 * @return array
	 */
	protected function getEditor($file, $line)

The parameter $file is not used and could be removed.

	{
		if ( ! $this->editor || ( ! is_string($this->editor) && ! is_callable($this->editor))) {
			return [];
		}

		if (is_string($this->editor) && isset($this->editors[$this->editor]) && ! is_callable($this->editors[$this->editor])) {
			return ['url' => $this->editors[$this->editor]];
		}

		if (is_callable($this->editor) || (isset($this->editors[$this->editor]) && is_callable($this->editors[$this->editor]))) {
			if (is_callable($this->editor)) {
				$callback = call_user_func($this->editor, $filePath, $line);

The variable $filePath seems to be never defined.

			} else {
				$callback = call_user_func($this->editors[$this->editor], $filePath, $line);
			}

			if (empty($callback)) {
				return [];
			}

			if (is_string($callback)) {
				return ['url' => $callback];
			}
			
			return ['url' => isset($callback['url']) ? $callback['url'] : $callback];
		}
		
		return [];
	}

	/**
	 * Registered the editor.
	 * 
	 * @return string
	 */
	public function getEditorcode()
	{
		return $this->editor;
	}
	
	/**
	 * Sets the brand of project.
	 * 
	 * @param  string  $brand
	 * 
	 * @return void
	 */
	public function setBrand($brand)
	{
		$this->brand = (string) $brand;
	}
	
	/**
	 * Sets the page title web.
	 * 
	 * @param  string  $title
	 * 
	 * @return void
	 */
	public function setPageTitle($title)
	{
		$this->pageTitle = (string) $title;
	}
}