2006-03-19 03:26:43 +00:00
< ? php
/* SVN FILE: $Id$ */
/**
* Short description for file .
*
Closes #2119 Only define clone() in PHP4 when it hasn't been already defined.
Closes #2213, Support multiple plugin paths.
Closes #2234, filepaths to behavior classes should be cached in class.paths.php also
Closes #2345, ability to group components into subfolders
Closes #2645, Improvement to basic.php for class loading.
Fixes #3526, Cache::write, when using just the config name, it fails.
Fixes #3559, loading plugin model as assoc don't work.
Closes #3567 Controller Folders (Note this does not need routing to work, but controller names can not conflict with others in the same application so naming must still be unique)
Fixes #3579, email.php component: Parse error with php 4.
Adding new class and file importer.
Updated most of the core to use the importer.
Added ClassRegsitry::init() that will create and instance of an object and store it in the registry.
Deprecated most of the load functions in basics.php
Plugin model loading now forces using the dot notation, to use models within a plugin, all the model associations must be in the PluginName.Model syntax, if this is not used, the plugin will look for the models in the main app/models directory first, if not found then it will search the plugin directories recursively until it finds a model.
var $belongsTo = array('SomeModel'); will look for some_model.php in the app/models
var $belongsTo = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $belongsTo = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
The controllers of the plugin will still look for the default models inside the plugin if var $uses is not set:
var $uses = array('SomeModel'); will look for some_model.php in the app/models
var $uses = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $uses = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
All of the above will work between plugins and main app
These changes also allow placing model and controllers is sub directories
Removed old class.paths.php file generation
git-svn-id: https://svn.cakephp.org/repo/branches/1.2.x.x@6001 3807eeeb-6ff5-0310-8944-8be069107fe0
2007-11-16 09:35:19 +00:00
* Long description for filec
2006-03-19 03:26:43 +00:00
*
* PHP versions 4 and 5
*
2007-02-02 10:39:45 +00:00
* CakePHP ( tm ) : Rapid Development Framework < http :// www . cakephp . org />
* Copyright 2005 - 2007 , Cake Software Foundation , Inc .
2006-05-26 05:29:17 +00:00
* 1785 E . Sahara Avenue , Suite 490 - 204
* Las Vegas , Nevada 89104
2006-03-19 03:26:43 +00:00
*
* Licensed under The MIT License
* Redistributions of files must retain the above copyright notice .
*
* @ filesource
2007-02-02 10:39:45 +00:00
* @ copyright Copyright 2005 - 2007 , Cake Software Foundation , Inc .
* @ link http :// www . cakefoundation . org / projects / info / cakephp CakePHP ( tm ) Project
2006-05-26 05:29:17 +00:00
* @ package cake
* @ subpackage cake . cake . libs
2007-02-02 10:39:45 +00:00
* @ since CakePHP ( tm ) v 1.0 . 0.2363
2006-05-26 05:29:17 +00:00
* @ version $Revision $
* @ modifiedby $LastChangedBy $
* @ lastmodified $Date $
* @ license http :// www . opensource . org / licenses / mit - license . php The MIT License
2006-03-19 03:26:43 +00:00
*/
/**
* Short description for file .
*
* Long description for file
*
2006-05-26 05:29:17 +00:00
* @ package cake
* @ subpackage cake . cake . libs
2006-03-19 03:26:43 +00:00
*/
2006-06-14 18:02:37 +00:00
class Configure extends Object {
2006-03-19 03:26:43 +00:00
/**
* Hold array with paths to view files
*
* @ var array
* @ access public
*/
2006-05-26 05:29:17 +00:00
var $viewPaths = array ();
2006-03-19 03:26:43 +00:00
/**
* Hold array with paths to controller files
*
* @ var array
* @ access public
*/
2006-05-26 05:29:17 +00:00
var $controllerPaths = array ();
2006-03-19 03:26:43 +00:00
/**
2007-05-20 06:30:19 +00:00
* Hold array with paths to model files
2006-03-19 03:26:43 +00:00
*
* @ var array
* @ access public
*/
2006-05-26 05:29:17 +00:00
var $modelPaths = array ();
2006-06-14 18:02:37 +00:00
/**
2007-05-20 06:30:19 +00:00
* Hold array with paths to helper files
2006-06-14 18:02:37 +00:00
*
* @ var array
* @ access public
*/
var $helperPaths = array ();
/**
2007-05-20 06:30:19 +00:00
* Hold array with paths to component files
2006-06-14 18:02:37 +00:00
*
* @ var array
* @ access public
*/
var $componentPaths = array ();
2006-07-22 14:13:07 +00:00
/**
2007-05-20 06:30:19 +00:00
* Hold array with paths to behavior files
2006-07-22 14:13:07 +00:00
*
* @ var array
* @ access public
*/
var $behaviorPaths = array ();
2007-02-01 07:17:54 +00:00
/**
2007-05-20 06:30:19 +00:00
* Current debug level
2007-02-01 07:17:54 +00:00
*
* @ var integer
* @ access public
*/
var $debug = null ;
Closes #2119 Only define clone() in PHP4 when it hasn't been already defined.
Closes #2213, Support multiple plugin paths.
Closes #2234, filepaths to behavior classes should be cached in class.paths.php also
Closes #2345, ability to group components into subfolders
Closes #2645, Improvement to basic.php for class loading.
Fixes #3526, Cache::write, when using just the config name, it fails.
Fixes #3559, loading plugin model as assoc don't work.
Closes #3567 Controller Folders (Note this does not need routing to work, but controller names can not conflict with others in the same application so naming must still be unique)
Fixes #3579, email.php component: Parse error with php 4.
Adding new class and file importer.
Updated most of the core to use the importer.
Added ClassRegsitry::init() that will create and instance of an object and store it in the registry.
Deprecated most of the load functions in basics.php
Plugin model loading now forces using the dot notation, to use models within a plugin, all the model associations must be in the PluginName.Model syntax, if this is not used, the plugin will look for the models in the main app/models directory first, if not found then it will search the plugin directories recursively until it finds a model.
var $belongsTo = array('SomeModel'); will look for some_model.php in the app/models
var $belongsTo = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $belongsTo = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
The controllers of the plugin will still look for the default models inside the plugin if var $uses is not set:
var $uses = array('SomeModel'); will look for some_model.php in the app/models
var $uses = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $uses = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
All of the above will work between plugins and main app
These changes also allow placing model and controllers is sub directories
Removed old class.paths.php file generation
git-svn-id: https://svn.cakephp.org/repo/branches/1.2.x.x@6001 3807eeeb-6ff5-0310-8944-8be069107fe0
2007-11-16 09:35:19 +00:00
/**
* Determine if $__objects cache should be wrote
*
* @ var boolean
* @ access private
*/
var $__cache = false ;
/**
* Holds and key => value array of objects type
*
* @ var array
* @ access private
*/
var $__objects = array ();
2006-03-19 03:26:43 +00:00
/**
* Return a singleton instance of Configure .
*
* @ return Configure instance
* @ access public
*/
2007-02-28 15:41:44 +00:00
function & getInstance ( $boot = true ) {
2006-05-26 05:29:17 +00:00
static $instance = array ();
if ( ! $instance ) {
$instance [ 0 ] =& new Configure ;
2007-02-28 15:41:44 +00:00
$instance [ 0 ] -> __loadBootstrap ( $boot );
2006-05-26 05:29:17 +00:00
}
return $instance [ 0 ];
}
2007-08-07 15:38:20 +00:00
/**
* Returns an index of objects of the given type , with the physical path to each object
*
* @ param string $type Type of object , i . e . 'model' , 'controller' , 'helper' , or 'plugin'
* @ param mixed $path Optional
* @ return Configure instance
* @ access public
*/
function listObjects ( $type , $path = null ) {
$_this =& Configure :: getInstance ();
$objects = array ();
Closes #2119 Only define clone() in PHP4 when it hasn't been already defined.
Closes #2213, Support multiple plugin paths.
Closes #2234, filepaths to behavior classes should be cached in class.paths.php also
Closes #2345, ability to group components into subfolders
Closes #2645, Improvement to basic.php for class loading.
Fixes #3526, Cache::write, when using just the config name, it fails.
Fixes #3559, loading plugin model as assoc don't work.
Closes #3567 Controller Folders (Note this does not need routing to work, but controller names can not conflict with others in the same application so naming must still be unique)
Fixes #3579, email.php component: Parse error with php 4.
Adding new class and file importer.
Updated most of the core to use the importer.
Added ClassRegsitry::init() that will create and instance of an object and store it in the registry.
Deprecated most of the load functions in basics.php
Plugin model loading now forces using the dot notation, to use models within a plugin, all the model associations must be in the PluginName.Model syntax, if this is not used, the plugin will look for the models in the main app/models directory first, if not found then it will search the plugin directories recursively until it finds a model.
var $belongsTo = array('SomeModel'); will look for some_model.php in the app/models
var $belongsTo = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $belongsTo = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
The controllers of the plugin will still look for the default models inside the plugin if var $uses is not set:
var $uses = array('SomeModel'); will look for some_model.php in the app/models
var $uses = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $uses = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
All of the above will work between plugins and main app
These changes also allow placing model and controllers is sub directories
Removed old class.paths.php file generation
git-svn-id: https://svn.cakephp.org/repo/branches/1.2.x.x@6001 3807eeeb-6ff5-0310-8944-8be069107fe0
2007-11-16 09:35:19 +00:00
if ( empty ( $_this -> __objects )) {
$_this -> __objects = Cache :: read ( 'object_map' , '_cake_core_' );
}
2007-08-07 15:38:20 +00:00
Closes #2119 Only define clone() in PHP4 when it hasn't been already defined.
Closes #2213, Support multiple plugin paths.
Closes #2234, filepaths to behavior classes should be cached in class.paths.php also
Closes #2345, ability to group components into subfolders
Closes #2645, Improvement to basic.php for class loading.
Fixes #3526, Cache::write, when using just the config name, it fails.
Fixes #3559, loading plugin model as assoc don't work.
Closes #3567 Controller Folders (Note this does not need routing to work, but controller names can not conflict with others in the same application so naming must still be unique)
Fixes #3579, email.php component: Parse error with php 4.
Adding new class and file importer.
Updated most of the core to use the importer.
Added ClassRegsitry::init() that will create and instance of an object and store it in the registry.
Deprecated most of the load functions in basics.php
Plugin model loading now forces using the dot notation, to use models within a plugin, all the model associations must be in the PluginName.Model syntax, if this is not used, the plugin will look for the models in the main app/models directory first, if not found then it will search the plugin directories recursively until it finds a model.
var $belongsTo = array('SomeModel'); will look for some_model.php in the app/models
var $belongsTo = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $belongsTo = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
The controllers of the plugin will still look for the default models inside the plugin if var $uses is not set:
var $uses = array('SomeModel'); will look for some_model.php in the app/models
var $uses = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $uses = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
All of the above will work between plugins and main app
These changes also allow placing model and controllers is sub directories
Removed old class.paths.php file generation
git-svn-id: https://svn.cakephp.org/repo/branches/1.2.x.x@6001 3807eeeb-6ff5-0310-8944-8be069107fe0
2007-11-16 09:35:19 +00:00
if ( empty ( $_this -> __objects ) || ! isset ( $_this -> __objects [ $type ])) {
$Inflector =& Inflector :: getInstance ();
2007-08-07 15:38:20 +00:00
Closes #2119 Only define clone() in PHP4 when it hasn't been already defined.
Closes #2213, Support multiple plugin paths.
Closes #2234, filepaths to behavior classes should be cached in class.paths.php also
Closes #2345, ability to group components into subfolders
Closes #2645, Improvement to basic.php for class loading.
Fixes #3526, Cache::write, when using just the config name, it fails.
Fixes #3559, loading plugin model as assoc don't work.
Closes #3567 Controller Folders (Note this does not need routing to work, but controller names can not conflict with others in the same application so naming must still be unique)
Fixes #3579, email.php component: Parse error with php 4.
Adding new class and file importer.
Updated most of the core to use the importer.
Added ClassRegsitry::init() that will create and instance of an object and store it in the registry.
Deprecated most of the load functions in basics.php
Plugin model loading now forces using the dot notation, to use models within a plugin, all the model associations must be in the PluginName.Model syntax, if this is not used, the plugin will look for the models in the main app/models directory first, if not found then it will search the plugin directories recursively until it finds a model.
var $belongsTo = array('SomeModel'); will look for some_model.php in the app/models
var $belongsTo = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $belongsTo = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
The controllers of the plugin will still look for the default models inside the plugin if var $uses is not set:
var $uses = array('SomeModel'); will look for some_model.php in the app/models
var $uses = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $uses = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
All of the above will work between plugins and main app
These changes also allow placing model and controllers is sub directories
Removed old class.paths.php file generation
git-svn-id: https://svn.cakephp.org/repo/branches/1.2.x.x@6001 3807eeeb-6ff5-0310-8944-8be069107fe0
2007-11-16 09:35:19 +00:00
$types = array (
'model' => array ( 'suffix' => '.php' , 'base' => 'AppModel' ),
'controller' => array ( 'suffix' => '_controller.php' , 'base' => 'AppController' ),
'helper' => array ( 'suffix' => '.php' , 'base' => 'AppHelper' ),
'plugin' => array ( 'suffix' => '' , 'base' => null ),
'class' => array ( 'suffix' => '.php' , 'base' => null )
);
if ( ! isset ( $types [ $type ])) {
return false ;
}
if ( empty ( $path )) {
$pathVar = $type . 'Paths' ;
$path = $_this -> { $pathVar };
}
$objects = array ();
foreach (( array ) $path as $dir ) {
$items = $_this -> __list ( $dir , $types [ $type ][ 'suffix' ]);
$objects = am ( $items , $objects );
/* if ( file_exists ( $path . $name . '.php' )) {
Configure :: store ( 'Models' , 'class.paths' , array ( $className => array ( 'path' => $path . $name . '.php' )));
require ( $path . $name . '.php' );
return true ;
} */
}
$_this -> __objects [ $type ] = array_map ( array ( & $Inflector , 'camelize' ), $objects );
$_this -> __cache = true ;
2007-08-07 15:38:20 +00:00
}
Closes #2119 Only define clone() in PHP4 when it hasn't been already defined.
Closes #2213, Support multiple plugin paths.
Closes #2234, filepaths to behavior classes should be cached in class.paths.php also
Closes #2345, ability to group components into subfolders
Closes #2645, Improvement to basic.php for class loading.
Fixes #3526, Cache::write, when using just the config name, it fails.
Fixes #3559, loading plugin model as assoc don't work.
Closes #3567 Controller Folders (Note this does not need routing to work, but controller names can not conflict with others in the same application so naming must still be unique)
Fixes #3579, email.php component: Parse error with php 4.
Adding new class and file importer.
Updated most of the core to use the importer.
Added ClassRegsitry::init() that will create and instance of an object and store it in the registry.
Deprecated most of the load functions in basics.php
Plugin model loading now forces using the dot notation, to use models within a plugin, all the model associations must be in the PluginName.Model syntax, if this is not used, the plugin will look for the models in the main app/models directory first, if not found then it will search the plugin directories recursively until it finds a model.
var $belongsTo = array('SomeModel'); will look for some_model.php in the app/models
var $belongsTo = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $belongsTo = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
The controllers of the plugin will still look for the default models inside the plugin if var $uses is not set:
var $uses = array('SomeModel'); will look for some_model.php in the app/models
var $uses = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $uses = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
All of the above will work between plugins and main app
These changes also allow placing model and controllers is sub directories
Removed old class.paths.php file generation
git-svn-id: https://svn.cakephp.org/repo/branches/1.2.x.x@6001 3807eeeb-6ff5-0310-8944-8be069107fe0
2007-11-16 09:35:19 +00:00
return $_this -> __objects [ $type ];
2007-08-07 15:38:20 +00:00
}
/**
* Returns an array of filenames of PHP files in given directory .
*
* @ param string $path Path to scan for files
2007-08-07 21:41:38 +00:00
* @ param string $suffix if false , return only directories . if string , match and return files
* @ return array List of directories or files in directory
2007-08-07 15:38:20 +00:00
*/
2007-08-07 21:41:38 +00:00
function __list ( $path , $suffix = false ) {
2007-08-15 14:38:25 +00:00
if ( ! class_exists ( 'folder' )) {
2007-09-24 23:49:54 +00:00
uses ( 'folder' );
2007-08-15 14:38:25 +00:00
}
2007-08-24 17:00:32 +00:00
$items = array ();
2007-08-07 21:41:38 +00:00
$Folder =& new Folder ( $path );
$contents = $Folder -> read ( false , true );
2007-11-16 11:31:13 +00:00
if ( is_array ( $contents )) {
2007-08-07 21:41:38 +00:00
if ( ! $suffix ) {
return $contents [ 0 ];
} else {
2007-08-10 09:20:42 +00:00
foreach ( $contents [ 1 ] as $item ) {
2007-08-07 21:41:38 +00:00
if ( substr ( $item , - strlen ( $suffix )) == $suffix ) {
2007-08-24 17:00:32 +00:00
$items [] = substr ( $item , 0 , strlen ( $item ) - strlen ( $suffix ));
2007-08-07 15:38:20 +00:00
}
}
}
}
2007-08-24 17:00:32 +00:00
return $items ;
2007-08-07 15:38:20 +00:00
}
2006-12-05 09:49:59 +00:00
/**
* Used to write a dynamic var in the Configure instance .
*
* 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]' ));
*
2007-05-20 06:30:19 +00:00
* @ param array $config Name of var to write
* @ param mixed $value Value to set for var
2006-12-05 09:49:59 +00:00
* @ access public
*/
2007-06-20 07:51:52 +00:00
function write ( $config , $value = null ) {
2006-12-05 09:49:59 +00:00
$_this =& Configure :: getInstance ();
2007-06-20 06:15:35 +00:00
if ( ! is_array ( $config ) && $value !== null ) {
2006-12-05 09:49:59 +00:00
$name = $_this -> __configVarNames ( $config );
2007-06-20 07:51:52 +00:00
if ( count ( $name ) > 1 ) {
2006-12-05 09:49:59 +00:00
$_this -> { $name [ 0 ]}[ $name [ 1 ]] = $value ;
} else {
$_this -> { $name [ 0 ]} = $value ;
}
} else {
2007-06-20 07:51:52 +00:00
foreach ( $config as $names => $value ) {
2006-12-05 09:49:59 +00:00
$name = $_this -> __configVarNames ( $names );
2007-06-20 07:51:52 +00:00
if ( count ( $name ) > 1 ) {
2006-12-05 09:49:59 +00:00
$_this -> { $name [ 0 ]}[ $name [ 1 ]] = $value ;
} else {
$_this -> { $name [ 0 ]} = $value ;
}
}
}
if ( $config == 'debug' || ( is_array ( $config ) && in_array ( 'debug' , $config ))) {
if ( $_this -> debug ) {
error_reporting ( E_ALL );
if ( function_exists ( 'ini_set' )) {
ini_set ( 'display_errors' , 1 );
}
2007-03-04 03:45:44 +00:00
2007-06-20 06:15:35 +00:00
if ( ! class_exists ( 'Debugger' )) {
2007-03-04 03:45:44 +00:00
require LIBS . 'debugger.php' ;
}
2007-04-12 00:34:16 +00:00
if ( ! class_exists ( 'CakeLog' )) {
uses ( 'cake_log' );
}
Configure :: write ( 'log' , LOG_NOTICE );
2006-12-05 09:49:59 +00:00
} else {
error_reporting ( 0 );
2007-04-12 00:34:16 +00:00
Configure :: write ( 'log' , LOG_NOTICE );
2006-12-05 09:49:59 +00:00
}
}
}
/**
* Used to read Configure :: $var
*
* Usage
* Configure :: read ( 'Name' ); will return all values for Name
* Configure :: read ( 'Name.key' ); will return only the value of Configure :: Name [ key ]
*
2007-05-20 06:30:19 +00:00
* @ param string $var Variable to obtain
2006-12-05 09:49:59 +00:00
* @ return string value of Configure :: $var
* @ access public
*/
2007-06-20 07:51:52 +00:00
function read ( $var = 'debug' ) {
2006-12-05 09:49:59 +00:00
$_this =& Configure :: getInstance ();
2007-06-20 06:15:35 +00:00
if ( $var === 'debug' ) {
2007-06-20 07:51:52 +00:00
if ( ! isset ( $_this -> debug )) {
2007-08-16 05:44:06 +00:00
if ( defined ( 'DEBUG' )) {
$_this -> debug = DEBUG ;
} else {
$_this -> debug = 0 ;
}
2006-12-05 09:49:59 +00:00
}
return $_this -> debug ;
}
$name = $_this -> __configVarNames ( $var );
2007-06-20 07:51:52 +00:00
if ( count ( $name ) > 1 ) {
2007-06-20 06:15:35 +00:00
if ( isset ( $_this -> { $name [ 0 ]}[ $name [ 1 ]])) {
2006-12-21 22:05:42 +00:00
return $_this -> { $name [ 0 ]}[ $name [ 1 ]];
}
return null ;
2006-12-05 09:49:59 +00:00
} else {
2007-06-20 06:15:35 +00:00
if ( isset ( $_this -> { $name [ 0 ]})) {
2006-12-21 22:05:42 +00:00
return $_this -> { $name [ 0 ]};
}
return null ;
2006-12-05 09:49:59 +00:00
}
}
/**
* Used to delete a var from the Configure instance .
*
* Usage :
* Configure :: delete ( 'Name' ); will delete the entire Configure :: Name
* Configure :: delete ( 'Name.key' ); will delete only the Configure :: Name [ key ]
*
* @ param string $var the var to be deleted
* @ access public
*/
2007-06-20 07:51:52 +00:00
function delete ( $var = null ) {
2006-12-05 09:49:59 +00:00
$_this =& Configure :: getInstance ();
$name = $_this -> __configVarNames ( $var );
2007-06-20 07:51:52 +00:00
if ( count ( $name ) > 1 ) {
2006-12-05 09:49:59 +00:00
unset ( $_this -> { $name [ 0 ]}[ $name [ 1 ]]);
} else {
unset ( $_this -> { $name [ 0 ]});
}
}
/**
* Will load a file from app / config / configure_file . php
* variables in the files should be formated like :
* $config [ 'name' ] = 'value' ;
* These will be used to create dynamic Configure vars .
*
* Usage Configure :: load ( 'configure_file' );
*
* @ param string $fileName name of file to load , extension must be . php and only the name should be used , not the extenstion
* @ access public
*/
function load ( $fileName ) {
$_this =& Configure :: getInstance ();
2007-01-09 22:32:48 +00:00
if ( file_exists ( CONFIGS . $fileName . '.php' )) {
include ( CONFIGS . $fileName . '.php' );
} elseif ( file_exists ( CACHE . 'persistent' . DS . $fileName . '.php' )) {
include ( CACHE . 'persistent' . DS . $fileName . '.php' );
2007-09-24 23:49:54 +00:00
} elseif ( file_exists ( CAKE_CORE_INCLUDE_PATH . DS . 'cake' . DS . 'config' . DS . $fileName . '.php' )) {
include ( CAKE_CORE_INCLUDE_PATH . DS . 'cake' . DS . 'config' . DS . $fileName . '.php' );
2007-01-09 22:32:48 +00:00
} else {
2006-12-05 09:49:59 +00:00
return false ;
}
2006-12-22 22:49:47 +00:00
2007-06-20 07:51:52 +00:00
if ( ! isset ( $config )) {
2006-12-22 22:49:47 +00:00
trigger_error ( sprintf ( __ ( " Configure::load() - no variable \$ config found in %s.php " , true ), $fileName ), E_USER_WARNING );
2006-12-05 09:49:59 +00:00
return false ;
}
return $_this -> write ( $config );
}
/**
* Used to determine the current version of CakePHP
*
* Usage Configure :: version ();
*
* @ return string Current version of CakePHP
* @ access public
*/
function version () {
$_this =& Configure :: getInstance ();
2007-06-20 06:15:35 +00:00
if ( ! isset ( $_this -> Cake [ 'version' ])) {
2006-12-05 09:49:59 +00:00
require ( CORE_PATH . 'cake' . DS . 'config' . DS . 'config.php' );
$_this -> write ( $config );
}
return $_this -> Cake [ 'version' ];
}
/**
2007-01-09 22:32:48 +00:00
* Used to write a config file to the server .
*
* Configure :: store ( 'Model' , 'class.paths' , array ( 'Users' => array ( 'path' => 'users' , 'plugin' => true )));
*
* @ param string $type Type of config file to write , ex : Models , Controllers , Helpers , Components
* @ param string $name file name .
* @ param array $data array of values to store .
* @ access public
*/
function store ( $type , $name , $data = array ()) {
$_this =& Configure :: getInstance ();
$write = true ;
$content = '' ;
foreach ( $data as $key => $value ) {
2007-02-08 03:25:37 +00:00
$content .= " \$ config[' $type '][' $key '] " ;
2007-06-20 07:51:52 +00:00
if ( is_array ( $value )) {
2007-02-08 03:25:37 +00:00
$content .= " = array( " ;
2007-06-20 07:51:52 +00:00
foreach ( $value as $key1 => $value2 ) {
2007-01-12 01:33:18 +00:00
$value2 = addslashes ( $value2 );
2007-01-09 22:32:48 +00:00
$content .= " ' $key1 ' => ' $value2 ', " ;
}
2007-02-08 03:25:37 +00:00
$content .= " ); \n " ;
2007-01-09 22:32:48 +00:00
} else {
2007-01-12 01:33:18 +00:00
$value = addslashes ( $value );
2007-02-08 03:25:37 +00:00
$content .= " = ' $value '; \n " ;
2007-01-09 22:32:48 +00:00
}
}
2007-06-20 06:15:35 +00:00
if ( is_null ( $type )) {
2007-01-09 22:32:48 +00:00
$write = false ;
}
$_this -> __writeConfig ( $content , $name , $write );
}
/**
* Creates a cached version of a configuration file .
* Appends values passed from Configure :: store () to the cached file
*
2007-05-20 06:30:19 +00:00
* @ param string $content Content to write on file
* @ param string $name Name to use for cache file
2007-10-22 16:54:36 +00:00
* @ param boolean $write true if content should be written , false otherwise
2007-01-09 22:32:48 +00:00
* @ access private
*/
2007-06-20 07:51:52 +00:00
function __writeConfig ( $content , $name , $write = true ) {
2007-01-09 22:32:48 +00:00
$file = CACHE . 'persistent' . DS . $name . '.php' ;
2007-01-14 01:29:20 +00:00
$_this =& Configure :: getInstance ();
if ( $_this -> read () > 0 ) {
2007-01-14 01:25:13 +00:00
$expires = " +10 seconds " ;
} else {
$expires = " +999 days " ;
2007-01-09 22:32:48 +00:00
}
2007-01-14 01:25:13 +00:00
$cache = cache ( 'persistent' . DS . $name . '.php' , null , $expires );
2007-06-20 07:51:52 +00:00
if ( $cache === null ) {
2007-01-14 01:25:13 +00:00
cache ( 'persistent' . DS . $name . '.php' , " <?php \n \$ config = array(); \n " , $expires );
}
2007-06-20 07:51:52 +00:00
if ( $write === true ) {
if ( ! class_exists ( 'File' )) {
2007-01-09 22:32:48 +00:00
uses ( 'File' );
}
$fileClass = new File ( $file );
2007-06-20 06:15:35 +00:00
if ( $fileClass -> writable ()) {
2007-05-18 21:16:13 +00:00
$fileClass -> append ( $content );
}
}
}
/**
* Checks $name for dot notation to create dynamic Configure :: $var as an array when needed .
*
2007-05-20 06:30:19 +00:00
* @ param mixed $name Name to split
* @ return array Name separated in items through dot notation
2007-05-18 21:16:13 +00:00
* @ access private
*/
function __configVarNames ( $name ) {
if ( is_string ( $name )) {
if ( strpos ( $name , " . " )) {
$name = explode ( " . " , $name );
} else {
$name = array ( $name );
}
}
return $name ;
}
/**
Closes #2119 Only define clone() in PHP4 when it hasn't been already defined.
Closes #2213, Support multiple plugin paths.
Closes #2234, filepaths to behavior classes should be cached in class.paths.php also
Closes #2345, ability to group components into subfolders
Closes #2645, Improvement to basic.php for class loading.
Fixes #3526, Cache::write, when using just the config name, it fails.
Fixes #3559, loading plugin model as assoc don't work.
Closes #3567 Controller Folders (Note this does not need routing to work, but controller names can not conflict with others in the same application so naming must still be unique)
Fixes #3579, email.php component: Parse error with php 4.
Adding new class and file importer.
Updated most of the core to use the importer.
Added ClassRegsitry::init() that will create and instance of an object and store it in the registry.
Deprecated most of the load functions in basics.php
Plugin model loading now forces using the dot notation, to use models within a plugin, all the model associations must be in the PluginName.Model syntax, if this is not used, the plugin will look for the models in the main app/models directory first, if not found then it will search the plugin directories recursively until it finds a model.
var $belongsTo = array('SomeModel'); will look for some_model.php in the app/models
var $belongsTo = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $belongsTo = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
The controllers of the plugin will still look for the default models inside the plugin if var $uses is not set:
var $uses = array('SomeModel'); will look for some_model.php in the app/models
var $uses = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $uses = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
All of the above will work between plugins and main app
These changes also allow placing model and controllers is sub directories
Removed old class.paths.php file generation
git-svn-id: https://svn.cakephp.org/repo/branches/1.2.x.x@6001 3807eeeb-6ff5-0310-8944-8be069107fe0
2007-11-16 09:35:19 +00:00
* Sets the paths for the given object type
2007-05-18 21:16:13 +00:00
*
Closes #2119 Only define clone() in PHP4 when it hasn't been already defined.
Closes #2213, Support multiple plugin paths.
Closes #2234, filepaths to behavior classes should be cached in class.paths.php also
Closes #2345, ability to group components into subfolders
Closes #2645, Improvement to basic.php for class loading.
Fixes #3526, Cache::write, when using just the config name, it fails.
Fixes #3559, loading plugin model as assoc don't work.
Closes #3567 Controller Folders (Note this does not need routing to work, but controller names can not conflict with others in the same application so naming must still be unique)
Fixes #3579, email.php component: Parse error with php 4.
Adding new class and file importer.
Updated most of the core to use the importer.
Added ClassRegsitry::init() that will create and instance of an object and store it in the registry.
Deprecated most of the load functions in basics.php
Plugin model loading now forces using the dot notation, to use models within a plugin, all the model associations must be in the PluginName.Model syntax, if this is not used, the plugin will look for the models in the main app/models directory first, if not found then it will search the plugin directories recursively until it finds a model.
var $belongsTo = array('SomeModel'); will look for some_model.php in the app/models
var $belongsTo = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $belongsTo = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
The controllers of the plugin will still look for the default models inside the plugin if var $uses is not set:
var $uses = array('SomeModel'); will look for some_model.php in the app/models
var $uses = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $uses = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
All of the above will work between plugins and main app
These changes also allow placing model and controllers is sub directories
Removed old class.paths.php file generation
git-svn-id: https://svn.cakephp.org/repo/branches/1.2.x.x@6001 3807eeeb-6ff5-0310-8944-8be069107fe0
2007-11-16 09:35:19 +00:00
* @ param array $paths paths defines in config / bootstrap . php
2007-05-18 21:16:13 +00:00
* @ access private
*/
Closes #2119 Only define clone() in PHP4 when it hasn't been already defined.
Closes #2213, Support multiple plugin paths.
Closes #2234, filepaths to behavior classes should be cached in class.paths.php also
Closes #2345, ability to group components into subfolders
Closes #2645, Improvement to basic.php for class loading.
Fixes #3526, Cache::write, when using just the config name, it fails.
Fixes #3559, loading plugin model as assoc don't work.
Closes #3567 Controller Folders (Note this does not need routing to work, but controller names can not conflict with others in the same application so naming must still be unique)
Fixes #3579, email.php component: Parse error with php 4.
Adding new class and file importer.
Updated most of the core to use the importer.
Added ClassRegsitry::init() that will create and instance of an object and store it in the registry.
Deprecated most of the load functions in basics.php
Plugin model loading now forces using the dot notation, to use models within a plugin, all the model associations must be in the PluginName.Model syntax, if this is not used, the plugin will look for the models in the main app/models directory first, if not found then it will search the plugin directories recursively until it finds a model.
var $belongsTo = array('SomeModel'); will look for some_model.php in the app/models
var $belongsTo = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $belongsTo = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
The controllers of the plugin will still look for the default models inside the plugin if var $uses is not set:
var $uses = array('SomeModel'); will look for some_model.php in the app/models
var $uses = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $uses = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
All of the above will work between plugins and main app
These changes also allow placing model and controllers is sub directories
Removed old class.paths.php file generation
git-svn-id: https://svn.cakephp.org/repo/branches/1.2.x.x@6001 3807eeeb-6ff5-0310-8944-8be069107fe0
2007-11-16 09:35:19 +00:00
function __buildPaths ( $paths ) {
2007-05-18 21:16:13 +00:00
$_this =& Configure :: getInstance ();
2007-11-16 11:31:13 +00:00
$cache = false ;
$basePaths = Cache :: read ( 'base_paths' , '_cake_core_' );
if ( ! $basePaths ) {
$cache = true ;
$all = explode ( PATH_SEPARATOR , ini_get ( 'include_path' ));
$all = array_flip ( array_flip (( array_merge ( array ( CAKE_CORE_INCLUDE_PATH ), $all ))));
foreach ( $all as $path ) {
$path = rtrim ( $path , DS );
if ( $path == '.' ) {
continue ;
}
if ( is_dir ( $path . DS . 'cake' . DS . 'libs' . DS . 'model' . DS . 'behaviors' )) {
$paths [ 'behavior' ][] = $path . DS . 'cake' . DS . 'libs' . DS . 'model' . DS . 'behaviors' ;
}
if ( is_dir ( $path . DS . 'cake' . DS . 'libs' . DS . 'controller' . DS . 'components' )) {
$paths [ 'component' ][] = $path . DS . 'cake' . DS . 'libs' . DS . 'controller' . DS . 'components' ;
}
if ( is_dir ( $path . DS . 'cake' . DS . 'libs' . DS . 'view' . DS . 'helpers' )) {
$paths [ 'helper' ][] = $path . DS . 'cake' . DS . 'libs' . DS . 'view' . DS . 'helpers' ;
}
if ( is_dir ( $path . DS . 'cake' . DS . 'libs' . DS . 'controller' )) {
$paths [ 'controller' ][] = $path . DS . 'cake' . DS . 'libs' . DS . 'controller' ;
}
if ( is_dir ( $path . DS . 'cake' . DS . 'libs' . DS . 'view' )) {
$paths [ 'view' ][] = $path . DS . 'cake' . DS . 'libs' . DS . 'view' ;
}
if ( is_dir ( $path . DS . 'cake' . DS . 'libs' . DS . 'model' )) {
$paths [ 'model' ][] = $path . DS . 'cake' . DS . 'libs' . DS . 'model' ;
}
}
Closes #2119 Only define clone() in PHP4 when it hasn't been already defined.
Closes #2213, Support multiple plugin paths.
Closes #2234, filepaths to behavior classes should be cached in class.paths.php also
Closes #2345, ability to group components into subfolders
Closes #2645, Improvement to basic.php for class loading.
Fixes #3526, Cache::write, when using just the config name, it fails.
Fixes #3559, loading plugin model as assoc don't work.
Closes #3567 Controller Folders (Note this does not need routing to work, but controller names can not conflict with others in the same application so naming must still be unique)
Fixes #3579, email.php component: Parse error with php 4.
Adding new class and file importer.
Updated most of the core to use the importer.
Added ClassRegsitry::init() that will create and instance of an object and store it in the registry.
Deprecated most of the load functions in basics.php
Plugin model loading now forces using the dot notation, to use models within a plugin, all the model associations must be in the PluginName.Model syntax, if this is not used, the plugin will look for the models in the main app/models directory first, if not found then it will search the plugin directories recursively until it finds a model.
var $belongsTo = array('SomeModel'); will look for some_model.php in the app/models
var $belongsTo = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $belongsTo = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
The controllers of the plugin will still look for the default models inside the plugin if var $uses is not set:
var $uses = array('SomeModel'); will look for some_model.php in the app/models
var $uses = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $uses = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
All of the above will work between plugins and main app
These changes also allow placing model and controllers is sub directories
Removed old class.paths.php file generation
git-svn-id: https://svn.cakephp.org/repo/branches/1.2.x.x@6001 3807eeeb-6ff5-0310-8944-8be069107fe0
2007-11-16 09:35:19 +00:00
2007-11-16 11:31:13 +00:00
$basePaths = array (
'plugin' => APP . 'plugins' . DS ,
'behavior' => array_merge ( array ( BEHAVIORS ), $paths [ 'behavior' ]),
'component' => array_merge ( array ( COMPONENTS ), $paths [ 'component' ]),
'helper' => array_merge ( array ( HELPERS , APP ), $paths [ 'helper' ]),
'controller' => array_merge ( array ( CONTROLLERS , APP ), $paths [ 'controller' ]),
'view' => array_merge ( array ( VIEWS ), $paths [ 'view' ]),
'model' => array_merge ( array ( MODELS ), $paths [ 'model' ]));
}
Closes #2119 Only define clone() in PHP4 when it hasn't been already defined.
Closes #2213, Support multiple plugin paths.
Closes #2234, filepaths to behavior classes should be cached in class.paths.php also
Closes #2345, ability to group components into subfolders
Closes #2645, Improvement to basic.php for class loading.
Fixes #3526, Cache::write, when using just the config name, it fails.
Fixes #3559, loading plugin model as assoc don't work.
Closes #3567 Controller Folders (Note this does not need routing to work, but controller names can not conflict with others in the same application so naming must still be unique)
Fixes #3579, email.php component: Parse error with php 4.
Adding new class and file importer.
Updated most of the core to use the importer.
Added ClassRegsitry::init() that will create and instance of an object and store it in the registry.
Deprecated most of the load functions in basics.php
Plugin model loading now forces using the dot notation, to use models within a plugin, all the model associations must be in the PluginName.Model syntax, if this is not used, the plugin will look for the models in the main app/models directory first, if not found then it will search the plugin directories recursively until it finds a model.
var $belongsTo = array('SomeModel'); will look for some_model.php in the app/models
var $belongsTo = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $belongsTo = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
The controllers of the plugin will still look for the default models inside the plugin if var $uses is not set:
var $uses = array('SomeModel'); will look for some_model.php in the app/models
var $uses = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $uses = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
All of the above will work between plugins and main app
These changes also allow placing model and controllers is sub directories
Removed old class.paths.php file generation
git-svn-id: https://svn.cakephp.org/repo/branches/1.2.x.x@6001 3807eeeb-6ff5-0310-8944-8be069107fe0
2007-11-16 09:35:19 +00:00
foreach ( $basePaths as $type => $default ) {
$pathsVar = $type . 'Paths' ;
if ( ! is_array ( $default )) {
$default = array ( $default );
2007-05-18 21:16:13 +00:00
}
Closes #2119 Only define clone() in PHP4 when it hasn't been already defined.
Closes #2213, Support multiple plugin paths.
Closes #2234, filepaths to behavior classes should be cached in class.paths.php also
Closes #2345, ability to group components into subfolders
Closes #2645, Improvement to basic.php for class loading.
Fixes #3526, Cache::write, when using just the config name, it fails.
Fixes #3559, loading plugin model as assoc don't work.
Closes #3567 Controller Folders (Note this does not need routing to work, but controller names can not conflict with others in the same application so naming must still be unique)
Fixes #3579, email.php component: Parse error with php 4.
Adding new class and file importer.
Updated most of the core to use the importer.
Added ClassRegsitry::init() that will create and instance of an object and store it in the registry.
Deprecated most of the load functions in basics.php
Plugin model loading now forces using the dot notation, to use models within a plugin, all the model associations must be in the PluginName.Model syntax, if this is not used, the plugin will look for the models in the main app/models directory first, if not found then it will search the plugin directories recursively until it finds a model.
var $belongsTo = array('SomeModel'); will look for some_model.php in the app/models
var $belongsTo = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $belongsTo = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
The controllers of the plugin will still look for the default models inside the plugin if var $uses is not set:
var $uses = array('SomeModel'); will look for some_model.php in the app/models
var $uses = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $uses = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
All of the above will work between plugins and main app
These changes also allow placing model and controllers is sub directories
Removed old class.paths.php file generation
git-svn-id: https://svn.cakephp.org/repo/branches/1.2.x.x@6001 3807eeeb-6ff5-0310-8944-8be069107fe0
2007-11-16 09:35:19 +00:00
$_this -> { $pathsVar } = $default ;
if ( isset ( $paths [ $pathsVar ]) && ! empty ( $paths [ $pathsVar ])) {
$_this -> { $pathsVar } = array_merge (( array ) $paths [ $pathsVar ], $_this -> { $pathsVar });
2007-08-07 15:38:20 +00:00
}
}
2007-11-16 11:31:13 +00:00
if ( $cache ) {
Cache :: write ( 'base_paths' , array_filter ( $basePaths ), '_cake_core_' );
}
2007-08-07 15:38:20 +00:00
}
2007-05-18 21:16:13 +00:00
/**
* Loads the app / config / bootstrap . php
* If the alternative paths are set in this file
* they will be added to the paths vars
*
2007-10-22 16:54:36 +00:00
* @ param boolean $boot Load application bootstrap ( if true )
2007-05-18 21:16:13 +00:00
* @ access private
*/
function __loadBootstrap ( $boot ) {
$_this =& Configure :: getInstance ();
2007-11-16 12:01:02 +00:00
$modelPaths = $viewPaths = $controllerPaths = $helperPaths = $componentPaths = $behaviorPaths = $pluginPaths = null ;
if ( $boot ) {
$_this -> write ( 'App' , array ( 'base' => false , 'baseUrl' => false , 'dir' => APP_DIR , 'webroot' => WEBROOT_DIR ));
if ( ! include ( APP_PATH . 'config' . DS . 'core.php' )) {
trigger_error ( sprintf ( __ ( " Can't find application core file. Please create %score.php, and make sure it is readable by PHP. " , true ), CONFIGS ), E_USER_ERROR );
}
if ( ! include ( APP_PATH . 'config' . DS . 'bootstrap.php' )) {
trigger_error ( sprintf ( __ ( " Can't find application bootstrap file. Please create %sbootstrap.php, and make sure it is readable by PHP. " , true ), CONFIGS ), E_USER_ERROR );
}
}
2007-08-16 05:44:06 +00:00
2007-11-16 11:31:13 +00:00
if ( $_this -> read ( 'Cache.disable' ) !== true ) {
$cache = Cache :: settings ();
if ( empty ( $cache )) {
trigger_error ( 'Cache not configured properly. Please check Cache::config(); in APP/config/core.php' , E_USER_WARNING );
Cache :: config ( 'default' , array ( 'engine' => 'File' ));
$cache = Cache :: settings ();
}
$settings = array ( 'prefix' => 'cake_core_' , 'path' => CACHE . 'persistent' . DS );
if ( Configure :: read () > 1 ) {
$settings = array ( 'prefix' => 'cake_core_' , 'duration' => 10 , 'path' => CACHE . 'persistent' . DS );
}
Cache :: config ( '_cake_core_' , array_merge ( $cache , $settings ));
}
2007-11-16 12:01:02 +00:00
$_this -> __buildPaths ( compact ( 'modelPaths' , 'viewPaths' , 'controllerPaths' , 'helperPaths' , 'componentPaths' , 'behaviorPaths' , 'pluginPaths' ));
Closes #2119 Only define clone() in PHP4 when it hasn't been already defined.
Closes #2213, Support multiple plugin paths.
Closes #2234, filepaths to behavior classes should be cached in class.paths.php also
Closes #2345, ability to group components into subfolders
Closes #2645, Improvement to basic.php for class loading.
Fixes #3526, Cache::write, when using just the config name, it fails.
Fixes #3559, loading plugin model as assoc don't work.
Closes #3567 Controller Folders (Note this does not need routing to work, but controller names can not conflict with others in the same application so naming must still be unique)
Fixes #3579, email.php component: Parse error with php 4.
Adding new class and file importer.
Updated most of the core to use the importer.
Added ClassRegsitry::init() that will create and instance of an object and store it in the registry.
Deprecated most of the load functions in basics.php
Plugin model loading now forces using the dot notation, to use models within a plugin, all the model associations must be in the PluginName.Model syntax, if this is not used, the plugin will look for the models in the main app/models directory first, if not found then it will search the plugin directories recursively until it finds a model.
var $belongsTo = array('SomeModel'); will look for some_model.php in the app/models
var $belongsTo = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $belongsTo = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
The controllers of the plugin will still look for the default models inside the plugin if var $uses is not set:
var $uses = array('SomeModel'); will look for some_model.php in the app/models
var $uses = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $uses = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
All of the above will work between plugins and main app
These changes also allow placing model and controllers is sub directories
Removed old class.paths.php file generation
git-svn-id: https://svn.cakephp.org/repo/branches/1.2.x.x@6001 3807eeeb-6ff5-0310-8944-8be069107fe0
2007-11-16 09:35:19 +00:00
2007-09-30 07:45:34 +00:00
if ( defined ( 'BASE_URL' )) {
2007-10-15 21:56:31 +00:00
trigger_error ( 'BASE_URL Deprecated: See Configure::write(\'App.baseUrl\', \'' . BASE_URL . '\'); in APP/config/core.php' , E_USER_WARNING );
$_this -> write ( 'App.baseUrl' , BASE_URL );
2007-09-30 07:45:34 +00:00
}
if ( defined ( 'DEBUG' )) {
2007-10-15 21:56:31 +00:00
trigger_error ( 'DEBUG Deprecated: Use Configure::write(\'debug\', ' . DEBUG . '); in APP/config/core.php' , E_USER_WARNING );
2007-09-30 07:45:34 +00:00
$_this -> write ( 'debug' , DEBUG );
}
if ( defined ( 'CAKE_ADMIN' )) {
2007-10-14 01:09:21 +00:00
trigger_error ( 'CAKE_ADMIN Deprecated: Use Configure::write(\'Routing.admin\', \'' . CAKE_ADMIN . '\'); in APP/config/core.php' , E_USER_WARNING );
2007-09-30 07:45:34 +00:00
$_this -> write ( 'Routing.admin' , CAKE_ADMIN );
}
if ( defined ( 'WEBSERVICES' )) {
2007-10-15 21:56:31 +00:00
trigger_error ( 'WEBSERVICES Deprecated: Use Router::parseExtensions(); or add Configure::write(\'Routing.webservices\', \'' . WEBSERVICES . '\');' , E_USER_WARNING );
2007-09-30 07:45:34 +00:00
$_this -> write ( 'Routing.webservices' , WEBSERVICES );
}
2007-10-14 01:09:21 +00:00
if ( defined ( 'ACL_CLASSNAME' )) {
2007-10-16 09:05:25 +00:00
trigger_error ( 'ACL_CLASSNAME Deprecated. Use Configure::write(\'Acl.classname\', \'' . ACL_CLASSNAME . '\'); in APP/config/core.php' , E_USER_WARNING );
2007-10-14 01:09:21 +00:00
$_this -> write ( 'Acl.classname' , ACL_CLASSNAME );
}
if ( defined ( 'ACL_DATABASE' )) {
2007-10-16 09:05:25 +00:00
trigger_error ( 'ACL_DATABASE Deprecated. Use Configure::write(\'Acl.database\', \'' . ACL_CLASSNAME . '\'); in APP/config/core.php' , E_USER_WARNING );
2007-10-14 01:09:21 +00:00
$_this -> write ( 'Acl.database' , ACL_CLASSNAME );
}
2007-10-16 09:05:25 +00:00
if ( defined ( 'CAKE_SESSION_SAVE' )) {
trigger_error ( 'CAKE_SESSION_SAVE Deprecated. Use Configure::write(\'Session.save\', \'' . CAKE_SESSION_SAVE . '\'); in APP/config/core.php' , E_USER_WARNING );
$_this -> write ( 'Session.save' , CAKE_SESSION_SAVE );
}
if ( defined ( 'CAKE_SESSION_TABLE' )) {
trigger_error ( 'CAKE_SESSION_TABLE Deprecated. Use Configure::write(\'Session.table\', \'' . CAKE_SESSION_TABLE . '\'); in APP/config/core.php' , E_USER_WARNING );
$_this -> write ( 'Session.table' , CAKE_SESSION_TABLE );
}
if ( defined ( 'CAKE_SESSION_STRING' )) {
trigger_error ( 'CAKE_SESSION_STRING Deprecated. Use Configure::write(\'Security.salt\', \'' . CAKE_SESSION_STRING . '\'); in APP/config/core.php' , E_USER_WARNING );
$_this -> write ( 'Security.salt' , CAKE_SESSION_STRING );
}
if ( defined ( 'CAKE_SESSION_COOKIE' )) {
trigger_error ( 'CAKE_SESSION_COOKIE Deprecated. Use Configure::write(\'Session.cookie\', \'' . CAKE_SESSION_COOKIE . '\'); in APP/config/core.php' , E_USER_WARNING );
$_this -> write ( 'Session.cookie' , CAKE_SESSION_COOKIE );
}
if ( defined ( 'CAKE_SECURITY' )) {
trigger_error ( 'CAKE_SECURITY Deprecated. Use Configure::write(\'Security.level\', \'' . CAKE_SECURITY . '\'); in APP/config/core.php' , E_USER_WARNING );
$_this -> write ( 'Security.level' , CAKE_SECURITY );
}
if ( defined ( 'CAKE_SESSION_TIMEOUT' )) {
trigger_error ( 'CAKE_SESSION_TIMEOUT Deprecated. Use Configure::write(\'Session.timeout\', \'' . CAKE_SESSION_TIMEOUT . '\'); in APP/config/core.php' , E_USER_WARNING );
$_this -> write ( 'Session.timeout' , CAKE_SESSION_TIMEOUT );
}
if ( defined ( 'AUTO_SESSION' )) {
trigger_error ( 'AUTO_SESSION Deprecated. Use Configure::write(\'Session.start\', \'' . AUTO_SESSION . '\'); in APP/config/core.php' , E_USER_WARNING );
$_this -> write ( 'Session.start' , AUTO_SESSION );
}
2007-05-18 21:16:13 +00:00
}
Closes #2119 Only define clone() in PHP4 when it hasn't been already defined.
Closes #2213, Support multiple plugin paths.
Closes #2234, filepaths to behavior classes should be cached in class.paths.php also
Closes #2345, ability to group components into subfolders
Closes #2645, Improvement to basic.php for class loading.
Fixes #3526, Cache::write, when using just the config name, it fails.
Fixes #3559, loading plugin model as assoc don't work.
Closes #3567 Controller Folders (Note this does not need routing to work, but controller names can not conflict with others in the same application so naming must still be unique)
Fixes #3579, email.php component: Parse error with php 4.
Adding new class and file importer.
Updated most of the core to use the importer.
Added ClassRegsitry::init() that will create and instance of an object and store it in the registry.
Deprecated most of the load functions in basics.php
Plugin model loading now forces using the dot notation, to use models within a plugin, all the model associations must be in the PluginName.Model syntax, if this is not used, the plugin will look for the models in the main app/models directory first, if not found then it will search the plugin directories recursively until it finds a model.
var $belongsTo = array('SomeModel'); will look for some_model.php in the app/models
var $belongsTo = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $belongsTo = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
The controllers of the plugin will still look for the default models inside the plugin if var $uses is not set:
var $uses = array('SomeModel'); will look for some_model.php in the app/models
var $uses = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $uses = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
All of the above will work between plugins and main app
These changes also allow placing model and controllers is sub directories
Removed old class.paths.php file generation
git-svn-id: https://svn.cakephp.org/repo/branches/1.2.x.x@6001 3807eeeb-6ff5-0310-8944-8be069107fe0
2007-11-16 09:35:19 +00:00
function __destruct () {
$_this = & Configure :: getInstance ();
if ( $_this -> __cache ) {
Cache :: write ( 'object_map' , array_filter ( $_this -> __objects ), '_cake_core_' );
}
}
}
/**
* Class and file loader .
*
* @ since CakePHP ( tm ) v 1.2 . 0.6001
* @ package cake
* @ subpackage cake . cake . libs
*/
class App extends Object {
/**
* Paths to search for files
*
* @ var array
* @ access public
*/
var $search = array ();
/**
* Return the file that is loaded
*
* @ var array
* @ access public
*/
var $return = false ;
/**
* Determine if $__maps and $__paths cache should be wrote
*
* @ var boolean
* @ access private
*/
var $__cache = false ;
/**
* Holds key => values pairs of $type => file path
*
* @ var array
* @ access private
*/
var $__map = array ();
/**
* Holds paths for deep searching of files
*
* @ var array
* @ access private
*/
var $__paths = array ();
/**
* Will find Classes based on the $name , or can accept specific file to search for
*
* @ param mixed $type The type of Class if passed as a string , or all params can be passed as an single array to $type ,
* @ param string $name Name of the Class or a unique name for the file
* @ param mixed $parent boolean true if Class Parent should be searched , accepts key => value array ( 'parent' => $parent , 'file' => $file , 'search' => $search );
* @ param array $search paths to search for files , array ( 'path 1' , 'path 2' , 'path 3' );
* @ param string $file full name of the file to search for including extension
* @ param boolean $return , return the loaded file , the file must have a return statement in it to work : return $variable ;
* @ return boolean true if Class is already in memory or if file is found and loaded , false if not
* @ access public
* @ todo when App :: import () is called without params initialize all the files from the core in one call
*/
function import ( $type = null , $name = null , $parent = true , $search = array (), $file = null , $return = false ) {
$plugin = null ;
$directory = null ;
if ( is_array ( $type )) {
extract ( $type , EXTR_OVERWRITE );
}
if ( is_array ( $parent )) {
extract ( $parent , EXTR_OVERWRITE );
die ( debug ( $this ));
}
if ( $name === null && $file === null ) {
$name = $type ;
$type = 'Core' ;
} elseif ( $name === null ) {
$type = 'File' ;
}
if ( $name != null && strpos ( $name , '.' ) !== false ) {
list ( $plugin , $name ) = explode ( '.' , $name );
}
$_this =& App :: getInstance ();
$_this -> return = $return ;
$ext = $_this -> __settings ( $type , $plugin , $parent );
if ( $name != null && ! class_exists ( $name . $ext [ 'class' ])) {
if ( $load = $_this -> __mapped ( $name . $ext [ 'class' ], $type , $plugin )) {
if ( $_this -> __load ( $load )) {
$_this -> __overload ( $type , $name . $ext [ 'class' ]);
if ( $_this -> return ) {
$value = include $load ;
return $value ;
}
return true ;
} else {
$_this -> __remove ( $name . $ext [ 'class' ], $type , $plugin );
$_this -> __cache = true ;
}
}
if ( ! empty ( $search )) {
$_this -> search = $search ;
} elseif ( $plugin ) {
$_this -> search = $_this -> __paths ( 'plugin' );
} else {
$_this -> search = $_this -> __paths ( $type );
}
$find = $file ;
if ( $find === null ) {
$find = Inflector :: underscore ( $name . $ext [ 'suffix' ]) . '.php' ;
if ( $plugin ) {
$find = Inflector :: underscore ( $plugin ) . DS . Inflector :: underscore ( $type ) . 's' . DS . $find ;
$plugin = Inflector :: camelize ( $plugin );
}
}
if ( empty ( $search ) && $_this -> __load ( $file )) {
$directory = false ;
} else {
$file = $find ;
$directory = $_this -> __find ( $find , true );
}
if ( $directory !== null ) {
$_this -> __cache = true ;
$_this -> __map ( $directory . $file , $name . $ext [ 'class' ], $type , $plugin );
$_this -> __overload ( $type , $name . $ext [ 'class' ]);
if ( $_this -> return ) {
$value = include $directory . $file ;
return $value ;
}
return true ;
}
return false ;
}
return true ;
}
/**
* Returns a single instance of App
*
* @ return object
* @ access public
*/
function & getInstance () {
static $instance = array ();
if ( ! $instance ) {
$instance [ 0 ] =& new App ();
2007-11-16 11:31:13 +00:00
$map = Cache :: read ( 'file_map' , '_cake_core_' );
Closes #2119 Only define clone() in PHP4 when it hasn't been already defined.
Closes #2213, Support multiple plugin paths.
Closes #2234, filepaths to behavior classes should be cached in class.paths.php also
Closes #2345, ability to group components into subfolders
Closes #2645, Improvement to basic.php for class loading.
Fixes #3526, Cache::write, when using just the config name, it fails.
Fixes #3559, loading plugin model as assoc don't work.
Closes #3567 Controller Folders (Note this does not need routing to work, but controller names can not conflict with others in the same application so naming must still be unique)
Fixes #3579, email.php component: Parse error with php 4.
Adding new class and file importer.
Updated most of the core to use the importer.
Added ClassRegsitry::init() that will create and instance of an object and store it in the registry.
Deprecated most of the load functions in basics.php
Plugin model loading now forces using the dot notation, to use models within a plugin, all the model associations must be in the PluginName.Model syntax, if this is not used, the plugin will look for the models in the main app/models directory first, if not found then it will search the plugin directories recursively until it finds a model.
var $belongsTo = array('SomeModel'); will look for some_model.php in the app/models
var $belongsTo = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $belongsTo = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
The controllers of the plugin will still look for the default models inside the plugin if var $uses is not set:
var $uses = array('SomeModel'); will look for some_model.php in the app/models
var $uses = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $uses = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
All of the above will work between plugins and main app
These changes also allow placing model and controllers is sub directories
Removed old class.paths.php file generation
git-svn-id: https://svn.cakephp.org/repo/branches/1.2.x.x@6001 3807eeeb-6ff5-0310-8944-8be069107fe0
2007-11-16 09:35:19 +00:00
if ( $map ) {
$instance [ 0 ] -> __map = $map ;
}
}
return $instance [ 0 ];
}
/**
* Locates the $file in $__paths , searches recursively
*
* @ param string $file full file name
* @ param boolean $recursive search $__paths recursively
* @ return mixed boolean on fail , $file directory path on success
* @ access private
*/
function __find ( $file , $recursive = true ) {
$_this =& App :: getInstance ();
if ( empty ( $_this -> search )) {
return null ;
} elseif ( is_string ( $_this -> search )) {
$_this -> search = array ( $_this -> search );
}
if ( empty ( $_this -> __paths )) {
$map = Cache :: read ( 'dir_map' , '_cake_core_' );
if ( $map ) {
$_this -> __paths = $map ;
}
}
foreach ( $_this -> search as $path ) {
$path = rtrim ( $path , DS );
if ( $path === rtrim ( APP , DS )) {
$recursive = false ;
}
if ( $recursive === false ) {
if ( $_this -> __load ( $path . DS . $file )) {
return $path . DS ;
}
continue ;
}
if ( ! isset ( $_this -> __paths [ $path ])) {
if ( ! class_exists ( 'Folder' )) {
uses ( 'Folder' );
}
$Folder =& new Folder ();
$directories = $Folder -> tree ( $path , false , 'dir' );
$_this -> __paths [ $path ] = $directories ;
}
foreach ( $_this -> __paths [ $path ] as $directory ) {
if ( $_this -> __load ( $directory . DS . $file )) {
return $directory . DS ;
}
}
}
return null ;
}
/**
* Attempts to load $file
*
* @ param string $file full path to file including file name
* @ return boolean
*/
function __load ( $file ) {
$_this =& App :: getInstance ();
if ( file_exists ( $file )) {
if ( ! $_this -> return ) {
require ( $file );
}
return true ;
}
return false ;
}
/**
* Maps the $name to the $file
*
* @ param string $file full path to file
* @ param string $name unique name for this map
* @ param string $type type object being mapped
* @ param string $plugin if object is from a plugin , the name of the plugin
* @ access private
*/
function __map ( $file , $name , $type , $plugin ) {
$_this =& App :: getInstance ();
if ( $plugin ) {
$plugin = Inflector :: camelize ( $plugin );
$_this -> __map [ 'Plugin' ][ $plugin ][ $type ][ $name ] = $file ;
} else {
$_this -> __map [ $type ][ $name ] = $file ;
}
}
/**
* Return files complete path
*
* @ param string $name unique name
* @ param string $type type object
* @ param string $plugin if object is from a plugin , the name of the plugin
* @ return mixed , file path if found , false otherwise
* @ access private
*/
function __mapped ( $name , $type , $plugin ) {
$_this =& App :: getInstance ();
if ( $plugin ) {
$plugin = Inflector :: camelize ( $plugin );
if ( isset ( $_this -> __map [ 'Plugin' ][ $plugin ][ $type ])) {
if ( array_key_exists ( $name , $_this -> __map [ 'Plugin' ][ $plugin ][ $type ])) {
return $_this -> __map [ 'Plugin' ][ $plugin ][ $type ][ $name ];
}
return false ;
}
}
if ( isset ( $_this -> __map [ $type ])) {
if ( array_key_exists ( $name , $_this -> __map [ $type ])) {
return $_this -> __map [ $type ][ $name ];
}
return false ;
}
}
/**
* Used to overload Objects as needed
*
* @ param string $type Model or Helper
* @ param string $name Class name to overload
* @ access private
*/
function __overload ( $type , $name ) {
$overload = array ( 'Model' , 'Helper' );
if ( in_array ( $type , $overload )) {
Overloadable :: overload ( $name );
}
}
/**
* Loads parent classes based on the $type
* Returns and prefix or suffix needed for load files
*
* @ param string $type type of object
* @ param string $plugin name of plugin
* @ param boolean $parent false will not attempt to load parent
* @ return array
* @ access private
*/
function __settings ( $type , $plugin , $parent ) {
$_this = & App :: getInstance ();
if ( empty ( $parent )) {
return null ;
}
if ( $parent !== true ) {
$_this -> import ( $_this -> parent , $type , false );
return null ;
}
if ( $plugin ) {
$plugin = Inflector :: underscore ( $plugin );
$name = Inflector :: camelize ( $plugin );
}
$load = strtolower ( $type );
switch ( $load ) {
case 'model' :
if ( ! class_exists ( 'Model' )) {
$_this -> import ( 'Core' , 'Model' , false );
}
$_this -> import ( $type , 'AppModel' , false );
if ( $plugin ) {
$_this -> import ( $type , $plugin . '.' . $name . 'AppModel' , false , array (), $plugin . DS . $plugin . '_app_model.php' );
}
break ;
case 'view' :
return ;
break ;
case 'controller' :
$_this -> import ( $type , 'AppController' , false );
if ( $plugin ) {
$_this -> import ( $type , $plugin . '.' . $name . 'AppController' , false , array (), $plugin . DS . $plugin . '_app_controller.php' );
}
return array ( 'class' => $type , 'suffix' => $type );
break ;
case 'helper' :
$_this -> import ( $type , 'AppHelper' , false );
return array ( 'class' => $type , 'suffix' => null );
break ;
case 'component' :
return array ( 'class' => $type , 'suffix' => null );
break ;
case 'behavior' :
$_this -> import ( $type , 'Behavior' , false );
return array ( 'class' => $type , 'suffix' => null );
break ;
}
return array ( 'class' => null , 'suffix' => null );
}
/**
* Returns default paths to search
*
* @ param string $type type of object to be searched
* @ return array list of paths
* @ access private
*/
function __paths ( $type ) {
if ( $type === 'Core' ) {
2007-11-16 11:31:13 +00:00
$all = explode ( PATH_SEPARATOR , ini_get ( 'include_path' ));
$all = array_flip ( array_flip (( array_merge ( array ( CAKE_CORE_INCLUDE_PATH ), $all ))));
foreach ( $all as $path ) {
$path = rtrim ( $path , DS );
if ( $path == '.' ) {
continue ;
}
if ( is_dir ( $path . DS . 'cake' . DS . 'libs' )) {
$paths [] = $path . DS . 'cake' . DS . 'libs' ;
}
}
return $paths ;
Closes #2119 Only define clone() in PHP4 when it hasn't been already defined.
Closes #2213, Support multiple plugin paths.
Closes #2234, filepaths to behavior classes should be cached in class.paths.php also
Closes #2345, ability to group components into subfolders
Closes #2645, Improvement to basic.php for class loading.
Fixes #3526, Cache::write, when using just the config name, it fails.
Fixes #3559, loading plugin model as assoc don't work.
Closes #3567 Controller Folders (Note this does not need routing to work, but controller names can not conflict with others in the same application so naming must still be unique)
Fixes #3579, email.php component: Parse error with php 4.
Adding new class and file importer.
Updated most of the core to use the importer.
Added ClassRegsitry::init() that will create and instance of an object and store it in the registry.
Deprecated most of the load functions in basics.php
Plugin model loading now forces using the dot notation, to use models within a plugin, all the model associations must be in the PluginName.Model syntax, if this is not used, the plugin will look for the models in the main app/models directory first, if not found then it will search the plugin directories recursively until it finds a model.
var $belongsTo = array('SomeModel'); will look for some_model.php in the app/models
var $belongsTo = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $belongsTo = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
The controllers of the plugin will still look for the default models inside the plugin if var $uses is not set:
var $uses = array('SomeModel'); will look for some_model.php in the app/models
var $uses = array('MyPlugin.SomeModel'); will look for some_model.php in my_plugin/models
var $uses = array('MyPlugin.MyPlugin', 'SomeModel'); will used my_plugin/models/my_plugin.php and app/models/some_model.php
All of the above will work between plugins and main app
These changes also allow placing model and controllers is sub directories
Removed old class.paths.php file generation
git-svn-id: https://svn.cakephp.org/repo/branches/1.2.x.x@6001 3807eeeb-6ff5-0310-8944-8be069107fe0
2007-11-16 09:35:19 +00:00
}
$paths = Configure :: read ( strtolower ( $type ) . 'Paths' );
return $paths ;
}
/**
* Removes file location from map if file has been deleted
*
* @ param string $name name of object
* @ param string $type type of object
* @ param string $plugin name of plugin
*/
function __remove ( $name , $type , $plugin ) {
$_this =& App :: getInstance ();
if ( $plugin ) {
$plugin = Inflector :: camelize ( $plugin );
unset ( $_this -> __map [ 'Plugin' ][ $plugin ][ $type ][ $name ]);
} else {
unset ( $_this -> __map [ $type ][ $name ]);
}
}
/**
* Object destructor
*
* Write cache file if changes have been made to the $__map or $__paths
* @ access private
*/
function __destruct () {
$_this = & App :: getInstance ();
if ( $_this -> __cache ) {
Cache :: write ( 'dir_map' , array_filter ( $_this -> __paths ), '_cake_core_' );
Cache :: write ( 'file_map' , array_filter ( $_this -> __map ), '_cake_core_' );
}
}
2007-05-18 21:16:13 +00:00
}
2006-03-19 03:26:43 +00:00
?>