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

What is New in CakePHP 5.3

CakePHP 5.3 raises the minimum PHP requirement to 8.2 and adds practical enhancements across the framework. It improves pagination and sorting, supports Redis clusters for caching, introduces rate limiting middleware, and provides better tools for dependency injection, database queries, and testing. This release also includes several behavior changes for greater consistency.

Minimum PHP Requirement

CakePHP 5.3 now requires PHP 8.2 or higher. This allows the framework to use modern PHP features while ensuring better performance and security.

Pagination and Sorting Improvements

A new fluent interface makes defining sortable fields easier and more powerful.

• SortableFieldsBuilder lets you map user-friendly sort keys to database fields.
• Support for multi-column sorting and locked directions with SortField.
• Combined sort keys in URLs, like ?sort=title-asc.

Cache and Middleware

• Redis cache engine now supports clusters via the cluster configuration option.
• New RateLimiterMiddleware in Cake\Http\Middleware for controlling request rates.

Database and ORM Enhancements

• Query::optimizerHint() to add engine-specific hints.
• New database types: year, inet, cidr, and macaddr.
• TableContainer for dependency injection of ORM tables.
• strictFields option in entity creation and marshalling to limit validation.
• New validation rules: ipOrRange() and existsInNullable().

Console and Development Tools

• cake plugin assets symlink supports --relative for relative paths.
• cake server --frankenphp starts the server with FrankenPHP.
• Configure attribute for injecting values into constructors.

View and Helper Updates

• HtmlHelper::scriptStart() and scriptEnd() wrap inline scripts properly.
• StringTemplate::addClassNames() for easier class management.
• Improved form handling with nested checkboxes and radios by default.

Testing Improvements

• New assertions: assertRedirectBack(), assertRedirectBackToReferer(), assertFlashMessageContains(), and assertFlashMessageContainsAt().
• TestFixture::$tableAlias for custom table aliases.

Deprecations

• Query::newExpr(): Use Query::expr() instead.
• Form::_execute(): Rename to process().
• $request->getParam('?'): Use $request->getQueryParams().
• Direct behavior method calls on tables: Use getBehavior() instead.
• EntityTrait::isEmpty(): Use hasValue().
• Loading plugins without a plugin class is deprecated.

Breaking Changes and Migration Notes

Why Upgrade to CakePHP 5.3

CakePHP 5.3 brings modern requirements and useful features that make development smoother and applications more robust. With improved sorting, caching, and testing tools, it helps teams build scalable web apps efficiently while preparing for future versions.