diff --git a/en/appendices/5-3-migration-guide.rst b/en/appendices/5-3-migration-guide.rst deleted file mode 100644 index 08e1cd21f7..0000000000 --- a/en/appendices/5-3-migration-guide.rst +++ /dev/null @@ -1,56 +0,0 @@ -5.3 Migration Guide -################### - -The 5.3.0 release is a backwards compatible with 5.0. It adds new functionality -and introduces new deprecations. Any functionality deprecated in 5.x will be -removed in 6.0.0. - -Upgrade to PHP 8.2 -================== - -If you are not running on **PHP 8.2 or higher**, you will need to upgrade PHP before updating CakePHP. - -.. note:: - CakePHP 5.3 requires **a minimum of PHP 8.2**. - -Behavior Changes -================ - -View ----- - -- The ``format()`` and ``currency()`` methods of ``NumberHelper`` now accept also null as input and can return any default string here. - This allows for easier templates, in particular baked ones. Make sure to adjust any extending helper (plugin or app level) by adding that type. - -Deprecations -============ - -Http ----- - -- Using `$request->getParam('?')` to get the query params is deprecated. - Use `$request->getQueryParams()` instead. - -ORM ---- - -- Calling behavior methods on table instances is now deprecated. To call - a method of an attached behavior you need to use - ``$table->getBehavior('Sluggable')->slugify()`` instead of ``$table->slugify()``. -- ``EntityTrait::isEmpty()`` is deprecated. Use ``hasValue()`` instead. - -New Features -============ - -Routing -------- - -- ``EntityRoute`` now handles enum value conversions. This enables you to use - enum backed properties as route parameters. When an enum backed property is - used in routing, the enum's ``value`` or ``name`` will be used. - -Validation ----------- - -- ``ipOrRange()`` validation has has been added to check for an IP or a range (subnet). - diff --git a/en/appendices/6-0-migration-guide.rst b/en/appendices/6-0-migration-guide.rst index 53c982765b..da8cacbe0d 100644 --- a/en/appendices/6-0-migration-guide.rst +++ b/en/appendices/6-0-migration-guide.rst @@ -51,3 +51,13 @@ Utility - The default placeholder format for ``Text::insert()`` has been changed. They now use ``{foo}`` instead of ``:foo``. You can get the old behavior by using the ``before`` and ``after`` keys of ``$options``. + +View +---- + +- ``'escape'``/``'escapeTitle'`` keys have now been separated cleanly into ``escape`` for escaping content/labels, and + ``'escapeAttributes'`` for HTML attributes respectively. They also don't overlap anymore, so if you need to prevent escaping + on content and attributes, make sure to set them both to false. +- ``title`` has been renamed to ``content`` in scopes where this is not an attribute, but content or label element, specifically: + ``'item'``/``itemWithoutLink`` breadcrumb templates. +- ``multicheckboxTitle`` template of FormHelper is now ``multicheckboxLabel``.