2017-11-09 17:05:18 +01:00
|
|
|
<?php
|
|
|
|
/**
|
|
|
|
* @file src/Core/Cache.php
|
|
|
|
*/
|
|
|
|
namespace Friendica\Core;
|
|
|
|
|
2019-08-03 20:48:56 +02:00
|
|
|
use Friendica\BaseObject;
|
|
|
|
use Friendica\Core\Cache\ICacheDriver;
|
2017-12-17 21:24:57 +01:00
|
|
|
|
2017-11-09 17:05:18 +01:00
|
|
|
/**
|
|
|
|
* @brief Class for storing data for a short time
|
|
|
|
*/
|
2019-08-03 20:48:56 +02:00
|
|
|
class Cache extends BaseObject
|
2017-11-09 17:05:18 +01:00
|
|
|
{
|
2019-08-03 20:48:56 +02:00
|
|
|
/** @deprecated Use ICacheDriver::MONTH */
|
|
|
|
const MONTH = ICacheDriver::MONTH;
|
|
|
|
/** @deprecated Use ICacheDriver::WEEK */
|
2018-03-07 03:34:00 +01:00
|
|
|
const WEEK = 604800;
|
2019-08-03 20:48:56 +02:00
|
|
|
/** @deprecated Use ICacheDriver::DAY */
|
2018-03-07 03:34:00 +01:00
|
|
|
const DAY = 86400;
|
2019-08-03 20:48:56 +02:00
|
|
|
/** @deprecated Use ICacheDriver::HOUR */
|
2018-03-07 03:34:00 +01:00
|
|
|
const HOUR = 3600;
|
2019-08-03 20:48:56 +02:00
|
|
|
/** @deprecated Use ICacheDriver::HALF_HOUR */
|
2018-03-07 03:34:00 +01:00
|
|
|
const HALF_HOUR = 1800;
|
2019-08-03 20:48:56 +02:00
|
|
|
/** @deprecated Use ICacheDriver::QUARTER_HOUR */
|
2018-03-07 03:34:00 +01:00
|
|
|
const QUARTER_HOUR = 900;
|
2019-08-03 20:48:56 +02:00
|
|
|
/** @deprecated Use ICacheDriver::FIVE_MINUTES */
|
2018-03-07 03:34:00 +01:00
|
|
|
const FIVE_MINUTES = 300;
|
2019-08-03 20:48:56 +02:00
|
|
|
/** @deprecated Use ICacheDriver::MINUTE */
|
2018-03-07 03:34:00 +01:00
|
|
|
const MINUTE = 60;
|
2019-08-03 20:48:56 +02:00
|
|
|
/** @deprecated Use ICacheDriver::INFINITE */
|
2018-10-29 10:21:10 +01:00
|
|
|
const INFINITE = 0;
|
2018-03-01 05:48:09 +01:00
|
|
|
|
2018-09-26 04:52:32 +02:00
|
|
|
/**
|
|
|
|
* @brief Returns all the cache keys sorted alphabetically
|
|
|
|
*
|
2018-10-07 00:27:54 +02:00
|
|
|
* @param string $prefix Prefix of the keys (optional)
|
|
|
|
*
|
2018-10-07 22:14:05 +02:00
|
|
|
* @return array Empty if the driver doesn't support this feature
|
2019-01-06 22:06:53 +01:00
|
|
|
* @throws \Exception
|
2018-09-26 04:52:32 +02:00
|
|
|
*/
|
2018-10-07 00:27:54 +02:00
|
|
|
public static function getAllKeys($prefix = null)
|
2018-09-26 04:52:32 +02:00
|
|
|
{
|
2019-08-03 20:48:56 +02:00
|
|
|
return self::getClass(ICacheDriver::class)->getAllKeys($prefix);
|
2018-09-26 04:52:32 +02:00
|
|
|
}
|
|
|
|
|
2017-11-09 17:05:18 +01: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 22:06:53 +01:00
|
|
|
* @throws \Exception
|
2017-11-09 17:05:18 +01:00
|
|
|
*/
|
|
|
|
public static function get($key)
|
|
|
|
{
|
2019-08-03 20:48:56 +02:00
|
|
|
return self::getClass(ICacheDriver::class)->get($key);
|
2017-11-09 17:05:18 +01: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 20:15:25 +01:00
|
|
|
*
|
2018-03-01 05:48:09 +01:00
|
|
|
* @return bool
|
2019-01-06 22:06:53 +01:00
|
|
|
* @throws \Exception
|
2017-11-09 17:05:18 +01:00
|
|
|
*/
|
2019-08-03 20:48:56 +02:00
|
|
|
public static function set($key, $value, $duration = ICacheDriver::MONTH)
|
2017-11-09 17:05:18 +01:00
|
|
|
{
|
2019-08-03 20:48:56 +02:00
|
|
|
return self::getClass(ICacheDriver::class)->set($key, $value, $duration);
|
2017-11-09 17:05:18 +01:00
|
|
|
}
|
|
|
|
|
2018-03-17 02:57:58 +01:00
|
|
|
/**
|
|
|
|
* @brief Delete a value from the cache
|
|
|
|
*
|
|
|
|
* @param string $key The key to the cached data
|
|
|
|
*
|
|
|
|
* @return bool
|
2019-01-06 22:06:53 +01:00
|
|
|
* @throws \Exception
|
2018-03-17 02:57:58 +01:00
|
|
|
*/
|
|
|
|
public static function delete($key)
|
|
|
|
{
|
2019-08-03 20:48:56 +02:00
|
|
|
return self::getClass(ICacheDriver::class)->delete($key);
|
2018-03-17 02:57:58 +01:00
|
|
|
}
|
|
|
|
|
2017-11-09 17:05:18 +01:00
|
|
|
/**
|
|
|
|
* @brief Remove outdated data from the cache
|
|
|
|
*
|
2018-09-26 04:46:45 +02:00
|
|
|
* @param boolean $outdated just remove outdated values
|
2017-11-19 20:15:25 +01:00
|
|
|
*
|
2019-01-06 22:06:53 +01:00
|
|
|
* @return bool
|
2019-08-03 20:48:56 +02:00
|
|
|
* @throws \Exception
|
2017-11-09 17:05:18 +01:00
|
|
|
*/
|
2018-09-26 04:46:45 +02:00
|
|
|
public static function clear($outdated = true)
|
2017-11-09 17:05:18 +01:00
|
|
|
{
|
2019-08-03 20:48:56 +02:00
|
|
|
return self::getClass(ICacheDriver::class)->clear($outdated);
|
2017-11-09 17:05:18 +01:00
|
|
|
}
|
|
|
|
}
|