Problem/Motivation
"Entity handlers" are classes that provide different sorts of functionality for entity types: storage, listing, access control, and so on. They used to be called "controllers" but were renamed because this caused confusion with routing controllers. See #1976158: Rename entity storage/list/form/render "controllers" to handlers.
Currently, however, there is not really any place in our documentation that explains what "handlers" are, and there are still some incorrect references to "controllers".
Proposed resolution
- Update the Entity API documentation topic to refer to "handlers" instead of controllers where appropriate, and add a brief explanation of what a "handler" is.
- Update the docblocks for EntityHandlerInterface and EntityHandlerBase to
briefly explain what a "handler" is, andreference the group documentation for more detail. [Note: see comment #1, where it was suggested just to reference the group documentation for more detail.] - Check for other places in documentation that might still inappropriately refer to "controllers" that are actually entity handlers. Note that most references to "controller" in the Drupal codebase are correct and refer instead to routing controllers.
Remaining tasks
User interface changes
API changes
Beta phase evaluation
Issue category | Bug because we fix wrong documentation. |
---|---|
Issue priority | Normal because the impact is very limited. |
Unfrozen changes | Unfrozen because it only changes documentation of the entity API. |
Prioritized changes | None |
Disruption | None |