2-3-migration-guide.rst

2.3 Migration Guide

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

Constants

An application can now easily define :php:const:`CACHE` and :php:const:`LOGS`, as they are conditionally defined by CakePHP now.

Caching

• FileEngine is always the default cache engine. In the past a number of people had difficulty setting up and deploying APC correctly both in cli + web. Using files should make setting up CakePHP simpler for new developers.

Component

AuthComponent

• A new authenticate adapter has been added to support blowfish/bcrypt hashed passwords. You can now use Blowfish in your $authenticate array to allow bcrypt passwords to be used.

PaginatorComponent

• PaginatorComponent now supports the findType option. This can be used to specify what find method you want used for pagination. This is a bit easier to manage and set than the 0'th index.

SecurityComponent

• SecurityComponent now supports the unlockedActions option. This can be used to disable all security checks for any actions listed in this option.

RequestHandlerComponent

• :php:meth:`RequestHandlerComponent::viewClassMap()` has been added, which is used to map a type to view classname. You can add $settings['viewClassMap'] for automatically setting the correct viewClass based on extension/content type.

CookieComponent

• :php:meth:`CookieComponent::check()` was added. This method works the same as :php:meth:`CakeSession::check()` does.

Console

• The server shell was added. You can use this to start the PHP5.4 webserver for your CakePHP application.
• Baking a new project now sets the application's cache prefix to the name of the application.

I18n

L10n

• nld is now the default locale for Dutch as specified by ISO 639-3 and dut its alias. The locale folders have to be adjusted accordingly (from /locale/dut/ to /locale/nld/).

Core

Configure

• :php:meth:`Configure::check()` was added. This method works the same as :php:meth:`CakeSession::check()` does.

Error

Exceptions

• CakeBaseException was added, which all core Exceptions now extend. The base exception class also introduces the responseHeader() method which can be called on created Exception instances to add headers for the response, as Exceptions don't reuse any response instance.

Model

• Support for the biginteger type was added to all core datasources, and fixtures.
• Support for FULLTEXT indexes was added for the MySQL driver.

Model

• Model::find('list') now sets the recursive based on the max containment depth or recursive value. When list is used with ContainableBehavior.

Validation

• Missing validation methods will always trigger errors now instead of only in development mode.

Network

SmtpTransport

• TLS/SSL support was added for SMTP connections.

CakeRequest

• :php:meth:`CakeRequest::onlyAllow()` was added.
• :php:meth:`CakeRequest::query()` was added.

CakeResponse

• :php:meth:`CakeResponse::file()` was added.

CakeEmail

• The contentDisposition option was added to :php:meth:`CakeEmail::attachments()`. This allows you to disable the Content-Disposition header added to attached files.

Routing

Router

• Support for tel:, sms: were added to :php:meth:`Router::url()`.

View

• MediaView is deprecated, and you can use new features in :php:class:`CakeResponse` to achieve the same results.
• Serialization in Json and Xml views has been moved to _serialize()
• beforeRender and afterRender callbacks are now being called in Json and Xml views when using view templates.
• :php:meth:`View::fetch()` now has a $default argument. This argument can be used to provide a default value should a block be empty.

Helpers

FormHelper

• :php:meth:`FormHelper::select()` now accepts a list of values in the disabled attribute. Combined with 'multiple' => 'checkbox', this allows you to provide a list of values you want disabled.
• :php:meth:`FormHelper::postLink()` now accepts a method key. This allows you to create link forms using HTTP methods other than POST.

TextHelper

• :php:meth:`TextHelper::tail()` was added to truncate text starting from the end.
• ending in :php:meth:`TextHelper::truncate()` is deprecated in favor of ellipsis

Testing

• A core fixture for the default cake_sessions table was added. You can use it by adding core.cake_sessions to your fixture list.

Utility

CakeNumber

• :php:meth:`CakeNumber::fromReadableSize()` was added.

Folder

• :php:meth:`Folder::copy()` and :php:meth:`Folder::move()` now support the ability to merge the target and source directories in addition to skip/overwrite.

String

• :php:meth:`String::tail()` was added to truncate text starting from the end.
• ending in :php:meth:`String::truncate()` is deprecated in favor of ellipsis

Debugger

• php:meth:Debugger::exportVar() now outputs private and protected properties in PHP >= 5.3.0.

Security

• Support for bcrypt was added. See the :php:class:`Security::hash()` documentation for more information on how to use bcrypt.

Validation

• :php:meth:`Validation::fileSize()` was added.