TemplateCachesService::_isTemplateCachingEnabled() - Code Metrics - Inspection of "Bump to 1.1.0" - mmikkel/CacheFlag-Craft3 - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — master ( 6afa72...f96468 )

by M. Mikkel

created 2020-07-21 14:25 UTC

TemplateCachesService::_isTemplateCachingEnabled() A

↳ Parent: TemplateCachesService

Complexity

Conditions	1
Paths	1

Size

Total Lines	3
Code Lines	1

Duplication

Lines	0
Ratio	0 %

Importance

Changes	1
Bugs	0	Features	0

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

<?php
/**
 * Created by PhpStorm.
 * User: mmikkel
 * Date: 14/07/2018
 * Time: 11:55
 */

namespace mmikkel\cacheflag\services;

use Craft;
use craft\base\Component;
use craft\helpers\StringHelper;
use craft\services\TemplateCaches;
use yii\caching\TagDependency;
use DateTime;

/**
 * Class TemplateCachesService
 * @author    Mats Mikkel Rummelhoff
 * @package mmikkel\cacheflag\services
 * @since 1.0.0
 */
class TemplateCachesService extends Component
{

    /** @var bool */
    private $_collectElementTags = false;

    /**
     * @var string|null The current request's path
     * @see _path()
     */
    private $_path;

    // Public Methods
    // =========================================================================
    /**
     * Returns a cached template by its key.
     *
     * @param string $key The template cache key
     * @param string|string[]|null $flags The Cache Flag flags this cache would've been flagged with
     * @param bool $collectElementTags Whether to cache element queries or not
     * @param bool $global Whether the cache would have been stored globally.
     * @return string|null
     */
    public function getTemplateCache(string $key, $flags, bool $collectElementTags, bool $global)
    {
        // Make sure template caching is enabled
        if ($this->_isTemplateCachingEnabled() === false) {
            return null;
        }

        $this->_collectElementTags = $collectElementTags;

        $cacheKey = $this->_cacheKey($key, $global);
        $data = Craft::$app->getCache()->get($cacheKey);

        if ($data === false) {
            return null;
        }

        list($body, $tags) = $data;

        // Make sure the cache was tagged w/ the same flags
        $flagTags = $this->_getTagsForFlags($flags);
        $cachedFlagTags = \array_filter($tags, function (string $tag) {
            return \strpos($tag, 'cacheflag') === 0 || $tag === 'element';
        });

        if (\array_diff($flagTags, $cachedFlagTags) != \array_diff($cachedFlagTags, $flagTags)) {
            return null;
        }

        // If we're actively collecting element cache tags, add this cache's tags to the collection
        Craft::$app->getElements()->collectCacheTags($tags);
        return $body;
    }

    /**
     *
     */
    public function startTemplateCache()
    {
        // Make sure template caching is enabled
        if ($this->_isTemplateCachingEnabled() === false) {
            return;
        }

        if ($this->_collectElementTags) {
            Craft::$app->getElements()->startCollectingCacheTags();
        }
    }

    /**
     * Ends a template cache.
     *
     * @param string $key The template cache key.
     * @param string|null $flags The flags this cache should be flagged with.
     * @param bool $global Whether the cache should be stored globally.
     * @param string|null $duration How long the cache should be stored for. Should be a [relative time format](http://php.net/manual/en/datetime.formats.relative.php).
     * @param mixed|null $expiration When the cache should expire.
     * @param string $body The contents of the cache.
     * @throws \Throwable
     */
    public function endTemplateCache(string $key, $flags, bool $global, string $duration = null, /** @scrutinizer ignore-unused */ $expiration, string $body)
    {

        // Make sure template caching is enabled
        if ($this->_isTemplateCachingEnabled() === false) {
            return;
        }

        // If there are any transform generation URLs in the body, don't cache it.
        // stripslashes($body) in case the URL has been JS-encoded or something.
        if (StringHelper::contains(stripslashes($body), 'assets/generate-transform')) {
            return;
        }

        // Get flag tags
        $flagTags = $this->_getTagsForFlags($flags);

        if ($this->_collectElementTags) {
            // If we're collecting element tags, collect the flag tags too, and end the collection
            Craft::$app->getElements()->collectCacheTags($flagTags);
            $dep = Craft::$app->getElements()->stopCollectingCacheTags();
        } else {
            // If not, just tag it with the flags
            $dep = new TagDependency([
                'tags' => $flagTags,
            ]);
        }

        $cacheKey = $this->_cacheKey($key, $global);

        if ($duration !== null) {
            $duration = (new DateTime($duration))->getTimestamp() - time();
        }

        Craft::$app->getCache()->set($cacheKey, [$body, $dep->tags], $duration, $dep);
    }

    // Private Methods
    // =========================================================================
    /**
     * Returns whether template caching is enabled, based on the 'enableTemplateCaching' config setting.
     *
     * @return bool Whether template caching is enabled
     */
    private function _isTemplateCachingEnabled(): bool
    {
        return !!Craft::$app->getConfig()->getGeneral()->enableTemplateCaching;
    }

    /**
     * Defines a data cache key that should be used for a template cache.
     *
     * @param string $key
     * @param bool $global
     */
    private function _cacheKey(string $key, bool $global): string
    {
        $cacheKey = "template::$key::" . Craft::$app->getSites()->getCurrentSite()->id;

        if (!$global) {
            $cacheKey .= '::' . $this->_path();
        }

        return $cacheKey;
    }

    /**
     * Returns the current request path, including a "site:" or "cp:" prefix.
     *
     * @return string
     */
    private function _path(): string
    {
        if ($this->_path !== null) {
            return $this->_path;
        }

        if (Craft::$app->getRequest()->getIsCpRequest()) {
            $this->_path = 'cp:';
        } else {
            $this->_path = 'site:';
        }

        $this->_path .= Craft::$app->getRequest()->getPathInfo();
        if (Craft::$app->getDb()->getIsMysql()) {
            $this->_path = StringHelper::encodeMb4($this->_path);
        }

        if (($pageNum = Craft::$app->getRequest()->getPageNum()) != 1) {
            $this->_path .= '/' . Craft::$app->getConfig()->getGeneral()->getPageTrigger() . $pageNum;
        }

        return $this->_path;
    }

    /**
     * @param string|array|null $flags
     * @param string $delimiter
     * @return array
     */
    private function _getTagsForFlags($flags, string $delimiter = '|'): array
    {
        $tagsArray = ['cacheflag'];
        if (\is_array($flags)) {
            $flags = \implode(',', \array_map(function ($flag) {
                return \preg_replace('/\s+/', '', $flag);
            }, $flags));
        } else {
            $flags = \preg_replace('/\s+/', '', $flags);
        }
        $flags = \array_filter(\explode($delimiter, $flags));
        $tagsArray = \array_merge($tagsArray, \array_map(function (string $flag) {
            return "cacheflag::$flag";
        }, $flags));
        if ($this->_collectElementTags) {
            $tagsArray[] = 'element';
        }
        return \array_unique(($tagsArray));
    }

}


1			<?php
2			/**
3			* Created by PhpStorm.
4			* User: mmikkel
5			* Date: 14/07/2018
6			* Time: 11:55
7			*/
8
9			namespace mmikkel\cacheflag\services;
10
11			use Craft;
12			use craft\base\Component;
13			use craft\helpers\StringHelper;
14			use craft\services\TemplateCaches;
15			use yii\caching\TagDependency;
16			use DateTime;
17
18			/**
19			* Class TemplateCachesService
20			* @author Mats Mikkel Rummelhoff
21			* @package mmikkel\cacheflag\services
22			* @since 1.0.0
23			*/
24			class TemplateCachesService extends Component
25			{
26
27			/** @var bool */
28			private $_collectElementTags = false;
29
30			/**
31			* @var string\|null The current request's path
32			* @see _path()
33			*/
34			private $_path;
35
36			// Public Methods
37			// =========================================================================
38			/**
39			* Returns a cached template by its key.
40			*
41			* @param string $key The template cache key
42			* @param string\|string[]\|null $flags The Cache Flag flags this cache would've been flagged with
43			* @param bool $collectElementTags Whether to cache element queries or not
44			* @param bool $global Whether the cache would have been stored globally.
45			* @return string\|null
46			*/
47			public function getTemplateCache(string $key, $flags, bool $collectElementTags, bool $global)
48			{
49			// Make sure template caching is enabled
50			if ($this->_isTemplateCachingEnabled() === false) {
51			return null;
52			}
53
54			$this->_collectElementTags = $collectElementTags;
55
56			$cacheKey = $this->_cacheKey($key, $global);
57			$data = Craft::$app->getCache()->get($cacheKey);
58
59			if ($data === false) {
60			return null;
61			}
62
63			list($body, $tags) = $data;
64
65			// Make sure the cache was tagged w/ the same flags
66			$flagTags = $this->_getTagsForFlags($flags);
67			$cachedFlagTags = \array_filter($tags, function (string $tag) {
68			return \strpos($tag, 'cacheflag') === 0 \|\| $tag === 'element';
69			});
70
71			if (\array_diff($flagTags, $cachedFlagTags) != \array_diff($cachedFlagTags, $flagTags)) {
72			return null;
73			}
74
75			// If we're actively collecting element cache tags, add this cache's tags to the collection
76			Craft::$app->getElements()->collectCacheTags($tags);
77			return $body;
78			}
79
80			/**
81			*
82			*/
83			public function startTemplateCache()
84			{
85			// Make sure template caching is enabled
86			if ($this->_isTemplateCachingEnabled() === false) {
87			return;
88			}
89
90			if ($this->_collectElementTags) {
91			Craft::$app->getElements()->startCollectingCacheTags();
92			}
93			}
94
95			/**
96			* Ends a template cache.
97			*
98			* @param string $key The template cache key.
99			* @param string\|null $flags The flags this cache should be flagged with.
100			* @param bool $global Whether the cache should be stored globally.
101			* @param string\|null $duration How long the cache should be stored for. Should be a [relative time format](http://php.net/manual/en/datetime.formats.relative.php).
102			* @param mixed\|null $expiration When the cache should expire.
103			* @param string $body The contents of the cache.
104			* @throws \Throwable
105			*/
106			public function endTemplateCache(string $key, $flags, bool $global, string $duration = null, /** @scrutinizer ignore-unused */ $expiration, string $body)
107			{
108
109			// Make sure template caching is enabled
110			if ($this->_isTemplateCachingEnabled() === false) {
111			return;
112			}
113
114			// If there are any transform generation URLs in the body, don't cache it.
115			// stripslashes($body) in case the URL has been JS-encoded or something.
116			if (StringHelper::contains(stripslashes($body), 'assets/generate-transform')) {
117			return;
118			}
119
120			// Get flag tags
121			$flagTags = $this->_getTagsForFlags($flags);
122
123			if ($this->_collectElementTags) {
124			// If we're collecting element tags, collect the flag tags too, and end the collection
125			Craft::$app->getElements()->collectCacheTags($flagTags);
126			$dep = Craft::$app->getElements()->stopCollectingCacheTags();
127			} else {
128			// If not, just tag it with the flags
129			$dep = new TagDependency([
130			'tags' => $flagTags,
131			]);
132			}
133
134			$cacheKey = $this->_cacheKey($key, $global);
135
136			if ($duration !== null) {
137			$duration = (new DateTime($duration))->getTimestamp() - time();
138			}
139
140			Craft::$app->getCache()->set($cacheKey, [$body, $dep->tags], $duration, $dep);
141			}
142
143			// Private Methods
144			// =========================================================================
145			/**
146			* Returns whether template caching is enabled, based on the 'enableTemplateCaching' config setting.
147			*
148			* @return bool Whether template caching is enabled
149			*/
150			private function _isTemplateCachingEnabled(): bool
151			{
152			return !!Craft::$app->getConfig()->getGeneral()->enableTemplateCaching;
153			}
154
155			/**
156			* Defines a data cache key that should be used for a template cache.
157			*
158			* @param string $key
159			* @param bool $global
160			*/
161			private function _cacheKey(string $key, bool $global): string
162			{
163			$cacheKey = "template::$key::" . Craft::$app->getSites()->getCurrentSite()->id;
164
165			if (!$global) {
166			$cacheKey .= '::' . $this->_path();
167			}
168
169			return $cacheKey;
170			}
171
172			/**
173			* Returns the current request path, including a "site:" or "cp:" prefix.
174			*
175			* @return string
176			*/
177			private function _path(): string
178			{
179			if ($this->_path !== null) {
180			return $this->_path;
181			}
182
183			if (Craft::$app->getRequest()->getIsCpRequest()) {
184			$this->_path = 'cp:';
185			} else {
186			$this->_path = 'site:';
187			}
188
189			$this->_path .= Craft::$app->getRequest()->getPathInfo();
190			if (Craft::$app->getDb()->getIsMysql()) {
191			$this->_path = StringHelper::encodeMb4($this->_path);
192			}
193
194			if (($pageNum = Craft::$app->getRequest()->getPageNum()) != 1) {
195			$this->_path .= '/' . Craft::$app->getConfig()->getGeneral()->getPageTrigger() . $pageNum;
196			}
197
198			return $this->_path;
199			}
200
201			/**
202			* @param string\|array\|null $flags
203			* @param string $delimiter
204			* @return array
205			*/
206			private function _getTagsForFlags($flags, string $delimiter = '\|'): array
207			{
208			$tagsArray = ['cacheflag'];
209			if (\is_array($flags)) {
210			$flags = \implode(',', \array_map(function ($flag) {
211			return \preg_replace('/\s+/', '', $flag);
212			}, $flags));
213			} else {
214			$flags = \preg_replace('/\s+/', '', $flags);
215			}
216			$flags = \array_filter(\explode($delimiter, $flags));
217			$tagsArray = \array_merge($tagsArray, \array_map(function (string $flag) {
218			return "cacheflag::$flag";
219			}, $flags));
220			if ($this->_collectElementTags) {
221			$tagsArray[] = 'element';
222			}
223			return \array_unique(($tagsArray));
224			}
225
226			}
227

mmikkel / CacheFlag-Craft3

Push — master ( 6afa72...f96468 )

TemplateCachesService::_isTemplateCachingEnabled() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like