Adding descriptions

This commit is contained in:
Philipp Holzer 2019-02-03 23:39:30 +01:00
parent f3da5b3a2f
commit bc73d4bd2b
No known key found for this signature in database
GPG key ID: 517BE60E2CE5C8A5
6 changed files with 41 additions and 18 deletions

View file

@ -8,9 +8,6 @@
*/ */
namespace Friendica\Core; namespace Friendica\Core;
use Friendica\Core\Config\IConfigAdapter;
use Friendica\Core\Config\IConfigCache;
/** /**
* @brief Arbitrary system configuration storage * @brief Arbitrary system configuration storage
* *
@ -21,19 +18,19 @@ use Friendica\Core\Config\IConfigCache;
class Config class Config
{ {
/** /**
* @var IConfigAdapter * @var Config\IConfigAdapter
*/ */
private static $adapter; private static $adapter;
/** /**
* @var IConfigCache * @var Config\IConfigCache
*/ */
private static $config; private static $config;
/** /**
* Initialize the config with only the cache * Initialize the config with only the cache
* *
* @param IConfigCache $config The configuration cache * @param Config\IConfigCache $config The configuration cache
*/ */
public static function init($config) public static function init($config)
{ {
@ -43,7 +40,7 @@ class Config
/** /**
* Add the adapter for DB-backend * Add the adapter for DB-backend
* *
* @param $adapter * @param Config\IConfigAdapter $adapter
*/ */
public static function setAdapter($adapter) public static function setAdapter($adapter)
{ {

View file

@ -2,6 +2,13 @@
namespace Friendica\Core\Config; namespace Friendica\Core\Config;
/**
* The Friendica config cache for the application
* Initial, all *.config.php files are loaded into this cache with the
* ConfigCacheLoader ( @see ConfigCacheLoader )
*
* Is used for further caching operations too (depending on the ConfigAdapter )
*/
class ConfigCache implements IConfigCache, IPConfigCache class ConfigCache implements IConfigCache, IPConfigCache
{ {
/** /**
@ -12,12 +19,15 @@ class ConfigCache implements IConfigCache, IPConfigCache
*/ */
public $config; public $config;
public function __construct($config = [], $overwrite = false) /**
* @param array $config A initial config array
*/
public function __construct($config = [])
{ {
$this->config = []; $this->config = [];
if (isset($config)) { if (isset($config)) {
$this->loadConfigArray($config, $overwrite); $this->loadConfigArray($config, true);
} }
} }

View file

@ -2,15 +2,29 @@
namespace Friendica\Core\Config; namespace Friendica\Core\Config;
/**
* The ConfigCacheLoader loads config-files and stores them in a ConfigCache ( @see ConfigCache )
*
* It is capable of loading the following config files:
* - *.config.php (current)
* - *.ini.php (deprecated)
* - *.htconfig.php (deprecated)
*/
class ConfigCacheLoader class ConfigCacheLoader
{ {
/**
* The Sub directory of the config-files
* @var string
*/
const SUBDIRECTORY = '/config/';
private $baseDir; private $baseDir;
private $configDir; private $configDir;
public function __construct($baseDir) public function __construct($baseDir)
{ {
$this->baseDir = $baseDir; $this->baseDir = $baseDir;
$this->configDir = $baseDir . '/config/'; $this->configDir = $baseDir . self::SUBDIRECTORY;
} }
/** /**

View file

@ -2,6 +2,9 @@
namespace Friendica\Core\Config; namespace Friendica\Core\Config;
/**
* The interface for a system-wide ConfigCache
*/
interface IConfigCache interface IConfigCache
{ {
/** /**

View file

@ -2,6 +2,9 @@
namespace Friendica\Core\Config; namespace Friendica\Core\Config;
/**
* The interface for a user-specific config cache
*/
interface IPConfigCache interface IPConfigCache
{ {
/** /**

View file

@ -8,8 +8,6 @@
*/ */
namespace Friendica\Core; namespace Friendica\Core;
use Friendica\Core\Config\IPConfigCache;
/** /**
* @brief Management of user configuration storage * @brief Management of user configuration storage
* Note: * Note:
@ -20,19 +18,19 @@ use Friendica\Core\Config\IPConfigCache;
class PConfig class PConfig
{ {
/** /**
* @var \Friendica\Core\Config\IPConfigAdapter * @var Config\IPConfigAdapter
*/ */
private static $adapter; private static $adapter;
/** /**
* @var IPConfigCache * @var Config\IPConfigCache
*/ */
private static $config; private static $config;
/** /**
* Initialize the config with only the cache * Initialize the config with only the cache
* *
* @param IPConfigCache $config The configuration cache * @param Config\IPConfigCache $config The configuration cache
*/ */
public static function init($config) public static function init($config)
{ {
@ -42,7 +40,7 @@ class PConfig
/** /**
* Add the adapter for DB-backend * Add the adapter for DB-backend
* *
* @param $adapter * @param Config\IPConfigAdapter $adapter
*/ */
public static function setAdapter($adapter) public static function setAdapter($adapter)
{ {
@ -59,7 +57,6 @@ class PConfig
* @param string $family The category of the configuration value * @param string $family The category of the configuration value
* *
* @return void * @return void
* @throws \Friendica\Network\HTTPException\InternalServerErrorException
*/ */
public static function load($uid, $family) public static function load($uid, $family)
{ {
@ -129,7 +126,6 @@ class PConfig
* @param string $key The configuration key to delete * @param string $key The configuration key to delete
* *
* @return mixed * @return mixed
* @throws \Friendica\Network\HTTPException\InternalServerErrorException
*/ */
public static function delete($uid, $family, $key) public static function delete($uid, $family, $key)
{ {