##Migration Guide from 1.2 to 1.3 This guide summarizes many of the changes necessary when migrating from a 1.2 to 1.3 Cake core. #### Library Renames Core libraries of libs/session.php, libs/socket.php, libs/model/schema.php and libs/model/behavior.php have been renamed so that there is a better mapping between filenames and main classes contained within (as well as dealing with some name-spacing issues): - session.php -> cake_session.php - App::import('Core', 'Session') -> App::import('Core', 'CakeSession') - socket.php -> cake_socket.php - App::import('Core', 'Socket') -> App::import('Core', 'CakeSocket') - schema.php -> cake_schema.php - App::import('Model', 'Schema') -> App::import('Model', 'CakeSchema') - behavior.php -> model_behavior.php - App::import('Core', 'Behavior') -> App::import('Core', 'ModelBehavior') In most cases, the above renaming will not affect userland code.. #### Controller - `Controller::set()` no longer changes variables from `$var_name` to `$varName`. Variables always appear in the view exactly as you set them. #### Model - `DboSource::query()` now throws warnings for un-handled model methods, instead of trying to run them as queries. This means, people starting transactions improperly via the `$this->Model->begin()` syntax will need to update their code so that it accesses the model's DataSource object directly. - `Model::del()` and `Model::remove()` have been deprecated in favor of `Model::delete()`, which is now the canonical delete method. - Model::findAll, findCount, findNeighbours, removed. #### Databases - Most database configurations no longer support the `'connect'` key (which has been deprecated since pre-1.2). Instead, set `'persistent' => true` or `false` to determine whether or not a persistent database connection should be used. #### Debugger: - Calling `Debugger::output("text")` no longer works. Use `Debugger::output("txt")`. #### Shell - Shell::getAdmin() has been moved up to ProjectTask::getAdmin() #### Configure and App - Configure::listObjects() replaced by App::objects() - Configure::corePaths() replaced by App::core() - Configure::buildPaths() replaced by App::build() - Configure no longer manages paths. - Configure::write('modelPaths', array...) replaced by App::build(array('models' => array...)) - Configure::read('modelPaths') replaced by App::path('models')