2016-01-18 14:59:30 +00:00
< ? 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 ;
2016-01-25 19:16:47 +00:00
use Psr\Log\LoggerInterface ;
2016-01-18 14:59:30 +00:00
use Symfony\Component\Cache\Exception\InvalidArgumentException ;
/**
* @ author Nicolas Grekas < p @ tchwork . com >
*/
final class CacheItem implements CacheItemInterface
{
2016-06-13 15:28:45 +01:00
protected $key ;
protected $value ;
protected $isHit ;
protected $expiry ;
protected $defaultLifetime ;
protected $innerItem ;
protected $poolHash ;
2016-01-18 14:59:30 +00:00
/**
* { @ 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 ) {
2016-02-03 09:28:28 +00:00
$this -> expiry = $this -> defaultLifetime > 0 ? time () + $this -> defaultLifetime : null ;
2016-01-18 14:59:30 +00:00
} elseif ( $expiration instanceof \DateTimeInterface ) {
2016-04-17 12:41:09 +01:00
$this -> expiry = ( int ) $expiration -> format ( 'U' );
2016-01-18 14:59:30 +00:00
} 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 ) {
2016-02-03 09:28:28 +00:00
$this -> expiry = $this -> defaultLifetime > 0 ? time () + $this -> defaultLifetime : null ;
2016-01-18 14:59:30 +00:00
} elseif ( $time instanceof \DateInterval ) {
2016-04-17 12:41:09 +01:00
$this -> expiry = ( int ) \DateTime :: createFromFormat ( 'U' , time ()) -> add ( $time ) -> format ( 'U' );
2016-01-18 14:59:30 +00:00
} elseif ( is_int ( $time )) {
2016-02-03 09:28:28 +00:00
$this -> expiry = $time + time ();
2016-01-18 14:59:30 +00:00
} 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 ;
}
2016-01-25 19:16:47 +00:00
2016-04-20 10:13:42 +01:00
/**
* Validates a cache key according to PSR - 6.
*
* @ param string $key The key to validate .
*
* @ 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 ( isset ( $key [ strcspn ( $key , '{}()/\@:' )])) {
2016-04-27 07:45:20 +01:00
throw new InvalidArgumentException ( sprintf ( 'Cache key "%s" contains reserved characters {}()/\@:' , $key ));
2016-04-20 10:13:42 +01:00
}
}
2016-01-25 19:16:47 +00:00
/**
* Internal logging helper .
*
* @ internal
*/
2016-02-02 15:39:10 +00:00
public static function log ( LoggerInterface $logger = null , $message , $context = array ())
2016-01-25 19:16:47 +00:00
{
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 );
}
}
2016-01-18 14:59:30 +00:00
}