2.7 Migration Guide

CakePHP 2.7 is a fully API compatible upgrade from 2.6. This page outlines the changes and improvements made in 2.7.

Requirements

The PHP version requirement for CakePHP 2.7 has been bumped up to PHP 5.3.0.

Console

• Plugin shells that share a name with their plugin can now be called without the plugin prefix. For example Console/cake MyPlugin.my_plugin can now be called with Console/cake my_plugin.
• Shell::param() was backported from 3.0 into 2.7. This method provides a notice error free way to read CLI options.

Core

Configure

• Configure::consume() has been added to read and delete from Configure in a single step.

Datasource

• SQL datasources will now cast '' and null into '' when columns are not nullable and rows are being created or updated.

CakeSession

• CakeSession::consume() has been added to read and delete from session in a single step.
• Argument $renew has been added to CakeSession::clear() to allow emptying the session without forcing a new id and renewing the session. It defaults to true.

Model

TreeBehavior

• New setting level is now available. You can use it to specify field name in which the depth of tree nodes will be stored.
• New method TreeBehavior::getLevel() has been added which fetches depth of a node.
• The formatting of TreeBehavior::generateTreeList() has been extracted into an own method TreeBehavior::formatTreeList().

Network

CakeEmail

• CakeEmail will now use the 'default' config set when creating instances that do not specify a configuration set to use. For example $email = new CakeEmail(); will now use the 'default' config set.

Utility

CakeText

The class String has been renamed to CakeText. This resolves some conflicts around HHVM compatibility as well as possibly PHP7+. There is a String class provided as well for compatibility reasons.

Validation

• Validation::notEmpty() has been renamed to Validation::notBlank(). This aims to avoid confusion around the PHP notEmpty() function and that the validation rule accepts 0 as valid input.

Controller

SessionComponent

• SessionComponent::consume() has been added to read and delete from session in a single step.
• SessionComponent::setFlash() has been deprecated. You should use FlashComponent instead.

RequestHandlerComponent

• The text/plain Accept header is no longer automatically mapped to the csv response type. This is a backport from 3.0

View

SessionHelper

• SessionHelper::consume() has been added to read and delete from session in a single step.
• SessionHelper::flash() has been deprecated. You should use FlashHelper instead.

TestSuite

ControllerTestCase

• ControllerTestCase::testAction() now supports an array as URL.