Mastering Object-Oriented Hooks in Drupal 11: How to Use Hook Service Classes Effectively

Staff Reporter

Drupal 11.1.0 introduces a major shift in its extensibility model with the rollout of object-oriented (OOP) service hooks, replacing the long-standing procedural hook system. Phil Norton of Hashbang Code outlines this transition, emphasizing improved testability, modularity, and developer experience.

The new system lets developers register hooks as PHP attributes in service classes, enabling automatic dependency injection and unit testing. Norton walks through defining hooks via class or method attributes, stacking hooks, and leveraging the #[LegacyHook] attribute for backward compatibility. Developers can now explicitly test hooks using PHPUnit, avoiding complex setups previously required for procedural functions.

While all major hooks are expected to adopt this OOP approach, Norton notes some exceptions may persist for install/update routines. He urges module maintainers to adopt OOP hooks early while maintaining legacy compatibility where necessary. The article concludes with a full example of defining and using a custom hook in the new system.

Reference: Drupal 11: Object Oriented Hooks And Hook Service Classes by Phil Norton, #! code (Hash Bang Code) (3 August 2025)

Drupal 11

Dependency Injection

Disclosure: This content is produced with the assistance of AI.

Disclaimer: The opinions expressed in this story do not necessarily represent that of TheDropTimes. We regularly share third-party blog posts that feature Drupal in good faith. TDT recommends Reader's discretion while consuming such content, as the veracity/authenticity of the story depends on the blogger and their motives.

Note: The vision of this web portal is to help promote news and stories around the Drupal community and promote and celebrate the people and organizations in the community. We strive to create and distribute our content based on these content policy. If you see any omission/variation on this please reach out to us at #thedroptimes channel on Drupal Slack and we will try to address the issue as best we can.