Merge pull request #7651 from cakephp/5.x-events

5.x: add doc for recommended event handler usage and new log scopes
cakephp · Jul 16, 2023 · c17f423 · c17f423
2 parents 65e9883 + 965aceb
commit c17f423
Showing 1 changed file with 3 additions and 0 deletions.
diff --git a/en/appendices/5-0-migration-guide.rst b/en/appendices/5-0-migration-guide.rst
@@ -102,6 +102,7 @@ Database
   ``QueryExpression::case()`` or ``CaseStatementExpression``
 - ``Connection::connect()`` has been removed. Use
   ``$connection->getDriver()->connect()`` instead.
+- ``cake.database.queries`` has been added as an alternative to the ``queriesLog`` scope
 
 Datasource
 ----------
@@ -113,6 +114,7 @@ Event
 -----
 
 - Event payloads must be an array. Other object such as ``ArrayAccess`` are no longer cast to array and will raise a ``TypeError`` now.
+- It is recommended to adjust event handlers to be void methods and use ``$event->setResult()`` instead of returning the result
 
 Error
 -----
@@ -157,6 +159,7 @@ Mailer
 ------
 
 - ``Email`` has been removed. Use `Mailer <https://book.cakephp.org/5/en/core-libraries/email.html>`__ instead.
+- ``cake.mailer`` has been added as an alternative to the ``email`` scope
 
 ORM
 ---