448 lines
13 KiB
PHP
448 lines
13 KiB
PHP
<?php
|
|
/**
|
|
* CakePHP(tm) : Rapid Development Framework (http://cakephp.org)
|
|
* Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
|
|
*
|
|
* Licensed under The MIT License
|
|
* For full copyright and license information, please see the LICENSE.txt
|
|
* Redistributions of files must retain the above copyright notice.
|
|
*
|
|
* @copyright Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
|
|
* @link http://cakephp.org CakePHP(tm) Project
|
|
* @package Cake.Core
|
|
* @since CakePHP(tm) v 1.0.0.2363
|
|
* @license http://www.opensource.org/licenses/mit-license.php MIT License
|
|
*/
|
|
|
|
App::uses('Hash', 'Utility');
|
|
App::uses('ConfigReaderInterface', 'Configure');
|
|
|
|
/**
|
|
* Compatibility with 2.1, which expects Configure to load Set.
|
|
*/
|
|
App::uses('Set', 'Utility');
|
|
|
|
/**
|
|
* 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.Core
|
|
* @link http://book.cakephp.org/2.0/en/development/configuration.html#configure-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.
|
|
*
|
|
* @param boolean $boot
|
|
* @return void
|
|
*/
|
|
public static function bootstrap($boot = true) {
|
|
if ($boot) {
|
|
self::_appDefaults();
|
|
|
|
if (!include APP . 'Config' . DS . 'core.php') {
|
|
trigger_error(__d('cake_dev',
|
|
"Can't find application core file. Please create %s, and make sure it is readable by PHP.",
|
|
APP . 'Config' . DS . 'core.php'),
|
|
E_USER_ERROR
|
|
);
|
|
}
|
|
App::init();
|
|
App::$bootstrapping = false;
|
|
App::build();
|
|
|
|
$exception = array(
|
|
'handler' => 'ErrorHandler::handleException',
|
|
);
|
|
$error = array(
|
|
'handler' => 'ErrorHandler::handleError',
|
|
'level' => E_ALL & ~E_DEPRECATED,
|
|
);
|
|
self::_setErrorHandlers($error, $exception);
|
|
|
|
if (!include APP . 'Config' . DS . 'bootstrap.php') {
|
|
trigger_error(__d('cake_dev',
|
|
"Can't find application bootstrap file. Please create %s, and make sure it is readable by PHP.",
|
|
APP . 'Config' . DS . 'bootstrap.php'),
|
|
E_USER_ERROR
|
|
);
|
|
}
|
|
restore_error_handler();
|
|
|
|
self::_setErrorHandlers(
|
|
self::$_values['Error'],
|
|
self::$_values['Exception']
|
|
);
|
|
|
|
// Preload Debugger + String in case of E_STRICT errors when loading files.
|
|
if (self::$_values['debug'] > 0) {
|
|
class_exists('Debugger');
|
|
class_exists('String');
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Set app's default configs
|
|
* @return void
|
|
*/
|
|
protected static function _appDefaults() {
|
|
self::write('App', (array)self::read('App') + array(
|
|
'base' => false,
|
|
'baseUrl' => false,
|
|
'dir' => APP_DIR,
|
|
'webroot' => WEBROOT_DIR,
|
|
'www_root' => WWW_ROOT
|
|
));
|
|
}
|
|
|
|
/**
|
|
* 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/2.0/en/development/configuration.html#Configure::write
|
|
* @param string|array $config The key to write, can be a dot notation value.
|
|
* Alternatively can be an array containing key(s) and value(s).
|
|
* @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) {
|
|
self::$_values = Hash::insert(self::$_values, $name, $value);
|
|
}
|
|
|
|
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. It's 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/2.0/en/development/configuration.html#Configure::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;
|
|
}
|
|
return Hash::get(self::$_values, $var);
|
|
}
|
|
|
|
/**
|
|
* Returns true if given variable is set in Configure.
|
|
*
|
|
* @param string $var Variable name to check for
|
|
* @return boolean True if variable is there
|
|
*/
|
|
public static function check($var = null) {
|
|
if (empty($var)) {
|
|
return false;
|
|
}
|
|
return Hash::get(self::$_values, $var) !== 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/2.0/en/development/configuration.html#Configure::delete
|
|
* @param string $var the var to be deleted
|
|
* @return void
|
|
*/
|
|
public static function delete($var = null) {
|
|
self::$_values = Hash::remove(self::$_values, $var);
|
|
}
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* @param string $name
|
|
* @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 information will be merged with the current
|
|
* runtime configuration. You can load configuration files from plugins
|
|
* by preceding 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');`
|
|
*
|
|
* If using `default` config and no reader has been configured for it yet,
|
|
* one will be automatically created using PhpReader
|
|
*
|
|
* @link http://book.cakephp.org/2.0/en/development/configuration.html#Configure::load
|
|
* @param string $key name of configuration resource to load.
|
|
* @param string $config Name of the configured reader to use to read the resource identified by $key.
|
|
* @param boolean $merge if config files should be merged instead of simply overridden
|
|
* @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', $merge = true) {
|
|
$reader = self::_getReader($config);
|
|
if (!$reader) {
|
|
return false;
|
|
}
|
|
$values = $reader->read($key);
|
|
|
|
if ($merge) {
|
|
$keys = array_keys($values);
|
|
foreach ($keys as $key) {
|
|
if (($c = self::read($key)) && is_array($values[$key]) && is_array($c)) {
|
|
$values[$key] = Hash::merge($c, $values[$key]);
|
|
}
|
|
}
|
|
}
|
|
|
|
return self::write($values);
|
|
}
|
|
|
|
/**
|
|
* Dump data currently in Configure into $key. The serialization format
|
|
* is decided by the config reader attached as $config. For example, if the
|
|
* 'default' adapter is a PhpReader, the generated file will be a PHP
|
|
* configuration file loadable by the PhpReader.
|
|
*
|
|
* ## Usage
|
|
*
|
|
* Given that the 'default' reader is an instance of PhpReader.
|
|
* Save all data in Configure to the file `my_config.php`:
|
|
*
|
|
* `Configure::dump('my_config.php', 'default');`
|
|
*
|
|
* Save only the error handling configuration:
|
|
*
|
|
* `Configure::dump('error.php', 'default', array('Error', 'Exception');`
|
|
*
|
|
* @param string $key The identifier to create in the config adapter.
|
|
* This could be a filename or a cache key depending on the adapter being used.
|
|
* @param string $config The name of the configured adapter to dump data with.
|
|
* @param array $keys The name of the top-level keys you want to dump.
|
|
* This allows you save only some data stored in Configure.
|
|
* @return boolean success
|
|
* @throws ConfigureException if the adapter does not implement a `dump` method.
|
|
*/
|
|
public static function dump($key, $config = 'default', $keys = array()) {
|
|
$reader = self::_getReader($config);
|
|
if (!$reader) {
|
|
throw new ConfigureException(__d('cake_dev', 'There is no "%s" adapter.', $config));
|
|
}
|
|
if (!method_exists($reader, 'dump')) {
|
|
throw new ConfigureException(__d('cake_dev', 'The "%s" adapter, does not have a %s method.', $config, 'dump()'));
|
|
}
|
|
$values = self::$_values;
|
|
if (!empty($keys) && is_array($keys)) {
|
|
$values = array_intersect_key($values, array_flip($keys));
|
|
}
|
|
return (bool)$reader->dump($key, $values);
|
|
}
|
|
|
|
/**
|
|
* Get the configured reader. Internally used by `Configure::load()` and `Configure::dump()`
|
|
* Will create new PhpReader for default if not configured yet.
|
|
*
|
|
* @param string $config The name of the configured adapter
|
|
* @return mixed Reader instance or false
|
|
*/
|
|
protected static function _getReader($config) {
|
|
if (!isset(self::$_readers[$config])) {
|
|
if ($config !== 'default') {
|
|
return false;
|
|
}
|
|
App::uses('PhpReader', 'Configure');
|
|
self::config($config, new PhpReader());
|
|
}
|
|
return self::$_readers[$config];
|
|
}
|
|
|
|
/**
|
|
* Used to determine the current version of CakePHP.
|
|
*
|
|
* Usage `Configure::version();`
|
|
*
|
|
* @return string Current version of CakePHP
|
|
*/
|
|
public static function version() {
|
|
if (!isset(self::$_values['Cake']['version'])) {
|
|
require CAKE . '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;
|
|
}
|
|
|
|
/**
|
|
* Clear all values stored in Configure.
|
|
*
|
|
* @return boolean success.
|
|
*/
|
|
public static function clear() {
|
|
self::$_values = array();
|
|
return true;
|
|
}
|
|
/**
|
|
* Set the error and exception handlers.
|
|
*
|
|
* @param array $error The Error handling configuration.
|
|
* @param array $exception The exception handling configuration.
|
|
* @return void
|
|
*/
|
|
protected static function _setErrorHandlers($error, $exception) {
|
|
$level = -1;
|
|
if (isset($error['level'])) {
|
|
error_reporting($error['level']);
|
|
$level = $error['level'];
|
|
}
|
|
if (!empty($error['handler'])) {
|
|
set_error_handler($error['handler'], $level);
|
|
}
|
|
if (!empty($exception['handler'])) {
|
|
set_exception_handler($exception['handler']);
|
|
}
|
|
}
|
|
}
|