mirror of
https://git.friendi.ca/friendica/friendica-addons.git
synced 2024-08-31 13:30:32 +00:00
- Removing symfony/polyfill-apcu (v1.28.0) - Removing psr/simple-cache (1.0.1) - Updating psr/http-message (1.1 => 2.0) - Downgrading psr/container (2.0.2 => 1.1.2) - Updating slim/slim (4.12.0 => 4.13.0) - Installing symfony/polyfill-php80 (v1.29.0) - Installing symfony/var-exporter (v5.4.35) - Installing symfony/deprecation-contracts (v2.5.2) - Installing symfony/service-contracts (v2.5.2) - Installing symfony/polyfill-php73 (v1.29.0) - Installing symfony/cache-contracts (v2.5.2) - Updating symfony/cache (v3.4.47 => v4.4.48)
204 lines
5.8 KiB
PHP
204 lines
5.8 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\Log\LoggerInterface;
|
|
use Symfony\Component\Cache\Exception\InvalidArgumentException;
|
|
use Symfony\Component\Cache\Exception\LogicException;
|
|
use Symfony\Contracts\Cache\ItemInterface;
|
|
|
|
/**
|
|
* @author Nicolas Grekas <p@tchwork.com>
|
|
*/
|
|
final class CacheItem implements ItemInterface
|
|
{
|
|
private const METADATA_EXPIRY_OFFSET = 1527506807;
|
|
|
|
protected $key;
|
|
protected $value;
|
|
protected $isHit = false;
|
|
protected $expiry;
|
|
protected $metadata = [];
|
|
protected $newMetadata = [];
|
|
protected $innerItem;
|
|
protected $poolHash;
|
|
protected $isTaggable = false;
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function getKey(): string
|
|
{
|
|
return $this->key;
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*
|
|
* @return mixed
|
|
*/
|
|
public function get()
|
|
{
|
|
return $this->value;
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function isHit(): bool
|
|
{
|
|
return $this->isHit;
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function set($value): self
|
|
{
|
|
$this->value = $value;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function expiresAt($expiration): self
|
|
{
|
|
if (null === $expiration) {
|
|
$this->expiry = null;
|
|
} elseif ($expiration instanceof \DateTimeInterface) {
|
|
$this->expiry = (float) $expiration->format('U.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}
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function expiresAfter($time): self
|
|
{
|
|
if (null === $time) {
|
|
$this->expiry = null;
|
|
} elseif ($time instanceof \DateInterval) {
|
|
$this->expiry = microtime(true) + \DateTime::createFromFormat('U', 0)->add($time)->format('U.u');
|
|
} elseif (\is_int($time)) {
|
|
$this->expiry = $time + microtime(true);
|
|
} 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;
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function tag($tags): ItemInterface
|
|
{
|
|
if (!$this->isTaggable) {
|
|
throw new LogicException(sprintf('Cache item "%s" comes from a non tag-aware pool: you cannot tag it.', $this->key));
|
|
}
|
|
if (!is_iterable($tags)) {
|
|
$tags = [$tags];
|
|
}
|
|
foreach ($tags as $tag) {
|
|
if (!\is_string($tag) && !(\is_object($tag) && method_exists($tag, '__toString'))) {
|
|
throw new InvalidArgumentException(sprintf('Cache tag must be string or object that implements __toString(), "%s" given.', \is_object($tag) ? \get_class($tag) : \gettype($tag)));
|
|
}
|
|
$tag = (string) $tag;
|
|
if (isset($this->newMetadata[self::METADATA_TAGS][$tag])) {
|
|
continue;
|
|
}
|
|
if ('' === $tag) {
|
|
throw new InvalidArgumentException('Cache tag length must be greater than zero.');
|
|
}
|
|
if (false !== strpbrk($tag, self::RESERVED_CHARACTERS)) {
|
|
throw new InvalidArgumentException(sprintf('Cache tag "%s" contains reserved characters "%s".', $tag, self::RESERVED_CHARACTERS));
|
|
}
|
|
$this->newMetadata[self::METADATA_TAGS][$tag] = $tag;
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function getMetadata(): array
|
|
{
|
|
return $this->metadata;
|
|
}
|
|
|
|
/**
|
|
* Returns the list of tags bound to the value coming from the pool storage if any.
|
|
*
|
|
* @deprecated since Symfony 4.2, use the "getMetadata()" method instead.
|
|
*/
|
|
public function getPreviousTags(): array
|
|
{
|
|
@trigger_error(sprintf('The "%s()" method is deprecated since Symfony 4.2, use the "getMetadata()" method instead.', __METHOD__), \E_USER_DEPRECATED);
|
|
|
|
return $this->metadata[self::METADATA_TAGS] ?? [];
|
|
}
|
|
|
|
/**
|
|
* Validates a cache key according to PSR-6.
|
|
*
|
|
* @param mixed $key The key to validate
|
|
*
|
|
* @throws InvalidArgumentException When $key is not valid
|
|
*/
|
|
public static function validateKey($key): string
|
|
{
|
|
if (!\is_string($key)) {
|
|
throw new InvalidArgumentException(sprintf('Cache key must be string, "%s" given.', \is_object($key) ? \get_class($key) : \gettype($key)));
|
|
}
|
|
if ('' === $key) {
|
|
throw new InvalidArgumentException('Cache key length must be greater than zero.');
|
|
}
|
|
if (false !== strpbrk($key, self::RESERVED_CHARACTERS)) {
|
|
throw new InvalidArgumentException(sprintf('Cache key "%s" contains reserved characters "%s".', $key, self::RESERVED_CHARACTERS));
|
|
}
|
|
|
|
return $key;
|
|
}
|
|
|
|
/**
|
|
* Internal logging helper.
|
|
*
|
|
* @internal
|
|
*/
|
|
public static function log(?LoggerInterface $logger, string $message, array $context = [])
|
|
{
|
|
if ($logger) {
|
|
$logger->warning($message, $context);
|
|
} else {
|
|
$replace = [];
|
|
foreach ($context as $k => $v) {
|
|
if (\is_scalar($v)) {
|
|
$replace['{'.$k.'}'] = $v;
|
|
}
|
|
}
|
|
@trigger_error(strtr($message, $replace), \E_USER_WARNING);
|
|
}
|
|
}
|
|
}
|