mirror of
https://github.com/kamilwylegala/cakephp2-php8.git
synced 2024-11-16 03:48:24 +00:00
70d334f7eb
This makes the cache configurations cake uses internally more transparent, and easier for the end developer to configure. Fixes #1586
365 lines
No EOL
11 KiB
PHP
365 lines
No EOL
11 KiB
PHP
<?php
|
|
/**
|
|
* Configure class
|
|
*
|
|
* PHP 5
|
|
*
|
|
* CakePHP(tm) : Rapid Development Framework (http://cakephp.org)
|
|
* Copyright 2005-2010, Cake Software Foundation, Inc. (http://cakefoundation.org)
|
|
*
|
|
* Licensed under The MIT License
|
|
* Redistributions of files must retain the above copyright notice.
|
|
*
|
|
* @copyright Copyright 2005-2010, Cake Software Foundation, Inc. (http://cakefoundation.org)
|
|
* @link http://cakephp.org CakePHP(tm) Project
|
|
* @package cake.libs
|
|
* @since CakePHP(tm) v 1.0.0.2363
|
|
* @license MIT License (http://www.opensource.org/licenses/mit-license.php)
|
|
*/
|
|
|
|
/**
|
|
* Configuration class. Used for managing runtime configuration information.
|
|
*
|
|
* Provides features for reading and writing to the runtime configuration, as well
|
|
* as methods for loading additional configuration files or storing runtime configuration
|
|
* for future use.
|
|
*
|
|
* @package cake.libs
|
|
* @link http://book.cakephp.org/view/924/The-Configuration-Class
|
|
*/
|
|
class Configure {
|
|
|
|
/**
|
|
* Array of values currently stored in Configure.
|
|
*
|
|
* @var array
|
|
*/
|
|
protected static $_values = array(
|
|
'debug' => 0
|
|
);
|
|
|
|
/**
|
|
* Configured reader classes, used to load config files from resources
|
|
*
|
|
* @var array
|
|
* @see Configure::load()
|
|
*/
|
|
protected static $_readers = array();
|
|
|
|
/**
|
|
* Initializes configure and runs the bootstrap process.
|
|
* Bootstrapping includes the following steps:
|
|
*
|
|
* - Setup App array in Configure.
|
|
* - Include app/config/core.php.
|
|
* - Configure core cache configurations.
|
|
* - Load App cache files.
|
|
* - Include app/config/bootstrap.php.
|
|
* - Setup error/exception handlers.
|
|
*
|
|
* @return void
|
|
*/
|
|
public static function bootstrap($boot = true) {
|
|
if ($boot) {
|
|
self::write('App', array(
|
|
'base' => false,
|
|
'baseUrl' => false,
|
|
'dir' => APP_DIR,
|
|
'webroot' => WEBROOT_DIR,
|
|
'www_root' => WWW_ROOT
|
|
));
|
|
|
|
if (!include(CONFIGS . 'core.php')) {
|
|
trigger_error(__("Can't find application core file. Please create %score.php, and make sure it is readable by PHP.", CONFIGS), E_USER_ERROR);
|
|
}
|
|
|
|
App::init();
|
|
App::build();
|
|
if (!include(CONFIGS . 'bootstrap.php')) {
|
|
trigger_error(__("Can't find application bootstrap file. Please create %sbootstrap.php, and make sure it is readable by PHP.", CONFIGS), E_USER_ERROR);
|
|
}
|
|
$level = -1;
|
|
if (isset(self::$_values['Error']['level'])) {
|
|
error_reporting(self::$_values['Error']['level']);
|
|
$level = self::$_values['Error']['level'];
|
|
}
|
|
if (!empty(self::$_values['Error']['handler'])) {
|
|
set_error_handler(self::$_values['Error']['handler'], $level);
|
|
}
|
|
if (!empty(self::$_values['Exception']['handler'])) {
|
|
set_exception_handler(self::$_values['Exception']['handler']);
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Used to store a dynamic variable in Configure.
|
|
*
|
|
* Usage:
|
|
* {{{
|
|
* Configure::write('One.key1', 'value of the Configure::One[key1]');
|
|
* Configure::write(array('One.key1' => 'value of the Configure::One[key1]'));
|
|
* Configure::write('One', array(
|
|
* 'key1' => 'value of the Configure::One[key1]',
|
|
* 'key2' => 'value of the Configure::One[key2]'
|
|
* );
|
|
*
|
|
* Configure::write(array(
|
|
* 'One.key1' => 'value of the Configure::One[key1]',
|
|
* 'One.key2' => 'value of the Configure::One[key2]'
|
|
* ));
|
|
* }}}
|
|
*
|
|
* @link http://book.cakephp.org/view/926/write
|
|
* @param array $config Name of var to write
|
|
* @param mixed $value Value to set for var
|
|
* @return boolean True if write was successful
|
|
*/
|
|
public static function write($config, $value = null) {
|
|
if (!is_array($config)) {
|
|
$config = array($config => $value);
|
|
}
|
|
|
|
foreach ($config as $name => $value) {
|
|
if (strpos($name, '.') === false) {
|
|
self::$_values[$name] = $value;
|
|
} else {
|
|
$names = explode('.', $name, 4);
|
|
switch (count($names)) {
|
|
case 2:
|
|
self::$_values[$names[0]][$names[1]] = $value;
|
|
break;
|
|
case 3:
|
|
self::$_values[$names[0]][$names[1]][$names[2]] = $value;
|
|
break;
|
|
case 4:
|
|
$names = explode('.', $name, 2);
|
|
if (!isset(self::$_values[$names[0]])) {
|
|
self::$_values[$names[0]] = array();
|
|
}
|
|
self::$_values[$names[0]] = Set::insert(self::$_values[$names[0]], $names[1], $value);
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
if (isset($config['debug']) && function_exists('ini_set')) {
|
|
if (self::$_values['debug']) {
|
|
ini_set('display_errors', 1);
|
|
} else {
|
|
ini_set('display_errors', 0);
|
|
}
|
|
}
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Used to read information stored in Configure. Its not
|
|
* possible to store `null` values in Configure.
|
|
*
|
|
* Usage:
|
|
* {{{
|
|
* Configure::read('Name'); will return all values for Name
|
|
* Configure::read('Name.key'); will return only the value of Configure::Name[key]
|
|
* }}}
|
|
*
|
|
* @link http://book.cakephp.org/view/927/read
|
|
* @param string $var Variable to obtain. Use '.' to access array elements.
|
|
* @return mixed value stored in configure, or null.
|
|
*/
|
|
public static function read($var = null) {
|
|
if ($var === null) {
|
|
return self::$_values;
|
|
}
|
|
if (isset(self::$_values[$var])) {
|
|
return self::$_values[$var];
|
|
}
|
|
if (strpos($var, '.') !== false) {
|
|
$names = explode('.', $var, 3);
|
|
$var = $names[0];
|
|
}
|
|
if (!isset(self::$_values[$var])) {
|
|
return null;
|
|
}
|
|
switch (count($names)) {
|
|
case 2:
|
|
if (isset(self::$_values[$var][$names[1]])) {
|
|
return self::$_values[$var][$names[1]];
|
|
}
|
|
break;
|
|
case 3:
|
|
if (isset(self::$_values[$var][$names[1]][$names[2]])) {
|
|
return self::$_values[$var][$names[1]][$names[2]];
|
|
}
|
|
if (!isset(self::$_values[$var][$names[1]])) {
|
|
return null;
|
|
}
|
|
return Set::classicExtract(self::$_values[$var][$names[1]], $names[2]);
|
|
break;
|
|
}
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* Used to delete a variable from Configure.
|
|
*
|
|
* Usage:
|
|
* {{{
|
|
* Configure::delete('Name'); will delete the entire Configure::Name
|
|
* Configure::delete('Name.key'); will delete only the Configure::Name[key]
|
|
* }}}
|
|
*
|
|
* @link http://book.cakephp.org/view/928/delete
|
|
* @param string $var the var to be deleted
|
|
* @return void
|
|
*/
|
|
public static function delete($var = null) {
|
|
if (strpos($var, '.') === false) {
|
|
unset(self::$_values[$var]);
|
|
return;
|
|
}
|
|
|
|
$names = explode('.', $var, 2);
|
|
self::$_values[$names[0]] = Set::remove(self::$_values[$names[0]], $names[1]);
|
|
}
|
|
|
|
/**
|
|
* Add a new reader to Configure. Readers allow you to read configuration
|
|
* files in various formats/storage locations. CakePHP comes with two built-in readers
|
|
* PhpReader and IniReader. You can also implement your own reader classes in your application.
|
|
*
|
|
* To add a new reader to Configure:
|
|
*
|
|
* `Configure::config('ini', new IniReader());`
|
|
*
|
|
* @param string $name The name of the reader being configured. This alias is used later to
|
|
* read values from a specific reader.
|
|
* @param ConfigReaderInterface $reader The reader to append.
|
|
* @return void
|
|
*/
|
|
public static function config($name, ConfigReaderInterface $reader) {
|
|
self::$_readers[$name] = $reader;
|
|
}
|
|
|
|
/**
|
|
* Gets the names of the configured reader objects.
|
|
*
|
|
* @return array Array of the configured reader objects.
|
|
*/
|
|
public static function configured($name = null) {
|
|
if ($name) {
|
|
return isset(self::$_readers[$name]);
|
|
}
|
|
return array_keys(self::$_readers);
|
|
}
|
|
|
|
/**
|
|
* Remove a configured reader. This will unset the reader
|
|
* and make any future attempts to use it cause an Exception.
|
|
*
|
|
* @param string $name Name of the reader to drop.
|
|
* @return boolean Success
|
|
*/
|
|
public static function drop($name) {
|
|
if (!isset(self::$_readers[$name])) {
|
|
return false;
|
|
}
|
|
unset(self::$_readers[$name]);
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Loads stored configuration information from a resource. You can add
|
|
* config file resource readers with `Configure::config()`.
|
|
*
|
|
* Loaded configuration infomration will be merged with the current
|
|
* runtime configuration. You can load configuration files from plugins
|
|
* by preceeding the filename with the plugin name.
|
|
*
|
|
* `Configure::load('Users.user', 'default')`
|
|
*
|
|
* Would load the 'user' config file using the default config reader. You can load
|
|
* app config files by giving the name of the resource you want loaded.
|
|
*
|
|
* `Configure::load('setup', 'default');`
|
|
*
|
|
* @link http://book.cakephp.org/view/929/load
|
|
* @param string $key name of configuration resource to load.
|
|
* @param string $config Name of the configured reader to use to read the resource identfied by $key.
|
|
* @return mixed false if file not found, void if load successful.
|
|
* @throws ConfigureException Will throw any exceptions the reader raises.
|
|
*/
|
|
public static function load($key, $config = 'default') {
|
|
if (!isset(self::$_readers[$config])) {
|
|
return false;
|
|
}
|
|
$values = self::$_readers[$config]->read($key);
|
|
return self::write($values);
|
|
}
|
|
|
|
/**
|
|
* Used to determine the current version of CakePHP.
|
|
*
|
|
* Usage `Configure::version();`
|
|
*
|
|
* @link http://book.cakephp.org/view/930/version
|
|
* @return string Current version of CakePHP
|
|
*/
|
|
public static function version() {
|
|
if (!isset(self::$_values['Cake']['version'])) {
|
|
require(CORE_PATH . 'cake' . DS . 'config' . DS . 'config.php');
|
|
self::write($config);
|
|
}
|
|
return self::$_values['Cake']['version'];
|
|
}
|
|
|
|
/**
|
|
* Used to write runtime configuration into Cache. Stored runtime configuration can be
|
|
* restored using `Configure::restore()`. These methods can be used to enable configuration managers
|
|
* frontends, or other GUI type interfaces for configuration.
|
|
*
|
|
* @param string $name The storage name for the saved configuration.
|
|
* @param string $cacheConfig The cache configuration to save into. Defaults to 'default'
|
|
* @param array $data Either an array of data to store, or leave empty to store all values.
|
|
* @return boolean Success
|
|
*/
|
|
public static function store($name, $cacheConfig = 'default', $data = null) {
|
|
if ($data === null) {
|
|
$data = self::$_values;
|
|
}
|
|
return Cache::write($name, $data, $cacheConfig);
|
|
}
|
|
|
|
/**
|
|
* Restores configuration data stored in the Cache into configure. Restored
|
|
* values will overwrite existing ones.
|
|
*
|
|
* @param string $name Name of the stored config file to load.
|
|
* @param string $cacheConfig Name of the Cache configuration to read from.
|
|
* @return boolean Success.
|
|
*/
|
|
public static function restore($name, $cacheConfig = 'default') {
|
|
$values = Cache::read($name, $cacheConfig);
|
|
if ($values) {
|
|
return self::write($values);
|
|
}
|
|
return false;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* An interface for creating objects compatible with Configure::load()
|
|
*
|
|
* @package cake.libs
|
|
*/
|
|
interface ConfigReaderInterface {
|
|
/**
|
|
* Read method is used for reading configuration information from sources.
|
|
* These sources can either be static resources like files, or dynamic ones like
|
|
* a database, or other datasource.
|
|
*
|
|
* @param string $key
|
|
* @return array An array of data to merge into the runtime configuration
|
|
*/
|
|
function read($key);
|
|
} |