2017-11-09 11:05:18 -05:00
|
|
|
<?php
|
|
|
|
/**
|
|
|
|
* @file src/Core/Cache.php
|
|
|
|
*/
|
|
|
|
namespace Friendica\Core;
|
|
|
|
|
2019-08-03 14:48:56 -04:00
|
|
|
use Friendica\BaseObject;
|
2019-08-04 04:26:53 -04:00
|
|
|
use Friendica\Core\Cache\ICache;
|
2017-12-17 15:24:57 -05:00
|
|
|
|
2017-11-09 11:05:18 -05:00
|
|
|
/**
|
|
|
|
* @brief Class for storing data for a short time
|
|
|
|
*/
|
2019-08-03 14:48:56 -04:00
|
|
|
class Cache extends BaseObject
|
2017-11-09 11:05:18 -05:00
|
|
|
{
|
2019-08-04 04:26:53 -04:00
|
|
|
/** @deprecated Use ICache::MONTH */
|
|
|
|
const MONTH = ICache::MONTH;
|
|
|
|
/** @deprecated Use ICache::WEEK */
|
|
|
|
const WEEK = ICache::WEEK;
|
|
|
|
/** @deprecated Use ICache::DAY */
|
|
|
|
const DAY = ICache::DAY;
|
|
|
|
/** @deprecated Use ICache::HOUR */
|
|
|
|
const HOUR = ICache::HOUR;
|
|
|
|
/** @deprecated Use ICache::HALF_HOUR */
|
|
|
|
const HALF_HOUR = ICache::HALF_HOUR;
|
|
|
|
/** @deprecated Use ICache::QUARTER_HOUR */
|
|
|
|
const QUARTER_HOUR = ICache::QUARTER_HOUR;
|
|
|
|
/** @deprecated Use ICache::FIVE_MINUTES */
|
|
|
|
const FIVE_MINUTES = ICache::FIVE_MINUTES;
|
|
|
|
/** @deprecated Use ICache::MINUTE */
|
|
|
|
const MINUTE = ICache::MINUTE;
|
|
|
|
/** @deprecated Use ICache::INFINITE */
|
|
|
|
const INFINITE = ICache::INFINITE;
|
2018-02-28 23:48:09 -05:00
|
|
|
|
2018-09-25 22:52:32 -04:00
|
|
|
/**
|
|
|
|
* @brief Returns all the cache keys sorted alphabetically
|
|
|
|
*
|
2018-10-06 18:27:54 -04:00
|
|
|
* @param string $prefix Prefix of the keys (optional)
|
|
|
|
*
|
2018-10-07 16:14:05 -04:00
|
|
|
* @return array Empty if the driver doesn't support this feature
|
2019-01-06 16:06:53 -05:00
|
|
|
* @throws \Exception
|
2018-09-25 22:52:32 -04:00
|
|
|
*/
|
2018-10-06 18:27:54 -04:00
|
|
|
public static function getAllKeys($prefix = null)
|
2018-09-25 22:52:32 -04:00
|
|
|
{
|
2019-08-04 04:26:53 -04:00
|
|
|
return self::getClass(ICache::class)->getAllKeys($prefix);
|
2018-09-25 22:52:32 -04:00
|
|
|
}
|
|
|
|
|
2017-11-09 11:05:18 -05:00
|
|
|
/**
|
|
|
|
* @brief Fetch cached data according to the key
|
|
|
|
*
|
|
|
|
* @param string $key The key to the cached data
|
|
|
|
*
|
|
|
|
* @return mixed Cached $value or "null" if not found
|
2019-01-06 16:06:53 -05:00
|
|
|
* @throws \Exception
|
2017-11-09 11:05:18 -05:00
|
|
|
*/
|
|
|
|
public static function get($key)
|
|
|
|
{
|
2019-08-04 04:26:53 -04:00
|
|
|
return self::getClass(ICache::class)->get($key);
|
2017-11-09 11:05:18 -05:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Put data in the cache according to the key
|
|
|
|
*
|
|
|
|
* The input $value can have multiple formats.
|
|
|
|
*
|
|
|
|
* @param string $key The key to the cached data
|
|
|
|
* @param mixed $value The value that is about to be stored
|
|
|
|
* @param integer $duration The cache lifespan
|
2017-11-19 14:15:25 -05:00
|
|
|
*
|
2018-02-28 23:48:09 -05:00
|
|
|
* @return bool
|
2019-01-06 16:06:53 -05:00
|
|
|
* @throws \Exception
|
2017-11-09 11:05:18 -05:00
|
|
|
*/
|
2019-08-04 04:26:53 -04:00
|
|
|
public static function set($key, $value, $duration = ICache::MONTH)
|
2017-11-09 11:05:18 -05:00
|
|
|
{
|
2019-08-04 04:26:53 -04:00
|
|
|
return self::getClass(ICache::class)->set($key, $value, $duration);
|
2017-11-09 11:05:18 -05:00
|
|
|
}
|
|
|
|
|
2018-03-16 21:57:58 -04:00
|
|
|
/**
|
|
|
|
* @brief Delete a value from the cache
|
|
|
|
*
|
|
|
|
* @param string $key The key to the cached data
|
|
|
|
*
|
|
|
|
* @return bool
|
2019-01-06 16:06:53 -05:00
|
|
|
* @throws \Exception
|
2018-03-16 21:57:58 -04:00
|
|
|
*/
|
|
|
|
public static function delete($key)
|
|
|
|
{
|
2019-08-04 04:26:53 -04:00
|
|
|
return self::getClass(ICache::class)->delete($key);
|
2018-03-16 21:57:58 -04:00
|
|
|
}
|
|
|
|
|
2017-11-09 11:05:18 -05:00
|
|
|
/**
|
|
|
|
* @brief Remove outdated data from the cache
|
|
|
|
*
|
2018-09-25 22:46:45 -04:00
|
|
|
* @param boolean $outdated just remove outdated values
|
2017-11-19 14:15:25 -05:00
|
|
|
*
|
2019-01-06 16:06:53 -05:00
|
|
|
* @return bool
|
2019-08-03 14:48:56 -04:00
|
|
|
* @throws \Exception
|
2017-11-09 11:05:18 -05:00
|
|
|
*/
|
2018-09-25 22:46:45 -04:00
|
|
|
public static function clear($outdated = true)
|
2017-11-09 11:05:18 -05:00
|
|
|
{
|
2019-08-04 04:26:53 -04:00
|
|
|
return self::getClass(ICache::class)->clear($outdated);
|
2017-11-09 11:05:18 -05:00
|
|
|
}
|
|
|
|
}
|