banker/src/Item.php

213 lines
4.6 KiB
PHP
Raw Normal View History

2016-08-31 12:18:46 -04:00
<?php
/**
2016-09-05 16:43:37 -04:00
* Banker
2016-08-31 12:18:46 -04:00
*
* A Caching library implementing psr/cache
*
* PHP version 5.6
*
2016-09-05 16:43:37 -04:00
* @package Banker
2016-08-31 12:18:46 -04:00
* @author Timothy J. Warren <tim@timshomepage.net>
* @copyright 2016 Timothy J. Warren
* @license http://www.opensource.org/licenses/mit-license.html MIT License
* @version 1.0.0
2016-09-05 16:43:37 -04:00
* @link https://git.timshomepage.net/timw4mail/banker
2016-08-31 12:18:46 -04:00
*/
2016-09-05 16:43:37 -04:00
namespace Aviat\Banker;
2016-08-31 12:18:46 -04:00
use Psr\Cache\CacheItemInterface;
2016-09-05 16:43:37 -04:00
use Aviat\Banker\Driver\DriverInterface;
2016-08-31 12:18:46 -04:00
/**
* Base class for Cache items
*/
2016-09-05 16:43:37 -04:00
class Item implements CacheItemInterface {
/**
* The driver for the current cache backend
*
* @var DriverInterface
*/
protected $driver;
/**
* The key of the cache item
*
* @var string
*/
protected $key;
/**
* The expiration time
*
* @var int | null
*/
protected $expiresAt = NULL;
/**
* The time to live
*
* @var int | null
*/
protected $ttl = NULL;
/**
* The value to save in the cache
*
* @var mixed
*/
protected $value;
/**
* Create a Cache Item object
*
* @param DriverInterface $driver
* @param string $key
*/
public function __construct(DriverInterface $driver, $key)
{
$this->driver = $driver;
$this->key = $key;
}
2016-08-31 12:18:46 -04:00
/**
* Returns the key for the current cache item.
*
* The key is loaded by the Implementing Library, but should be available to
* the higher level callers when needed.
*
* @return string
* The key string for this cache item.
*/
public function getKey()
{
2016-09-05 16:43:37 -04:00
return $this->key;
2016-08-31 12:18:46 -04:00
}
/**
* Retrieves the value of the item from the cache associated with this object's key.
*
* The value returned must be identical to the value originally stored by set().
*
* If isHit() returns false, this method MUST return null. Note that null
* is a legitimate cached value, so the isHit() method SHOULD be used to
* differentiate between "null value was found" and "no value was found."
*
* @return mixed
* The value corresponding to this cache item's key, or null if not found.
*/
public function get()
{
2016-09-06 17:03:43 -04:00
if ($this->isHit())
{
return $this->driver->get($this->key);
}
2016-09-06 20:26:28 -04:00
2016-09-06 17:03:43 -04:00
return NULL;
2016-08-31 12:18:46 -04:00
}
/**
* Confirms if the cache item lookup resulted in a cache hit.
*
* Note: This method MUST NOT have a race condition between calling isHit()
* and calling get().
*
* @return bool
* True if the request resulted in a cache hit. False otherwise.
*/
public function isHit()
{
2016-09-05 16:43:37 -04:00
return $this->driver->exists($this->key);
2016-08-31 12:18:46 -04:00
}
/**
* Sets the value represented by this cache item.
*
* The $value argument may be any item that can be serialized by PHP,
* although the method of serialization is left up to the Implementing
* Library.
*
* @param mixed $value
* The serializable value to be stored.
*
* @return static
* The invoked object.
*/
public function set($value)
{
2016-09-05 16:43:37 -04:00
$this->value = $value;
return $this;
2016-08-31 12:18:46 -04:00
}
/**
* Sets the expiration time for this cache item.
*
* @param \DateTimeInterface|null $expiration
* The point in time after which the item MUST be considered expired.
* If null is passed explicitly, a default value MAY be used. If none is set,
* the value should be stored permanently or for as long as the
* implementation allows.
*
* @return static
* The called object.
*/
2016-09-05 16:43:37 -04:00
public function expiresAt($expiration = NULL)
2016-08-31 12:18:46 -04:00
{
2016-09-06 20:26:28 -04:00
if ($expiration instanceof \DateTimeInterface)
2016-09-06 17:03:43 -04:00
{
2016-09-06 20:26:28 -04:00
$expiration = $expiration->getTimestamp();
2016-09-06 17:03:43 -04:00
}
2016-09-06 20:26:28 -04:00
$this->expiresAt = (int) $expiration;
2016-09-05 16:43:37 -04:00
return $this;
2016-08-31 12:18:46 -04:00
}
/**
* Sets the expiration time for this cache item.
*
* @param int|\DateInterval|null $time
* The period of time from the present after which the item MUST be considered
* expired. An integer parameter is understood to be the time in seconds until
* expiration. If null is passed explicitly, a default value MAY be used.
* If none is set, the value should be stored permanently or for as long as the
* implementation allows.
*
* @return static
* The called object.
*/
2016-09-06 20:26:28 -04:00
public function expiresAfter($time = NULL)
2016-08-31 12:18:46 -04:00
{
2016-09-06 17:03:43 -04:00
if ($time instanceof \DateInterval)
{
$time = $time->format("%s");
}
2016-09-06 20:26:28 -04:00
2016-09-06 17:03:43 -04:00
$this->ttl = (int) $time;
2016-09-05 16:43:37 -04:00
return $this;
2016-08-31 12:18:46 -04:00
}
2016-09-06 20:26:28 -04:00
2016-09-06 17:03:43 -04:00
/**
2016-09-06 20:26:28 -04:00
* Save the current value to the cache
2016-09-06 17:03:43 -04:00
*
* @return bool
*/
public function save()
{
if ($this->expiresAt !== NULL && $this->expiresAt !== 0)
{
$setResult = $this->driver->set($this->key, $this->value);
$expResult = $this->driver->expiresAt($this->key, $this->expiresAt);
2016-09-06 20:26:28 -04:00
2016-09-06 17:03:43 -04:00
return $setResult && $expResult;
}
else if ($this->ttl !== NULL && $this->ttl !== 0)
{
2016-09-06 20:26:28 -04:00
return (bool) $this->driver->set($this->key, $this->value, $this->ttl);
2016-09-06 17:03:43 -04:00
}
2016-09-06 20:26:28 -04:00
return (bool) $this->driver->set($this->key, $this->value);
2016-09-06 17:03:43 -04:00
}
2016-08-31 12:18:46 -04:00
}