khanh.pndc/nextcloud-docs
1
0
Fork 0
mirror of https://github.com/nextcloud/documentation.git synced 2026-01-02 17:59:36 +07:00
Code Issues Packages Projects Releases Wiki Activity

feat(nc-upgrade-33): Add notes related to IResult::fetch/fetchAll

Browse Source 
Signed-off-by: Carl Schwan <carl.schwan@nextcloud.com>
This commit is contained in:
Carl Schwan
2025-11-19 11:04:02 +01:00
parent 98c138e6a3
commit 0362f3cd15
1 changed files with 17 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_33.rst
View File

@@ -88,7 +88,17 @@ Added Events
Added APIs
^^^^^^^^^^
- TBD
- We now expose ``\OCP\DB\IResult::iterateAssociative``, ``\OCP\DB\IResult::iterateNumeric`` from doctrine/dbal.
These two methods returns iterators that can be directly used in a `foreach` to iterate over a SQL query result.
For example:
.. code-block:: php
$result = $qb->executeQuery();
foreach ($result->iterateAssociative() as $row) {
$id = $row['id'];
}
$result->closeCursor();
Changed APIs
^^^^^^^^^^^^
@@ -98,7 +108,12 @@ Changed APIs
Deprecated APIs
^^^^^^^^^^^^^^^
- TBD
- The ``\OCP\DB\IResult::fetch`` and ``\OCP\DB\IResult::fetchAll`` are soft-deprecated. Instead you can use
``\OCP\DB\IResult::fetchAssociative``, ``\OCP\DB\IResult::fetchNumeric`` and ``\OCP\DB\IResult::fetchOne``
as replacement for ``\OCP\DB\IResult::fetch``; and ``\OCP\DB\IResult::fetchAllAssociative``,
``\OCP\DB\IResult::fetchAllNumeric`` and ``\OCP\DB\IResult::fetchFirstColumn`` as replacement for
``\OCP\DB\IResult::fetchAll``. If you use rector, you can use the Nextcloud33 set, to automatically port
most of your code to the new methods.
Removed APIs
^^^^^^^^^^^^