From 8b2a1931b46cdea4bcb67fa527acca9b26b3de1d Mon Sep 17 00:00:00 2001 From: othercorey Date: Fri, 21 Apr 2023 00:20:59 -0500 Subject: [PATCH] Add migration notes for moving DateFormatTrait methods into Date --- en/appendices/5-0-migration-guide.rst | 27 ++++++++++++++++----------- 1 file changed, 16 insertions(+), 11 deletions(-) diff --git a/en/appendices/5-0-migration-guide.rst b/en/appendices/5-0-migration-guide.rst index f903417e7a..b0ba9b6ecf 100644 --- a/en/appendices/5-0-migration-guide.rst +++ b/en/appendices/5-0-migration-guide.rst @@ -32,18 +32,18 @@ Global aliases be sure to add ``require CAKE . 'functions.php'`` to you application's ``config/bootstrap.php``. -Cache ------ - -- The ``Wincache`` engine was removed. The wincache extension is not supported - on PHP 8. - Auth ---- - `Auth` has been removed. Use the `cakephp/authentication `__ and `cakephp/authorization `__ plugins instead. +Cache +----- + +- The ``Wincache`` engine was removed. The wincache extension is not supported + on PHP 8. + Console ------- @@ -81,6 +81,11 @@ Core Database -------- +- The ``DateTimeType`` and ``DateType`` now always return immutable objects. + Additionally the interface for ``Date`` objects reflects the ``ChronosDate`` + interface which lacks all of the time related methods that were present in + CakePHP 4.x. +- ``DateType::setLocaleFormat()`` no longer accepts an array. - ``Query`` now accepts only ``\Closure`` parameters instead of ``callable``. Callables can be converted to closures using the new first-class array syntax in PHP 8.1. - ``Query::execute()`` no longer runs results decorator callbacks. You must use ``Query::all()`` instead. @@ -88,10 +93,6 @@ Database - ``Driver::quote()`` was removed. Use prepared statements instead. - ``Query::orderBy()`` was added to replace ``Query::order()``. - ``Query::groupBy()`` was added to replace ``Query::group()``. -- The ``DateTimeType`` and ``DateType`` now always return immutable objects. - Additionally the interface for ``Date`` objects reflects the ``ChronosDate`` - interface which lacks all of the time related methods that were present in - CakePHP 4.x. - ``SqlDialectTrait`` has been removed and all its functionality has been moved into the ``Driver`` class itself. - ``CaseExpression`` has been removed and should be replaced with @@ -131,7 +132,11 @@ Http I18n ---- -- `Time` was renamed to `DateTime` to allow for future time-only types. +- ``Time`` was renamed to `DateTime` to allow for future time-only types. +- ``Date::parseDateTime()`` was removed. +- ``Date::parseTime()`` was removed. +- ``Date::setToStringFormat()`` and ``Date::setJsonEncodeFormat()`` no longer accept an array. +- ``Date::i18nFormat()`` and ``Date::nice()`` no longer accept a timezone parameter. - Translation files for plugins with vendor prefixed names (``FooBar/Awesome``) will now have that prefix in the file name, e.g. ``foo_bar_awesome.po`` to avoid collision with a ``awesome.po`` file from a corresponding plugin (``Awesome``).