forked from friendica/friendica-addons
Hypolite Petovan
b0ee9fdf2a
- 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)
66 lines
1.7 KiB
PHP
66 lines
1.7 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\Contracts\Cache;
|
|
|
|
use Psr\Cache\CacheException;
|
|
use Psr\Cache\CacheItemInterface;
|
|
use Psr\Cache\InvalidArgumentException;
|
|
|
|
/**
|
|
* Augments PSR-6's CacheItemInterface with support for tags and metadata.
|
|
*
|
|
* @author Nicolas Grekas <p@tchwork.com>
|
|
*/
|
|
interface ItemInterface extends CacheItemInterface
|
|
{
|
|
/**
|
|
* References the Unix timestamp stating when the item will expire.
|
|
*/
|
|
public const METADATA_EXPIRY = 'expiry';
|
|
|
|
/**
|
|
* References the time the item took to be created, in milliseconds.
|
|
*/
|
|
public const METADATA_CTIME = 'ctime';
|
|
|
|
/**
|
|
* References the list of tags that were assigned to the item, as string[].
|
|
*/
|
|
public const METADATA_TAGS = 'tags';
|
|
|
|
/**
|
|
* Reserved characters that cannot be used in a key or tag.
|
|
*/
|
|
public const RESERVED_CHARACTERS = '{}()/\@:';
|
|
|
|
/**
|
|
* Adds a tag to a cache item.
|
|
*
|
|
* Tags are strings that follow the same validation rules as keys.
|
|
*
|
|
* @param string|string[] $tags A tag or array of tags
|
|
*
|
|
* @return $this
|
|
*
|
|
* @throws InvalidArgumentException When $tag is not valid
|
|
* @throws CacheException When the item comes from a pool that is not tag-aware
|
|
*/
|
|
public function tag($tags): self;
|
|
|
|
/**
|
|
* Returns a list of metadata info that were saved alongside with the cached value.
|
|
*
|
|
* See ItemInterface::METADATA_* consts for keys potentially found in the returned array.
|
|
*/
|
|
public function getMetadata(): array;
|
|
}
|