ThemeResourceLoader::inst() - Code Metrics - Inspection of "Merge branch '4.3' into 4.4" - silverstripe/silverstripe-framework - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — 4.4 ( cfe86a...592ab6 )

by Robbie

created 2019-09-14 01:11 UTC

ThemeResourceLoader::inst() A

↳ Parent: ThemeResourceLoader

Complexity

Conditions	2
Paths	2

Size

Total Lines	3
Code Lines	1

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
cc	2
eloc	1
nc	2
nop	0
dl	0
loc	3
rs	10
c	0
b	0
f	0

<?php

namespace SilverStripe\View;

use InvalidArgumentException;
use Psr\SimpleCache\CacheInterface;
use SilverStripe\Core\Flushable;
use SilverStripe\Core\Injector\Injector;
use SilverStripe\Core\Manifest\ModuleLoader;
use SilverStripe\Core\Path;

/**
 * Handles finding templates from a stack of template manifest objects.
 */
class ThemeResourceLoader implements Flushable
{

    /**
     * @var ThemeResourceLoader
     */
    private static $instance;

    /**
     * The base path of the application
     *
     * @var string
     */
    protected $base;

    /**
     * List of template "sets" that contain a test manifest, and have an alias.
     * E.g. '$default'
     *
     * @var ThemeList[]
     */
    protected $sets = [];

    /**
     * @var CacheInterface
     */
    protected $cache;

    /**
     * @return ThemeResourceLoader
     */
    public static function inst()
    {
        return self::$instance ? self::$instance : self::$instance = new self();
    }

    /**
     * Set instance
     *
     * @param ThemeResourceLoader $instance
     */
    public static function set_instance(ThemeResourceLoader $instance)
    {
        self::$instance = $instance;
    }

    public function __construct($base = null)
    {
        $this->base = $base ? $base : BASE_PATH;
    }

    /**
     * Add a new theme manifest for a given identifier. E.g. '$default'
     *
     * @param string $set
     * @param ThemeList $manifest
     */
    public function addSet($set, ThemeList $manifest)
    {
        $this->sets[$set] = $manifest;
    }

    /**
     * Get a named theme set
     *
     * @param string $set
     * @return ThemeList
     */
    public function getSet($set)
    {
        if (isset($this->sets[$set])) {
            return $this->sets[$set];
        }
        return null;
    }

    /**
     * Given a theme identifier, determine the path from the root directory
     *
     * The mapping from $identifier to path follows these rules:
     * - A simple theme name ('mytheme') which maps to the standard themes dir (/themes/mytheme)
     * - A theme path with a leading slash ('/mymodule/themes/mytheme') which maps directly to that path.
     * - or a vendored theme path. (vendor/mymodule:mytheme) which maps to the nested 'theme' within
     *   that module. ('/mymodule/themes/mytheme').
     * - A vendored module with no nested theme (vendor/mymodule) which maps to the root directory
     *   of that module. ('/mymodule').
     *
     * @param string $identifier Theme identifier.
     * @return string Path from root, not including leading or trailing forward slash. E.g. themes/mytheme
     */
    public function getPath($identifier)
    {
        $slashPos = strpos($identifier, '/');
        $parts = explode(':', $identifier, 2);

        // If identifier starts with "/", it's a path from root
        if ($slashPos === 0) {
            if (count($parts) > 1) {
                throw new InvalidArgumentException("Invalid theme identifier {$identifier}");
            }
            return Path::normalise($identifier, true);
        }

        // If there is no slash / colon it's a legacy theme
        if ($slashPos === false && count($parts) === 1) {
            return Path::join(THEMES_DIR, $identifier);
        }

        // Extract from <vendor>/<module>:<theme> format.
        // <vendor> is optional, and if <theme> is omitted it defaults to the module root dir.
        // If <theme> is included, this is the name of the directory under moduleroot/themes/
        // which contains the theme.
        // <module> is always the name of the install directory, not necessarily the composer name.

        // Find module from first part
        $moduleName = $parts[0];
        $module = ModuleLoader::inst()->getManifest()->getModule($moduleName);
        if ($module) {

            $modulePath = $module->getRelativePath();
        } else {
            // If no module could be found, assume based on basename
            // with a warning
            if (strstr('/', $moduleName)) {
                list(, $modulePath) = explode('/', $parts[0], 2);
            } else {
                $modulePath = $moduleName;
            }
            trigger_error("No module named {$moduleName} found. Assuming path {$modulePath}", E_USER_WARNING);
        }

        // Parse relative path for this theme within this module
        $theme = count($parts) > 1 ? $parts[1] : '';
        if (empty($theme)) {
            // "module/vendor:"
            // "module/vendor"
            $subpath = '';
        } elseif (strpos($theme, '/') === 0) {
            // "module/vendor:/sub/path"
            $subpath = rtrim($theme, '/');
        } else {
            // "module/vendor:subtheme"
            $subpath = '/themes/' . $theme;
        }

        // Join module with subpath
        return Path::normalise($modulePath . $subpath, true);
    }

    /**
     * Attempts to find possible candidate templates from a set of template
     * names from modules, current theme directory and finally the application
     * folder.
     *
     * The template names can be passed in as plain strings, or be in the
     * format "type/name", where type is the type of template to search for
     * (e.g. Includes, Layout).
     *
     * The results of this method will be cached for future use.
     *
     * @param string|array $template Template name, or template spec in array format with the keys
     * 'type' (type string) and 'templates' (template hierarchy in order of precedence).
     * If 'templates' is ommitted then any other item in the array will be treated as the template
     * list, or list of templates each in the array spec given.
     * Templates with an .ss extension will be treated as file paths, and will bypass
     * theme-coupled resolution.
     * @param array $themes List of themes to use to resolve themes. Defaults to {@see SSViewer::get_themes()}
     * @return string Absolute path to resolved template file, or null if not resolved.
     * File location will be in the format themes/<theme>/templates/<directories>/<type>/<basename>.ss
     * Note that type (e.g. 'Layout') is not the root level directory under 'templates'.
     */
    public function findTemplate($template, $themes = null)
    {
        if ($themes === null) {
            $themes = SSViewer::get_themes();
        }

        // Look for a cached result for this data set
        $cacheKey = md5(json_encode($template) . json_encode($themes));
        if ($this->getCache()->has($cacheKey)) {
            return $this->getCache()->get($cacheKey);
        }

        $type = '';
        if (is_array($template)) {
            // Check if templates has type specified
            if (array_key_exists('type', $template)) {
                $type = $template['type'];
                unset($template['type']);
            }
            // Templates are either nested in 'templates' or just the rest of the list
            $templateList = array_key_exists('templates', $template) ? $template['templates'] : $template;
        } else {
            $templateList = array($template);
        }

        foreach ($templateList as $i => $template) {

            // Check if passed list of templates in array format
            if (is_array($template)) {
                $path = $this->findTemplate($template, $themes);
                if ($path) {
                    $this->getCache()->set($cacheKey, $path);
                    return $path;
                }
                continue;
            }

            // If we have an .ss extension, this is a path, not a template name. We should
            // pass in templates without extensions in order for template manifest to find
            // files dynamically.
            if (substr($template, -3) == '.ss' && file_exists($template)) {
                $this->getCache()->set($cacheKey, $template);
                return $template;
            }

            // Check string template identifier
            $template = str_replace('\\', '/', $template);
            $parts = explode('/', $template);

            $tail = array_pop($parts);
            $head = implode('/', $parts);
            $themePaths = $this->getThemePaths($themes);
            foreach ($themePaths as $themePath) {
                // Join path
                $pathParts = [ $this->base, $themePath, 'templates', $head, $type, $tail ];
                try {
                    $path = Path::join($pathParts) . '.ss';
                    if (file_exists($path)) {
                        $this->getCache()->set($cacheKey, $path);
                        return $path;
                    }
                } catch (InvalidArgumentException $e) {
                    // No-op
                }
            }
        }

        // No template found
        $this->getCache()->set($cacheKey, null);
        return null;
    }

    /**
     * Resolve themed CSS path
     *
     * @param string $name Name of CSS file without extension
     * @param array $themes List of themes, Defaults to {@see SSViewer::get_themes()}
     * @return string Path to resolved CSS file (relative to base dir)
     */
    public function findThemedCSS($name, $themes = null)
    {
        if ($themes === null) {
            $themes = SSViewer::get_themes();
        }

        if (substr($name, -4) !== '.css') {
            $name .= '.css';
        }

        $filename = $this->findThemedResource("css/$name", $themes);
        if ($filename === null) {

            $filename = $this->findThemedResource($name, $themes);
        }

        return $filename;
    }

    /**
     * Resolve themed javascript path
     *
     * A javascript file in the current theme path name 'themename/javascript/$name.js' is first searched for,
     * and it that doesn't exist and the module parameter is set then a javascript file with that name in
     * the module is used.
     *
     * @param string $name The name of the file - eg '/js/File.js' would have the name 'File'
     * @param array $themes List of themes, Defaults to {@see SSViewer::get_themes()}
     * @return string Path to resolved javascript file (relative to base dir)
     */
    public function findThemedJavascript($name, $themes = null)
    {
        if ($themes === null) {
            $themes = SSViewer::get_themes();
        }

        if (substr($name, -3) !== '.js') {
            $name .= '.js';
        }

        $filename = $this->findThemedResource("javascript/$name", $themes);
        if ($filename === null) {

            $filename = $this->findThemedResource($name, $themes);
        }

        return $filename;
    }

    /**
     * Resolve a themed resource
     *
     * A themed resource and be any file that resides in a theme folder.
     *
     * @param string $resource A file path relative to the root folder of a theme
     * @param array $themes An order listed of themes to search, Defaults to {@see SSViewer::get_themes()}
     * @return string
     */
    public function findThemedResource($resource, $themes = null)
    {
        if ($themes === null) {
            $themes = SSViewer::get_themes();
        }

        $paths = $this->getThemePaths($themes);

        foreach ($paths as $themePath) {
            $relativePath = Path::join($themePath, $resource);
            $absolutePath = Path::join($this->base, $relativePath);
            if (file_exists($absolutePath)) {
                return $relativePath;
            }
        }

        // Resource exists in no context
        return null;
    }

    /**
     * Resolve all themes to the list of root folders relative to site root
     *
     * @param array $themes List of themes to resolve. Supports named theme sets. Defaults to {@see SSViewer::get_themes()}.
     * @return array List of root-relative folders in order of precendence.
     */
    public function getThemePaths($themes = null)
    {
        if ($themes === null) {
            $themes = SSViewer::get_themes();
        }

        $paths = [];
        foreach ($themes as $themename) {
            // Expand theme sets
            $set = $this->getSet($themename);
            $subthemes = $set ? $set->getThemes() : [$themename];

            // Resolve paths
            foreach ($subthemes as $theme) {
                $paths[] = $this->getPath($theme);
            }
        }
        return $paths;
    }

    /**
     * Flush any cached data
     */
    public static function flush()
    {
        self::inst()->getCache()->clear();
    }

    /**
     * @return CacheInterface
     */
    public function getCache()
    {
        if (!$this->cache) {
            $this->setCache(Injector::inst()->get(CacheInterface::class . '.ThemeResourceLoader'));
        }
        return $this->cache;
    }

    /**
     * @param CacheInterface $cache
     * @return ThemeResourceLoader
     */
    public function setCache(CacheInterface $cache)
    {
        $this->cache = $cache;
        return $this;
    }
}


1			<?php
2
3			namespace SilverStripe\View;
4
5			use InvalidArgumentException;
6			use Psr\SimpleCache\CacheInterface;
7			use SilverStripe\Core\Flushable;
8			use SilverStripe\Core\Injector\Injector;
9			use SilverStripe\Core\Manifest\ModuleLoader;
10			use SilverStripe\Core\Path;
11
12			/**
13			* Handles finding templates from a stack of template manifest objects.
14			*/
15			class ThemeResourceLoader implements Flushable
16			{
17
18			/**
19			* @var ThemeResourceLoader
20			*/
21			private static $instance;
22
23			/**
24			* The base path of the application
25			*
26			* @var string
27			*/
28			protected $base;
29
30			/**
31			* List of template "sets" that contain a test manifest, and have an alias.
32			* E.g. '$default'
33			*
34			* @var ThemeList[]
35			*/
36			protected $sets = [];
37
38			/**
39			* @var CacheInterface
40			*/
41			protected $cache;
42
43			/**
44			* @return ThemeResourceLoader
45			*/
46			public static function inst()
47			{
48			return self::$instance ? self::$instance : self::$instance = new self();
49			}
50
51			/**
52			* Set instance
53			*
54			* @param ThemeResourceLoader $instance
55			*/
56			public static function set_instance(ThemeResourceLoader $instance)
57			{
58			self::$instance = $instance;
59			}
60
61			public function __construct($base = null)
62			{
63			$this->base = $base ? $base : BASE_PATH;
64			}
65
66			/**
67			* Add a new theme manifest for a given identifier. E.g. '$default'
68			*
69			* @param string $set
70			* @param ThemeList $manifest
71			*/
72			public function addSet($set, ThemeList $manifest)
73			{
74			$this->sets[$set] = $manifest;
75			}
76
77			/**
78			* Get a named theme set
79			*
80			* @param string $set
81			* @return ThemeList
82			*/
83			public function getSet($set)
84			{
85			if (isset($this->sets[$set])) {
86			return $this->sets[$set];
87			}
88			return null;
89			}
90
91			/**
92			* Given a theme identifier, determine the path from the root directory
93			*
94			* The mapping from $identifier to path follows these rules:
95			* - A simple theme name ('mytheme') which maps to the standard themes dir (/themes/mytheme)
96			* - A theme path with a leading slash ('/mymodule/themes/mytheme') which maps directly to that path.
97			* - or a vendored theme path. (vendor/mymodule:mytheme) which maps to the nested 'theme' within
98			* that module. ('/mymodule/themes/mytheme').
99			* - A vendored module with no nested theme (vendor/mymodule) which maps to the root directory
100			* of that module. ('/mymodule').
101			*
102			* @param string $identifier Theme identifier.
103			* @return string Path from root, not including leading or trailing forward slash. E.g. themes/mytheme
104			*/
105			public function getPath($identifier)
106			{
107			$slashPos = strpos($identifier, '/');
108			$parts = explode(':', $identifier, 2);
109
110			// If identifier starts with "/", it's a path from root
111			if ($slashPos === 0) {
112			if (count($parts) > 1) {
113			throw new InvalidArgumentException("Invalid theme identifier {$identifier}");
114			}
115			return Path::normalise($identifier, true);
116			}
117
118			// If there is no slash / colon it's a legacy theme
119			if ($slashPos === false && count($parts) === 1) {
120			return Path::join(THEMES_DIR, $identifier);
121			}
122
123			// Extract from <vendor>/<module>:<theme> format.
124			// <vendor> is optional, and if <theme> is omitted it defaults to the module root dir.
125			// If <theme> is included, this is the name of the directory under moduleroot/themes/
126			// which contains the theme.
127			// <module> is always the name of the install directory, not necessarily the composer name.
128
129			// Find module from first part
130			$moduleName = $parts[0];
131			$module = ModuleLoader::inst()->getManifest()->getModule($moduleName);
132			if ($module) {
			0 ignored issues – show introduced 2018-10-19 16:08 UTC by Report Bug Copy Issue Report `$module` is of type `SilverStripe\Core\Manifest\Module`, thus it always evaluated to `true`. Loading history...
133			$modulePath = $module->getRelativePath();
134			} else {
135			// If no module could be found, assume based on basename
136			// with a warning
137			if (strstr('/', $moduleName)) {
138			list(, $modulePath) = explode('/', $parts[0], 2);
139			} else {
140			$modulePath = $moduleName;
141			}
142			trigger_error("No module named {$moduleName} found. Assuming path {$modulePath}", E_USER_WARNING);
143			}
144
145			// Parse relative path for this theme within this module
146			$theme = count($parts) > 1 ? $parts[1] : '';
147			if (empty($theme)) {
148			// "module/vendor:"
149			// "module/vendor"
150			$subpath = '';
151			} elseif (strpos($theme, '/') === 0) {
152			// "module/vendor:/sub/path"
153			$subpath = rtrim($theme, '/');
154			} else {
155			// "module/vendor:subtheme"
156			$subpath = '/themes/' . $theme;
157			}
158
159			// Join module with subpath
160			return Path::normalise($modulePath . $subpath, true);
161			}
162
163			/**
164			* Attempts to find possible candidate templates from a set of template
165			* names from modules, current theme directory and finally the application
166			* folder.
167			*
168			* The template names can be passed in as plain strings, or be in the
169			* format "type/name", where type is the type of template to search for
170			* (e.g. Includes, Layout).
171			*
172			* The results of this method will be cached for future use.
173			*
174			* @param string\|array $template Template name, or template spec in array format with the keys
175			* 'type' (type string) and 'templates' (template hierarchy in order of precedence).
176			* If 'templates' is ommitted then any other item in the array will be treated as the template
177			* list, or list of templates each in the array spec given.
178			* Templates with an .ss extension will be treated as file paths, and will bypass
179			* theme-coupled resolution.
180			* @param array $themes List of themes to use to resolve themes. Defaults to {@see SSViewer::get_themes()}
181			* @return string Absolute path to resolved template file, or null if not resolved.
182			* File location will be in the format themes/<theme>/templates/<directories>/<type>/<basename>.ss
183			* Note that type (e.g. 'Layout') is not the root level directory under 'templates'.
184			*/
185			public function findTemplate($template, $themes = null)
186			{
187			if ($themes === null) {
188			$themes = SSViewer::get_themes();
189			}
190
191			// Look for a cached result for this data set
192			$cacheKey = md5(json_encode($template) . json_encode($themes));
193			if ($this->getCache()->has($cacheKey)) {
194			return $this->getCache()->get($cacheKey);
195			}
196
197			$type = '';
198			if (is_array($template)) {
199			// Check if templates has type specified
200			if (array_key_exists('type', $template)) {
201			$type = $template['type'];
202			unset($template['type']);
203			}
204			// Templates are either nested in 'templates' or just the rest of the list
205			$templateList = array_key_exists('templates', $template) ? $template['templates'] : $template;
206			} else {
207			$templateList = array($template);
208			}
209
210			foreach ($templateList as $i => $template) {
			0 ignored issues – show introduced 2018-02-06 22:33 UTC by Report Bug Copy Issue Report `$template` is overwriting one of the parameters of this function. Loading history...
211			// Check if passed list of templates in array format
212			if (is_array($template)) {
213			$path = $this->findTemplate($template, $themes);
214			if ($path) {
215			$this->getCache()->set($cacheKey, $path);
216			return $path;
217			}
218			continue;
219			}
220
221			// If we have an .ss extension, this is a path, not a template name. We should
222			// pass in templates without extensions in order for template manifest to find
223			// files dynamically.
224			if (substr($template, -3) == '.ss' && file_exists($template)) {
225			$this->getCache()->set($cacheKey, $template);
226			return $template;
227			}
228
229			// Check string template identifier
230			$template = str_replace('\\', '/', $template);
231			$parts = explode('/', $template);
232
233			$tail = array_pop($parts);
234			$head = implode('/', $parts);
235			$themePaths = $this->getThemePaths($themes);
236			foreach ($themePaths as $themePath) {
237			// Join path
238			$pathParts = [ $this->base, $themePath, 'templates', $head, $type, $tail ];
239			try {
240			$path = Path::join($pathParts) . '.ss';
241			if (file_exists($path)) {
242			$this->getCache()->set($cacheKey, $path);
243			return $path;
244			}
245			} catch (InvalidArgumentException $e) {
246			// No-op
247			}
248			}
249			}
250
251			// No template found
252			$this->getCache()->set($cacheKey, null);
253			return null;
254			}
255
256			/**
257			* Resolve themed CSS path
258			*
259			* @param string $name Name of CSS file without extension
260			* @param array $themes List of themes, Defaults to {@see SSViewer::get_themes()}
261			* @return string Path to resolved CSS file (relative to base dir)
262			*/
263			public function findThemedCSS($name, $themes = null)
264			{
265			if ($themes === null) {
266			$themes = SSViewer::get_themes();
267			}
268
269			if (substr($name, -4) !== '.css') {
270			$name .= '.css';
271			}
272
273			$filename = $this->findThemedResource("css/$name", $themes);
274			if ($filename === null) {
			0 ignored issues – show introduced 2018-10-19 16:08 UTC by Report Bug Copy Issue Report The condition `$filename === null` is always `false`. Loading history...
275			$filename = $this->findThemedResource($name, $themes);
276			}
277
278			return $filename;
279			}
280
281			/**
282			* Resolve themed javascript path
283			*
284			* A javascript file in the current theme path name 'themename/javascript/$name.js' is first searched for,
285			* and it that doesn't exist and the module parameter is set then a javascript file with that name in
286			* the module is used.
287			*
288			* @param string $name The name of the file - eg '/js/File.js' would have the name 'File'
289			* @param array $themes List of themes, Defaults to {@see SSViewer::get_themes()}
290			* @return string Path to resolved javascript file (relative to base dir)
291			*/
292			public function findThemedJavascript($name, $themes = null)
293			{
294			if ($themes === null) {
295			$themes = SSViewer::get_themes();
296			}
297
298			if (substr($name, -3) !== '.js') {
299			$name .= '.js';
300			}
301
302			$filename = $this->findThemedResource("javascript/$name", $themes);
303			if ($filename === null) {
			0 ignored issues – show introduced 2018-10-19 16:08 UTC by Report Bug Copy Issue Report The condition `$filename === null` is always `false`. Loading history...
304			$filename = $this->findThemedResource($name, $themes);
305			}
306
307			return $filename;
308			}
309
310			/**
311			* Resolve a themed resource
312			*
313			* A themed resource and be any file that resides in a theme folder.
314			*
315			* @param string $resource A file path relative to the root folder of a theme
316			* @param array $themes An order listed of themes to search, Defaults to {@see SSViewer::get_themes()}
317			* @return string
318			*/
319			public function findThemedResource($resource, $themes = null)
320			{
321			if ($themes === null) {
322			$themes = SSViewer::get_themes();
323			}
324
325			$paths = $this->getThemePaths($themes);
326
327			foreach ($paths as $themePath) {
328			$relativePath = Path::join($themePath, $resource);
329			$absolutePath = Path::join($this->base, $relativePath);
330			if (file_exists($absolutePath)) {
331			return $relativePath;
332			}
333			}
334
335			// Resource exists in no context
336			return null;
337			}
338
339			/**
340			* Resolve all themes to the list of root folders relative to site root
341			*
342			* @param array $themes List of themes to resolve. Supports named theme sets. Defaults to {@see SSViewer::get_themes()}.
343			* @return array List of root-relative folders in order of precendence.
344			*/
345			public function getThemePaths($themes = null)
346			{
347			if ($themes === null) {
348			$themes = SSViewer::get_themes();
349			}
350
351			$paths = [];
352			foreach ($themes as $themename) {
353			// Expand theme sets
354			$set = $this->getSet($themename);
355			$subthemes = $set ? $set->getThemes() : [$themename];
356
357			// Resolve paths
358			foreach ($subthemes as $theme) {
359			$paths[] = $this->getPath($theme);
360			}
361			}
362			return $paths;
363			}
364
365			/**
366			* Flush any cached data
367			*/
368			public static function flush()
369			{
370			self::inst()->getCache()->clear();
371			}
372
373			/**
374			* @return CacheInterface
375			*/
376			public function getCache()
377			{
378			if (!$this->cache) {
379			$this->setCache(Injector::inst()->get(CacheInterface::class . '.ThemeResourceLoader'));
380			}
381			return $this->cache;
382			}
383
384			/**
385			* @param CacheInterface $cache
386			* @return ThemeResourceLoader
387			*/
388			public function setCache(CacheInterface $cache)
389			{
390			$this->cache = $cache;
391			return $this;
392			}
393			}
394

silverstripe / silverstripe-framework

Push — 4.4 ( cfe86a...592ab6 )

ThemeResourceLoader::inst() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like