/cakephp-2.0.0/cake/libs/configure.php
PHP | 401 lines | 195 code | 19 blank | 187 comment | 29 complexity | 6e190dfc5b1c5d3b6a0896a74e6bc44f MD5 | raw file
- <?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);
- }
- if (empty(self::$_values['Cache']['disable'])) {
- $cache = Cache::config('default');
- if (empty($cache['settings'])) {
- trigger_error(__('Cache not configured properly. Please check Cache::config(); in APP/config/core.php'), E_USER_WARNING);
- $cache = Cache::config('default', array('engine' => 'File'));
- }
- $path = $prefix = $duration = null;
- if (!empty($cache['settings']['path'])) {
- $path = realpath($cache['settings']['path']);
- } else {
- $prefix = $cache['settings']['prefix'];
- }
- if (self::$_values['debug'] >= 1) {
- $duration = '+10 seconds';
- } else {
- $duration = '+999 days';
- }
- if (Cache::config('_cake_core_') === false) {
- Cache::config('_cake_core_', array_merge((array)$cache['settings'], array(
- 'prefix' => $prefix . 'cake_core_', 'path' => $path . DS . 'persistent' . DS,
- 'serialize' => true, 'duration' => $duration
- )));
- }
- if (Cache::config('_cake_model_') === false) {
- Cache::config('_cake_model_', array_merge((array)$cache['settings'], array(
- 'prefix' => $prefix . 'cake_model_', 'path' => $path . DS . 'models' . DS,
- 'serialize' => true, 'duration' => $duration
- )));
- }
- }
- 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);
- }