Skip to content

Document opt-in model table resolution from Source attributes - #351

Open
QUAD69 wants to merge 1 commit into
phalcon:masterfrom
QUAD69:docs-source-attribute
Open

QUAD69 wants to merge 1 commit into
phalcon:masterfrom
QUAD69:docs-source-attribute

Conversation

@QUAD69

@QUAD69 QUAD69 commented Nov 8, 2026

Copy link
Copy Markdown

Document the model-table integration of Source from phalcon/cphalcon#17742, as requested in its review: phalcon/cphalcon#17742 (comment).

The model guide now shows how to select AttributesReader before using #[Source], explains named and positional arguments, explicit-source precedence, table prefixes, per-class caching, and inheritance. The annotations guide links to that section. The default PHPDoc reader and @Source remain unchanged.

An availability note explicitly says that this behavior is not in Phalcon 5.23.0 and requires a release containing the framework fix. The framework PR is still under review, so the note avoids presenting unreleased functionality as part of the existing release.

Related: phalcon/cphalcon#17741, phalcon/cphalcon#17742.

Validation:

  • Both changed pages compile with @mdx-js/mdx.
  • pnpm build passes (3001 pages built).
  • pnpm lint:docs passes (3002 files lint clean).
  • The literal PHP usage example was executed against the patched extension and returns accounting_invoices.
  • git diff --check passes.

Only the two manual pages in docs-5.23 change; generated API pages, routes and earlier versions are untouched.

Describe reader configuration, source precedence, prefixes and inheritance
for the model table resolution fix in phalcon/cphalcon#17742. Link the
annotations guide to the model guide and state the release requirement.

Assisted-by: Codex

This branch has not been deployed

No deployments
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.

1 participant