Skip to content

Document attribute resolver and related PhpEngine#8296

Open
josbeir wants to merge 3 commits into6.xfrom
6.x-attribute-resolver
Open

Document attribute resolver and related PhpEngine#8296
josbeir wants to merge 3 commits into6.xfrom
6.x-attribute-resolver

Conversation

@josbeir
Copy link
Copy Markdown
Contributor

@josbeir josbeir commented May 7, 2026

Adds documentation for the AttributeResolver system introduced in CakePHP 6.0 (cakephp/cakephp#19206, cakephp/cakephp#19293) and the new PhpEngine cache engine.

A new core-libraries/attribute-resolver.md page covers configuration, the AttributeCollection filter API, AttributeInfo and AttributeTarget value objects, multiple named configurations, caching with PhpEngine, cache warming and automation strategies, all three console commands (attributes list, attributes inspect, attributes warm), plugin scanning behaviour, and a custom integration example.

The caching page gains a PhpEngine entry in the engine list and a dedicated options section explaining OPcache-backed reads and the limitations around atomic operations.

The attribute routing page is updated with a cross-reference to the new page, and "file-based routing" is renamed to "config-based routing" throughout. The sidebar TOC is updated to include the new page under Core Libraries.

@josbeir josbeir self-assigned this May 7, 2026
Copilot AI review requested due to automatic review settings May 7, 2026 08:28
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds new CakePHP 6.0 documentation for the AttributeResolver system and documents the new OPcache-backed PhpEngine cache engine, with cross-links and sidebar navigation updates.

Changes:

  • Adds a new Core Libraries page documenting AttributeResolver configuration, querying/filtering APIs, caching/warming, and console commands.
  • Extends caching documentation with the Php cache engine overview and a dedicated PhpEngine options section.
  • Adds a cross-reference from Attribute Routing and updates the English sidebar TOC to include the new page.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

File Description
docs/en/development/attribute-routing.md Adds a cross-reference to the new Attribute Resolver page near the “Getting Started” section.
docs/en/core-libraries/caching.md Documents the new Php cache engine and adds a PhpEngine options section + notes about non-atomic increment/decrement.
docs/en/core-libraries/attribute-resolver.md New documentation page covering configuration, APIs, caching/warming strategies, CLI commands, and plugin scanning behavior.
.vitepress/toc_en.json Adds “Attribute Resolver” to the Core Libraries sidebar section.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/en/development/attribute-routing.md
Comment thread docs/en/core-libraries/attribute-resolver.md Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants