brightnucleus / view

src/View/ViewBuilder.php

Indentation +300 added lines, -300 removed lines

@@ -33,305 +33,305 @@
 class ViewBuilder
 {
 
-    use ConfigTrait;
-
-    const ENGINE_FINDER_KEY = 'EngineFinder';
-    const VIEW_FINDER_KEY = 'ViewFinder';
-
-    /**
-     * BaseViewFinder instance.
-     *
-     * @since 0.1.0
-     *
-     * @var ViewFinder
-     */
-    protected $viewFinder;
-
-    /**
-     * BaseEngineFinder instance.
-     *
-     * @since 0.1.0
-     *
-     * @var EngineFinder
-     */
-    protected $engineFinder;
-
-    /**
-     * Locations to scan for views.
-     *
-     * @since 0.1.0
-     *
-     * @var Locations
-     */
-    protected $locations;
-
-    /**
-     * Cache of already resolved view paths.
-     *
-     * @since 0.4.6
-     *
-     * @var string[]
-     */
-    protected $viewPathCache = [];
-
-    /**
-     * Instantiate a ViewBuilder object.
-     *
-     * @since 0.1.0
-     *
-     * @param ConfigInterface   $config       Optional. Configuration settings.
-     * @param ViewFinder|null   $viewFinder   Optional. ViewFinder instance.
-     * @param EngineFinder|null $engineFinder Optional. EngineFinder instance.
-     *
-     * @throws FailedToProcessConfigException If the config could not be processed.
-     */
-    public function __construct(
-        ConfigInterface $config = null,
-        ViewFinder $viewFinder = null,
-        EngineFinder $engineFinder = null
-    ) {
-        $this->processConfig($this->getConfig($config));
-        $this->viewFinder   = $viewFinder ?? $this->getViewFinder();
-        $this->engineFinder = $engineFinder ?? $this->getEngineFinder();
-        $this->locations    = new Locations();
-    }
-
-    /**
-     * Create a new view for a given URI.
-     *
-     * @since 0.1.0
-     *
-     * @param string $view View identifier to create a view for.
-     * @param mixed  $type Type of view to create.
-     *
-     * @return View Instance of the requested view.
-     * @throws FailedToInstantiateView If the view could not be instantiated.
-     */
-    public function create(string $view, $type = null): View
-    {
-        if (!array_key_exists($view, $this->viewPathCache)) {
-            $uri    = $this->scanLocations([$view]);
-            $engine = $uri ? $this->getEngine($uri) : false;
-
-            $this->viewPathCache[$view]           = [];
-            $this->viewPathCache[$view]['uri']    = $uri;
-            $this->viewPathCache[$view]['engine'] = $engine;
-
-            if ($type===null) {
-                $this->viewPathCache[$view]['view'] = $uri
-                    ? $this->getView($uri, $engine)
-                    : false;
-            }
-        } else {
-            $uri    = $this->viewPathCache[$view]['uri'];
-            $engine = $this->viewPathCache[$view]['engine'];
-        }
-
-
-        if (!$uri || !$engine) {
-            return $this->getViewFinder()->getNullObject();
-        }
-
-        if ($type === null) {
-            return $this->viewPathCache[$view]['view'];
-        }
-
-        return $this->getView($uri, $engine, $type);
-    }
-
-    /**
-     * Get an Engine that can deal with the given URI.
-     *
-     * @since 0.1.0
-     *
-     * @param string $uri URI to get an engine for.
-     *
-     * @return Engine Instance of an engine that can deal with the given URI.
-     */
-    public function getEngine(string $uri): Engine
-    {
-        return $this->getEngineFinder()->find([$uri]);
-    }
-
-    /**
-     * Get a view for a given URI, engine and type.
-     *
-     * @since 0.1.0
-     *
-     * @param string $uri    URI to get a view for.
-     * @param Engine $engine Engine to use for the view.
-     * @param mixed  $type   Type of view to get.
-     *
-     * @return View View that matches the given requirements.
-     * @throws FailedToInstantiateView If the view could not be instantiated.
-     */
-    public function getView(string $uri, Engine $engine, $type = null): View
-    {
-        if (null === $type) {
-            $view = $this->getViewFinder()->find([$uri], $engine);
-            return $view->setBuilder( $this );
-        }
-
-        return $this->resolveType($type, $uri, $engine);
-    }
-
-    /**
-     * Get the ViewFinder instance.
-     *
-     * @since 0.1.0
-     *
-     * @return ViewFinder Instance of a BaseViewFinder.
-     */
-    public function getViewFinder(): ViewFinder
-    {
-        return $this->viewFinder ?? $this->getFinder(static::VIEW_FINDER_KEY);
-    }
-
-    /**
-     * Get the EngineFinder instance.
-     *
-     * @since 0.1.0
-     *
-     * @return EngineFinder Instance of a BaseEngineFinder.
-     */
-    public function getEngineFinder(): EngineFinder
-    {
-        return $this->engineFinder ?? $this->getFinder(static::ENGINE_FINDER_KEY);
-    }
-
-    /**
-     * Add a location to scan with the BaseViewFinder.
-     *
-     * @since 0.1.0
-     *
-     * @param Location $location Location to scan with the BaseViewFinder.
-     *
-     * @return static
-     */
-    public function addLocation(Location $location)
-    {
-        $this->locations->add($location);
-
-        unset( $this->viewPathCache );
-        $this->viewPathCache = [];
-
-        return $this;
-    }
-
-    /**
-     * Get the collection of locations registered with this ViewBuilder.
-     *
-     * @since 0.1.3
-     *
-     * @return Locations Collection of locations.
-     */
-    public function getLocations()
-    {
-        return $this->locations;
-    }
-
-    /**
-     * Scan Locations for an URI that matches the specified criteria.
-     *
-     * @since 0.1.0
-     *
-     * @param array $criteria Criteria to match.
-     *
-     * @return string|false URI of the requested view, or false if not found.
-     */
-    public function scanLocations(array $criteria)
-    {
-        $uris = $this->locations->map(function ($location) use ($criteria) {
-            /** @var Location $location */
-            return $location->getURI($criteria);
-        })->filter(function ($uri) {
-            return false !== $uri;
-        });
+	use ConfigTrait;
+
+	const ENGINE_FINDER_KEY = 'EngineFinder';
+	const VIEW_FINDER_KEY = 'ViewFinder';
+
+	/**
+	 * BaseViewFinder instance.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @var ViewFinder
+	 */
+	protected $viewFinder;
+
+	/**
+	 * BaseEngineFinder instance.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @var EngineFinder
+	 */
+	protected $engineFinder;
+
+	/**
+	 * Locations to scan for views.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @var Locations
+	 */
+	protected $locations;
+
+	/**
+	 * Cache of already resolved view paths.
+	 *
+	 * @since 0.4.6
+	 *
+	 * @var string[]
+	 */
+	protected $viewPathCache = [];
+
+	/**
+	 * Instantiate a ViewBuilder object.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param ConfigInterface   $config       Optional. Configuration settings.
+	 * @param ViewFinder|null   $viewFinder   Optional. ViewFinder instance.
+	 * @param EngineFinder|null $engineFinder Optional. EngineFinder instance.
+	 *
+	 * @throws FailedToProcessConfigException If the config could not be processed.
+	 */
+	public function __construct(
+		ConfigInterface $config = null,
+		ViewFinder $viewFinder = null,
+		EngineFinder $engineFinder = null
+	) {
+		$this->processConfig($this->getConfig($config));
+		$this->viewFinder   = $viewFinder ?? $this->getViewFinder();
+		$this->engineFinder = $engineFinder ?? $this->getEngineFinder();
+		$this->locations    = new Locations();
+	}
+
+	/**
+	 * Create a new view for a given URI.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param string $view View identifier to create a view for.
+	 * @param mixed  $type Type of view to create.
+	 *
+	 * @return View Instance of the requested view.
+	 * @throws FailedToInstantiateView If the view could not be instantiated.
+	 */
+	public function create(string $view, $type = null): View
+	{
+		if (!array_key_exists($view, $this->viewPathCache)) {
+			$uri    = $this->scanLocations([$view]);
+			$engine = $uri ? $this->getEngine($uri) : false;
+
+			$this->viewPathCache[$view]           = [];
+			$this->viewPathCache[$view]['uri']    = $uri;
+			$this->viewPathCache[$view]['engine'] = $engine;
+
+			if ($type===null) {
+				$this->viewPathCache[$view]['view'] = $uri
+					? $this->getView($uri, $engine)
+					: false;
+			}
+		} else {
+			$uri    = $this->viewPathCache[$view]['uri'];
+			$engine = $this->viewPathCache[$view]['engine'];
+		}
+
+
+		if (!$uri || !$engine) {
+			return $this->getViewFinder()->getNullObject();
+		}
+
+		if ($type === null) {
+			return $this->viewPathCache[$view]['view'];
+		}
+
+		return $this->getView($uri, $engine, $type);
+	}
+
+	/**
+	 * Get an Engine that can deal with the given URI.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param string $uri URI to get an engine for.
+	 *
+	 * @return Engine Instance of an engine that can deal with the given URI.
+	 */
+	public function getEngine(string $uri): Engine
+	{
+		return $this->getEngineFinder()->find([$uri]);
+	}
+
+	/**
+	 * Get a view for a given URI, engine and type.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param string $uri    URI to get a view for.
+	 * @param Engine $engine Engine to use for the view.
+	 * @param mixed  $type   Type of view to get.
+	 *
+	 * @return View View that matches the given requirements.
+	 * @throws FailedToInstantiateView If the view could not be instantiated.
+	 */
+	public function getView(string $uri, Engine $engine, $type = null): View
+	{
+		if (null === $type) {
+			$view = $this->getViewFinder()->find([$uri], $engine);
+			return $view->setBuilder( $this );
+		}
+
+		return $this->resolveType($type, $uri, $engine);
+	}
+
+	/**
+	 * Get the ViewFinder instance.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @return ViewFinder Instance of a BaseViewFinder.
+	 */
+	public function getViewFinder(): ViewFinder
+	{
+		return $this->viewFinder ?? $this->getFinder(static::VIEW_FINDER_KEY);
+	}
+
+	/**
+	 * Get the EngineFinder instance.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @return EngineFinder Instance of a BaseEngineFinder.
+	 */
+	public function getEngineFinder(): EngineFinder
+	{
+		return $this->engineFinder ?? $this->getFinder(static::ENGINE_FINDER_KEY);
+	}
+
+	/**
+	 * Add a location to scan with the BaseViewFinder.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param Location $location Location to scan with the BaseViewFinder.
+	 *
+	 * @return static
+	 */
+	public function addLocation(Location $location)
+	{
+		$this->locations->add($location);
+
+		unset( $this->viewPathCache );
+		$this->viewPathCache = [];
+
+		return $this;
+	}
+
+	/**
+	 * Get the collection of locations registered with this ViewBuilder.
+	 *
+	 * @since 0.1.3
+	 *
+	 * @return Locations Collection of locations.
+	 */
+	public function getLocations()
+	{
+		return $this->locations;
+	}
+
+	/**
+	 * Scan Locations for an URI that matches the specified criteria.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param array $criteria Criteria to match.
+	 *
+	 * @return string|false URI of the requested view, or false if not found.
+	 */
+	public function scanLocations(array $criteria)
+	{
+		$uris = $this->locations->map(function ($location) use ($criteria) {
+			/** @var Location $location */
+			return $location->getURI($criteria);
+		})->filter(function ($uri) {
+			return false !== $uri;
+		});
         
-        // Fall back for absolute paths on current filesystem.
-        if ($uris->isEmpty()) {
-            foreach ($criteria as $criterion) {
-                if (file_exists($criterion)) {
-                    return $criterion;
-                }
-            }
-        }
-
-        return $uris->isEmpty() ? false : $uris->first();
-    }
-
-    /**
-     * Get a finder instance.
-     *
-     * @since 0.1.1
-     *
-     * @param string $key Configuration key to use.
-     *
-     * @return ViewFinder|EngineFinder The requested finder instance.
-     */
-    protected function getFinder($key)
-    {
-        $finderClass = $this->config->getKey($key, 'ClassName');
-        return new $finderClass($this->config->getSubConfig($key));
-    }
-
-    /**
-     * Resolve the view type.
-     *
-     * @since 0.1.0
-     *
-     * @param mixed       $type   Type of view that was requested.
-     * @param string      $uri    URI to get a view for.
-     * @param Engine|null $engine Engine to use for the view.
-     *
-     * @return View Resolved View object.
-     * @throws FailedToInstantiateView If the view type could not be resolved.
-     */
-    protected function resolveType($type, string $uri, Engine $engine = null): View
-    {
-        $configKey = [static::VIEW_FINDER_KEY, 'Views', $type];
-
-        if (is_string($type) && $this->config->hasKey($configKey)) {
-            $className = $this->config->getKey($configKey);
-            $type      = new $className($uri, $engine, $this);
-        }
-
-        if (is_string($type)) {
-            $type = new $type($uri, $engine, $this);
-        }
-
-        if (is_callable($type)) {
-            $type = $type($uri, $engine, $this);
-        }
-
-        if (! $type instanceof View) {
-            throw new FailedToInstantiateView(
-                sprintf(
-                    _('Could not instantiate view "%s".'),
-                    serialize($type)
-                )
-            );
-        }
-
-        return $type;
-    }
-
-    /**
-     * Get the configuration to use in the ViewBuilder.
-     *
-     * @since 0.2.0
-     *
-     * @param ConfigInterface|array $config Config to merge with defaults.
-     *
-     * @return ConfigInterface Configuration passed in through the constructor.
-     */
-    protected function getConfig($config = []): ConfigInterface
-    {
-        $defaults = ConfigFactory::create(dirname(__DIR__, 2) . '/config/defaults.php', $config);
-        $config   = $config
-            ? ConfigFactory::createFromArray(array_merge_recursive($defaults->getArrayCopy(), $config->getArrayCopy()))
-            : $defaults;
-
-        return $config->getSubConfig('BrightNucleus\View');
-    }
+		// Fall back for absolute paths on current filesystem.
+		if ($uris->isEmpty()) {
+			foreach ($criteria as $criterion) {
+				if (file_exists($criterion)) {
+					return $criterion;
+				}
+			}
+		}
+
+		return $uris->isEmpty() ? false : $uris->first();
+	}
+
+	/**
+	 * Get a finder instance.
+	 *
+	 * @since 0.1.1
+	 *
+	 * @param string $key Configuration key to use.
+	 *
+	 * @return ViewFinder|EngineFinder The requested finder instance.
+	 */
+	protected function getFinder($key)
+	{
+		$finderClass = $this->config->getKey($key, 'ClassName');
+		return new $finderClass($this->config->getSubConfig($key));
+	}
+
+	/**
+	 * Resolve the view type.
+	 *
+	 * @since 0.1.0
+	 *
+	 * @param mixed       $type   Type of view that was requested.
+	 * @param string      $uri    URI to get a view for.
+	 * @param Engine|null $engine Engine to use for the view.
+	 *
+	 * @return View Resolved View object.
+	 * @throws FailedToInstantiateView If the view type could not be resolved.
+	 */
+	protected function resolveType($type, string $uri, Engine $engine = null): View
+	{
+		$configKey = [static::VIEW_FINDER_KEY, 'Views', $type];
+
+		if (is_string($type) && $this->config->hasKey($configKey)) {
+			$className = $this->config->getKey($configKey);
+			$type      = new $className($uri, $engine, $this);
+		}
+
+		if (is_string($type)) {
+			$type = new $type($uri, $engine, $this);
+		}
+
+		if (is_callable($type)) {
+			$type = $type($uri, $engine, $this);
+		}
+
+		if (! $type instanceof View) {
+			throw new FailedToInstantiateView(
+				sprintf(
+					_('Could not instantiate view "%s".'),
+					serialize($type)
+				)
+			);
+		}
+
+		return $type;
+	}
+
+	/**
+	 * Get the configuration to use in the ViewBuilder.
+	 *
+	 * @since 0.2.0
+	 *
+	 * @param ConfigInterface|array $config Config to merge with defaults.
+	 *
+	 * @return ConfigInterface Configuration passed in through the constructor.
+	 */
+	protected function getConfig($config = []): ConfigInterface
+	{
+		$defaults = ConfigFactory::create(dirname(__DIR__, 2) . '/config/defaults.php', $config);
+		$config   = $config
+			? ConfigFactory::createFromArray(array_merge_recursive($defaults->getArrayCopy(), $config->getArrayCopy()))
+			: $defaults;
+
+		return $config->getSubConfig('BrightNucleus\View');
+	}
 }

Spacing +9 added lines, -9 removed lines

@@ -109,7 +109,7 @@ 
      */
     public function create(string $view, $type = null): View
     {
-        if (!array_key_exists($view, $this->viewPathCache)) {
+        if ( ! array_key_exists($view, $this->viewPathCache)) {
             $uri    = $this->scanLocations([$view]);
             $engine = $uri ? $this->getEngine($uri) : false;
 
@@ -117,7 +117,7 @@ 
             $this->viewPathCache[$view]['uri']    = $uri;
             $this->viewPathCache[$view]['engine'] = $engine;
 
-            if ($type===null) {
+            if ($type === null) {
                 $this->viewPathCache[$view]['view'] = $uri
                     ? $this->getView($uri, $engine)
                     : false;
@@ -128,7 +128,7 @@ 
         }
 
 
-        if (!$uri || !$engine) {
+        if ( ! $uri || ! $engine) {
             return $this->getViewFinder()->getNullObject();
         }
 
@@ -169,7 +169,7 @@ 
     {
         if (null === $type) {
             $view = $this->getViewFinder()->find([$uri], $engine);
-            return $view->setBuilder( $this );
+            return $view->setBuilder($this);
         }
 
         return $this->resolveType($type, $uri, $engine);
@@ -212,7 +212,7 @@ 
     {
         $this->locations->add($location);
 
-        unset( $this->viewPathCache );
+        unset($this->viewPathCache);
         $this->viewPathCache = [];
 
         return $this;
@@ -241,10 +241,10 @@ 
      */
     public function scanLocations(array $criteria)
     {
-        $uris = $this->locations->map(function ($location) use ($criteria) {
+        $uris = $this->locations->map(function($location) use ($criteria) {
             /** @var Location $location */
             return $location->getURI($criteria);
-        })->filter(function ($uri) {
+        })->filter(function($uri) {
             return false !== $uri;
         });
         
@@ -304,7 +304,7 @@ 
             $type = $type($uri, $engine, $this);
         }
 
-        if (! $type instanceof View) {
+        if ( ! $type instanceof View) {
             throw new FailedToInstantiateView(
                 sprintf(
                     _('Could not instantiate view "%s".'),
@@ -327,7 +327,7 @@ 
      */
     protected function getConfig($config = []): ConfigInterface
     {
-        $defaults = ConfigFactory::create(dirname(__DIR__, 2) . '/config/defaults.php', $config);
+        $defaults = ConfigFactory::create(dirname(__DIR__, 2).'/config/defaults.php', $config);
         $config   = $config
             ? ConfigFactory::createFromArray(array_merge_recursive($defaults->getArrayCopy(), $config->getArrayCopy()))
             : $defaults;