/**
* Removes the specified item from the cache.
* @param string key
* @return void
* @throws InvalidArgumentException
*/
public function offsetUnset($key)
{
if (!is_string($key) && !is_int($key)) {
throw new InvalidArgumentException("Cache key name must be string or integer, " . gettype($key) . " given.");
}
$this->key = $this->data = NULL;
$this->storage->remove($this->namespace . self::NAMESPACE_SEPARATOR . $key);
}
/**
* Removes the specified item from the cache.
* @param string key
* @return void
* @throws InvalidArgumentException
*/
public function offsetUnset($key)
{
if (!is_string($key)) {
throw new InvalidArgumentException("Cache key name must be string, " . gettype($key) . " given.");
}
$this->key = $this->data = NULL;
$this->storage->remove($this->namespace . $key);
}
/**
* Writes item into the cache.
* Dependencies are:
* - Cache::PRIORITY => (int) priority
* - Cache::EXPIRE => (timestamp) expiration
* - Cache::SLIDING => (bool) use sliding expiration?
* - Cache::TAGS => (array) tags
* - Cache::FILES => (array|string) file names
* - Cache::ITEMS => (array|string) cache items
* - Cache::CONSTS => (array|string) cache items
*
* @param string key
* @param mixed value
* @param array dependencies
* @return mixed value itself
* @throws InvalidArgumentException
*/
public function save($key, $data, array $dp = NULL)
{
if (!is_string($key) && !is_int($key)) {
throw new InvalidArgumentException("Cache key name must be string or integer, " . gettype($key) . " given.");
}
$this->key = (string) $key;
$key = $this->namespace . self::NAMESPACE_SEPARATOR . $key;
// convert expire into relative amount of seconds
if (!empty($dp[Cache::EXPIRE])) {
$dp[Cache::EXPIRE] = Tools::createDateTime($dp[Cache::EXPIRE])->format('U') - time();
}
// convert FILES into CALLBACKS
if (isset($dp[self::FILES])) {
//clearstatcache();
foreach ((array) $dp[self::FILES] as $item) {
$dp[self::CALLBACKS][] = array(array(__CLASS__, 'checkFile'), $item, @filemtime($item));
// intentionally @
}
unset($dp[self::FILES]);
}
// add namespaces to items
if (isset($dp[self::ITEMS])) {
$dp[self::ITEMS] = (array) $dp[self::ITEMS];
foreach ($dp[self::ITEMS] as $k => $item) {
$dp[self::ITEMS][$k] = $this->namespace . self::NAMESPACE_SEPARATOR . $item;
}
}
// convert CONSTS into CALLBACKS
if (isset($dp[self::CONSTS])) {
foreach ((array) $dp[self::CONSTS] as $item) {
$dp[self::CALLBACKS][] = array(array(__CLASS__, 'checkConst'), $item, constant($item));
}
unset($dp[self::CONSTS]);
}
if ($data instanceof Callback || $data instanceof Closure) {
Environment::enterCriticalSection('Nette\\Caching/' . $key);
$data = $data->__invoke();
Environment::leaveCriticalSection('Nette\\Caching/' . $key);
}
if (is_object($data)) {
$dp[self::CALLBACKS][] = array(array(__CLASS__, 'checkSerializationVersion'), get_class($data), ClassReflection::from($data)->getAnnotation('serializationVersion'));
}
$this->data = $data;
if ($data === NULL) {
$this->storage->remove($key);
} else {
$this->storage->write($key, $data, (array) $dp);
}
return $data;
}
/**
* Writes item into the cache.
* Dependencies are:
* - Cache::PRIORITY => (int) priority
* - Cache::EXPIRATION => (timestamp) expiration
* - Cache::SLIDING => (bool) use sliding expiration?
* - Cache::TAGS => (array) tags
* - Cache::FILES => (array|string) file names
* - Cache::ITEMS => (array|string) cache items
* - Cache::CONSTS => (array|string) cache items
*
* @param mixed key
* @param mixed value
* @param array dependencies
* @return mixed value itself
* @throws InvalidArgumentException
*/
public function save($key, $data, array $dp = NULL)
{
$this->release();
$key = $this->generateKey($key);
if ($data instanceof Callback || $data instanceof Closure) {
$this->storage->lock($key);
$data = Callback::create($data)->invokeArgs(array(&$dp));
}
if ($data === NULL) {
$this->storage->remove($key);
} else {
$this->storage->write($key, $data, $this->completeDependencies($dp, $data));
return $data;
}
}
/**
* Writes item into the cache.
* Dependencies are:
* - NCache::PRIORITY => (int) priority
* - NCache::EXPIRATION => (timestamp) expiration
* - NCache::SLIDING => (bool) use sliding expiration?
* - NCache::TAGS => (array) tags
* - NCache::FILES => (array|string) file names
* - NCache::ITEMS => (array|string) cache items
* - NCache::CONSTS => (array|string) cache items
*
* @param mixed key
* @param mixed value
* @param array dependencies
* @return mixed value itself
* @throws InvalidArgumentException
*/
public function save($key, $data, array $dp = NULL)
{
$this->release();
$key = $this->namespace . md5(is_scalar($key) ? $key : serialize($key));
if ($data instanceof NCallback || $data instanceof Closure) {
$this->storage->lock($key);
$data = callback($data)->invokeArgs(array(&$dp));
}
if ($data === NULL) {
$this->storage->remove($key);
} else {
$this->storage->write($key, $data, $this->completeDependencies($dp, $data));
return $data;
}
}
