mirror of
https://git.friendi.ca/friendica/friendica-addons.git
synced 2024-08-19 05:30:52 +00:00
- slim/slim: ^3.1 - symfony/expression-language: ^3.4 - fxp/composer-asset-plugin: ~1.3 - bower-asset/vue: ^2.5 - bower-asset/vue-resource: ^1.5
187 lines
5 KiB
PHP
187 lines
5 KiB
PHP
<?php
|
|
|
|
/*
|
|
* This file is part of the Symfony package.
|
|
*
|
|
* (c) Fabien Potencier <fabien@symfony.com>
|
|
*
|
|
* For the full copyright and license information, please view the LICENSE
|
|
* file that was distributed with this source code.
|
|
*/
|
|
|
|
namespace Symfony\Component\Cache;
|
|
|
|
use Psr\Cache\CacheItemInterface;
|
|
use Psr\Log\LoggerInterface;
|
|
use Symfony\Component\Cache\Exception\InvalidArgumentException;
|
|
|
|
/**
|
|
* @author Nicolas Grekas <p@tchwork.com>
|
|
*/
|
|
final class CacheItem implements CacheItemInterface
|
|
{
|
|
protected $key;
|
|
protected $value;
|
|
protected $isHit = false;
|
|
protected $expiry;
|
|
protected $defaultLifetime;
|
|
protected $tags = array();
|
|
protected $prevTags = array();
|
|
protected $innerItem;
|
|
protected $poolHash;
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function getKey()
|
|
{
|
|
return $this->key;
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function get()
|
|
{
|
|
return $this->value;
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function isHit()
|
|
{
|
|
return $this->isHit;
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function set($value)
|
|
{
|
|
$this->value = $value;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function expiresAt($expiration)
|
|
{
|
|
if (null === $expiration) {
|
|
$this->expiry = $this->defaultLifetime > 0 ? time() + $this->defaultLifetime : null;
|
|
} elseif ($expiration instanceof \DateTimeInterface) {
|
|
$this->expiry = (int) $expiration->format('U');
|
|
} else {
|
|
throw new InvalidArgumentException(sprintf('Expiration date must implement DateTimeInterface or be null, "%s" given', is_object($expiration) ? get_class($expiration) : gettype($expiration)));
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function expiresAfter($time)
|
|
{
|
|
if (null === $time) {
|
|
$this->expiry = $this->defaultLifetime > 0 ? time() + $this->defaultLifetime : null;
|
|
} elseif ($time instanceof \DateInterval) {
|
|
$this->expiry = (int) \DateTime::createFromFormat('U', time())->add($time)->format('U');
|
|
} elseif (is_int($time)) {
|
|
$this->expiry = $time + time();
|
|
} else {
|
|
throw new InvalidArgumentException(sprintf('Expiration date must be an integer, a DateInterval or null, "%s" given', is_object($time) ? get_class($time) : gettype($time)));
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Adds a tag to a cache item.
|
|
*
|
|
* @param string|string[] $tags A tag or array of tags
|
|
*
|
|
* @return static
|
|
*
|
|
* @throws InvalidArgumentException When $tag is not valid
|
|
*/
|
|
public function tag($tags)
|
|
{
|
|
if (!is_array($tags)) {
|
|
$tags = array($tags);
|
|
}
|
|
foreach ($tags as $tag) {
|
|
if (!is_string($tag)) {
|
|
throw new InvalidArgumentException(sprintf('Cache tag must be string, "%s" given', is_object($tag) ? get_class($tag) : gettype($tag)));
|
|
}
|
|
if (isset($this->tags[$tag])) {
|
|
continue;
|
|
}
|
|
if (!isset($tag[0])) {
|
|
throw new InvalidArgumentException('Cache tag length must be greater than zero');
|
|
}
|
|
if (false !== strpbrk($tag, '{}()/\@:')) {
|
|
throw new InvalidArgumentException(sprintf('Cache tag "%s" contains reserved characters {}()/\@:', $tag));
|
|
}
|
|
$this->tags[$tag] = $tag;
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Returns the list of tags bound to the value coming from the pool storage if any.
|
|
*
|
|
* @return array
|
|
*/
|
|
public function getPreviousTags()
|
|
{
|
|
return $this->prevTags;
|
|
}
|
|
|
|
/**
|
|
* Validates a cache key according to PSR-6.
|
|
*
|
|
* @param string $key The key to validate
|
|
*
|
|
* @return string
|
|
*
|
|
* @throws InvalidArgumentException When $key is not valid
|
|
*/
|
|
public static function validateKey($key)
|
|
{
|
|
if (!is_string($key)) {
|
|
throw new InvalidArgumentException(sprintf('Cache key must be string, "%s" given', is_object($key) ? get_class($key) : gettype($key)));
|
|
}
|
|
if (!isset($key[0])) {
|
|
throw new InvalidArgumentException('Cache key length must be greater than zero');
|
|
}
|
|
if (false !== strpbrk($key, '{}()/\@:')) {
|
|
throw new InvalidArgumentException(sprintf('Cache key "%s" contains reserved characters {}()/\@:', $key));
|
|
}
|
|
|
|
return $key;
|
|
}
|
|
|
|
/**
|
|
* Internal logging helper.
|
|
*
|
|
* @internal
|
|
*/
|
|
public static function log(LoggerInterface $logger = null, $message, $context = array())
|
|
{
|
|
if ($logger) {
|
|
$logger->warning($message, $context);
|
|
} else {
|
|
$replace = array();
|
|
foreach ($context as $k => $v) {
|
|
if (is_scalar($v)) {
|
|
$replace['{'.$k.'}'] = $v;
|
|
}
|
|
}
|
|
@trigger_error(strtr($message, $replace), E_USER_WARNING);
|
|
}
|
|
}
|
|
}
|