Skip to content

Document Table::findUnhydrated() and SelectUnhydratedQuery#8305

Merged
markstory merged 1 commit into
5.nextfrom
docs-find-unhydrated
May 24, 2026
Merged

Document Table::findUnhydrated() and SelectUnhydratedQuery#8305
markstory merged 1 commit into
5.nextfrom
docs-find-unhydrated

Conversation

@dereuromark
Copy link
Copy Markdown
Member

Docs for cakephp/cakephp#19441Table::findUnhydrated() + SelectUnhydratedQuery.

Changes

  • orm/retrieving-data-and-resultsets: new "Getting Arrays Instead of Entities" subsection documenting findUnhydrated() as the type-safe way to get array results, with notes on finder reuse, the findList()/findThreaded() hydration-neutral caveat, and the disableHydration() deprecation.
  • Updated the buffered-results note and the two mapReduce() examples to use findUnhydrated() instead of the deprecated find()->disableHydration().
  • appendices/5-4-migration-guide: added the disableHydration() deprecation under Deprecations → ORM, and the findUnhydrated() / SelectUnhydratedQuery addition under New Features → ORM.

Targets 5.next since the feature ships in 5.4.0.

Adds a 'Getting Arrays Instead of Entities' section covering findUnhydrated()
as the type-safe replacement for find()->disableHydration(), updates the
buffered-results and mapReduce examples to use it, and records the new
feature plus the disableHydration() deprecation in the 5.4 migration guide.
@dereuromark dereuromark added this to the 5.next milestone May 21, 2026
@markstory markstory merged commit 5a46306 into 5.next May 24, 2026
6 checks passed
@markstory markstory deleted the docs-find-unhydrated branch May 24, 2026 15:47
@dereuromark
Copy link
Copy Markdown
Member Author

Note: Core PR is still pending, though

PS: this PR was slightly outdated, made the commit on top: 6eb9405

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants