CakePHP 3.4: What's New, Release History & Support Lifecycle

What Is New in CakePHP 3.4

CakePHP 3.4 delivers incremental improvements and deprecations that prepare the codebase for future major releases. The focus is on refining existing components and enhancing developer experience with more flexible tools.

How Are Database Associations More Powerful Now?

The ORM now supports a hasMany('Through') association. This is useful for modeling relationships where a join table contains additional data or metadata, bridging two distant tables.

In practice, this works similarly to hasOne('Through') but returns multiple related entities. You define it in your table class's initialize method. This matters because it simplifies complex data models that previously required custom finder logic or intermediate associations.

// Example: A User hasMany Articles through UserArticles
$this->hasMany('Articles', [
    'through' => 'UserArticles',
]);

What Changed in the FormHelper Template System?

The FormHelper received a significant internal refactor for its template system. The new structure provides clearer separation between form elements, labels, and error messages, making customization more intuitive.

Instead of a single complex template string, you now work with a template array. This gives you finer control over the HTML wrapper for each part of a form input. The old input template is split into label, input, error, and formGroup templates.

// New template array structure
$_defaultWidgetTemplates = [
    'label' => '<label{{attrs}}>{{text}}</label>',
    'input' => '<input{{attrs}}/>',
    'error' => '<div class="error-message"{{attrs}}>{{content}}</div>'
];

Which Parts of the Framework Are Now Deprecated?

Several components are marked for removal in CakePHP 4.0. The deprecation notices help you update your code ahead of the breaking changes.

TableRegistry Static Methods

Static methods like TableRegistry::config() and TableRegistry::clear() are deprecated. Use the instance methods on the TableRegistry object instead.

Network\Session

The entire Network\Session class is deprecated. Switch to using Cake\Http\Session.

Log\Log Static Methods

Static methods on Log\Log like Log::config() are deprecated. Use Log::setConfig() and other instance methods.

What Collection Utilities Were Added?

The Collection class gained new methods for more expressive data manipulation. These include unfold(), through(), and insert().

unfold() is handy for flattening a collection of arrays or iterators into a single sequence. through() allows you to pipe the collection through a callable, useful for creating custom chainable operations.

$items = $collection->unfold(function ($item) {
    return $item->children;
});
$result = $collection->through(function ($items) {
    return $items->filter($someFilter);
});