Initial commit: apps.prometeysev.ru

2026-10-22 00:22:57 +03:00
commit 96ccabcd8b
@@ -0,0 +1,53 @@
+<?php
+
+/*
+ * This file is part of twig-cache-extension.
+ *
+ * (c) Alexander <iam.asm89@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Asm89\Twig\CacheExtension\CacheStrategy;
+
+use Asm89\Twig\CacheExtension\CacheStrategyInterface;
+
+/**
+ * CacheStrategy which doesn't cache at all
+ *
+ * This strategy can be used in development mode, e.g. editing twig templates,
+ * to prevent previously cached versions from being rendered.
+ *
+ * @see     https://github.com/asm89/twig-cache-extension/pull/29
+ *
+ * @author  Hagen Hübel <hhuebel@itinance.com>
+ *
+ * @package Asm89\Twig\CacheExtension\CacheStrategy
+ */
+class BlackholeCacheStrategy implements CacheStrategyInterface
+{
+    /**
+     * {@inheritDoc}
+     */
+    public function fetchBlock($key)
+    {
+        return false;
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function generateKey($annotation, $value)
+    {
+        return microtime(true) . mt_rand();
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function saveBlock($key, $block)
+    {
+        // fire and forget
+    }
+}
@@ -0,0 +1,79 @@
+<?php
+
+/*
+ * This file is part of twig-cache-extension.
+ *
+ * (c) Alexander <iam.asm89@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Asm89\Twig\CacheExtension\CacheStrategy;
+
+use Asm89\Twig\CacheExtension\CacheProviderInterface;
+use Asm89\Twig\CacheExtension\CacheStrategyInterface;
+use Asm89\Twig\CacheExtension\Exception\InvalidCacheKeyException;
+
+/**
+ * Strategy for generational caching.
+ *
+ * In theory the strategy only saves fragments to the cache with infinite
+ * lifetime. The key of the strategy lies in the fact that the keys for blocks
+ * will change as the value for which the key is generated changes.
+ *
+ * For example: entities containing a last update time, would include a
+ * timestamp in the key.
+ *
+ * @see http://37signals.com/svn/posts/3113-how-key-based-cache-expiration-works
+ *
+ * @author Alexander <iam.asm89@gmail.com>
+ */
+class GenerationalCacheStrategy implements CacheStrategyInterface
+{
+    private $keyGenerator;
+    private $cache;
+    private $lifetime;
+
+    /**
+     * @param CacheProviderInterface $cache
+     * @param KeyGeneratorInterface  $keyGenerator
+     * @param integer                $lifetime
+     */
+    public function __construct(CacheProviderInterface $cache, KeyGeneratorInterface $keyGenerator, $lifetime = 0)
+    {
+        $this->keyGenerator = $keyGenerator;
+        $this->cache        = $cache;
+        $this->lifetime     = $lifetime;
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function fetchBlock($key)
+    {
+        return $this->cache->fetch($key);
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function generateKey($annotation, $value)
+    {
+        $key = $this->keyGenerator->generateKey($value);
+
+        if (null === $key) {
+            throw new InvalidCacheKeyException();
+        }
+
+        return $annotation . '__GCS__' . $key;
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function saveBlock($key, $block)
+    {
+        return $this->cache->save($key, $block, $this->lifetime);
+    }
+}
@@ -0,0 +1,76 @@
+<?php
+
+/*
+ * This file is part of twig-cache-extension.
+ *
+ * (c) Alexander <iam.asm89@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Asm89\Twig\CacheExtension\CacheStrategy;
+
+use Asm89\Twig\CacheExtension\CacheStrategyInterface;
+use Asm89\Twig\CacheExtension\Exception\NonExistingStrategyException;
+use Asm89\Twig\CacheExtension\Exception\NonExistingStrategyKeyException;
+
+/**
+ * Combines several configured cache strategies.
+ *
+ * Useful for combining for example generational cache strategy with a lifetime
+ * cache strategy, but also useful when combining several generational cache
+ * strategies which differ on cache lifetime (infinite, 1hr, 5m).
+ *
+ * @author Alexander <iam.asm89@gmail.com>
+ */
+class IndexedChainingCacheStrategy implements CacheStrategyInterface
+{
+    /**
+     * @var CacheStrategyInterface[]
+     */
+    private $strategies;
+
+    /**
+     * @param array $strategies
+     */
+    public function __construct(array $strategies)
+    {
+        $this->strategies = $strategies;
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function fetchBlock($key)
+    {
+        return $this->strategies[$key['strategyKey']]->fetchBlock($key['key']);
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function generateKey($annotation, $value)
+    {
+        if (!is_array($value) || null === $strategyKey = key($value)) {
+            throw new NonExistingStrategyKeyException();
+        }
+
+        if (!isset($this->strategies[$strategyKey])) {
+            throw new NonExistingStrategyException($strategyKey);
+        }
+
+        return array(
+            'strategyKey' => $strategyKey,
+            'key'         => $this->strategies[$strategyKey]->generateKey($annotation, current($value)),
+        );
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function saveBlock($key, $block)
+    {
+        return $this->strategies[$key['strategyKey']]->saveBlock($key['key'], $block);
+    }
+}
@@ -0,0 +1,29 @@
+<?php
+
+/*
+ * This file is part of twig-cache-extension.
+ *
+ * (c) Alexander <iam.asm89@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Asm89\Twig\CacheExtension\CacheStrategy;
+
+/**
+ * Generates a key for a given value.
+ *
+ * @author Alexander <iam.asm89@gmail.com>
+ */
+interface KeyGeneratorInterface
+{
+    /**
+     * Generate a cache key for a given value.
+     *
+     * @param mixed $value
+     *
+     * @return string
+     */
+    public function generateKey($value);
+}
@@ -0,0 +1,68 @@
+<?php
+
+/*
+ * This file is part of twig-cache-extension.
+ *
+ * (c) Alexander <iam.asm89@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Asm89\Twig\CacheExtension\CacheStrategy;
+
+use Asm89\Twig\CacheExtension\CacheProviderInterface;
+use Asm89\Twig\CacheExtension\CacheStrategyInterface;
+use Asm89\Twig\CacheExtension\Exception\InvalidCacheLifetimeException;
+
+/**
+ * Strategy for caching with a pre-defined lifetime.
+ *
+ * The value passed to the strategy is the lifetime of the cache block in
+ * seconds.
+ *
+ * @author Alexander <iam.asm89@gmail.com>
+ */
+class LifetimeCacheStrategy implements CacheStrategyInterface
+{
+    private $cache;
+
+    /**
+     * @param CacheProviderInterface $cache
+     */
+    public function __construct(CacheProviderInterface $cache)
+    {
+        $this->cache = $cache;
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function fetchBlock($key)
+    {
+        return $this->cache->fetch($key['key']);
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function generateKey($annotation, $value)
+    {
+        if (!is_numeric($value)) {
+            throw new InvalidCacheLifetimeException($value);
+        }
+
+        return array(
+            'lifetime' => $value,
+            'key'      => '__LCS__' . $annotation,
+        );
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function saveBlock($key, $block)
+    {
+        return $this->cache->save($key['key'], $block, $key['lifetime']);
+    }
+}