Drupal 8: une transition des crochets au répartiteur d'événements de Symfony

L'adoption par Drupal 8 de nombreux composants symfony signifie une éloignement des méthodologies drupales traditionnelles vers des modèles architecturaux PHP contemporains. Cette transition consiste à remplacer progressivement le système de crochets par des plugins, des annotations et le puissant répartiteur d'événements Symfony.

Le répartiteur d'événements Symfony permet aux composants d'application d'interagir par des événements de répartition et de manipulation, offrant un mécanisme d'extension plus flexible et découplé que le système de crochet procédural. Drupal 8 exploite cela en utilisant des classes d'abonnés d'événements qui écoutent des événements spécifiques. Ces classes mettent en ?uvre EventSubscriberInterface et définissent une méthode getSubscribedEvents, renvoyant un tableau d'événements auxquels ils s'abonnent.

Alors que les crochets persistent dans Drupal 8, leur utilisation a diminué car beaucoup ont été remplacés par des plugins, des annotations et le répartiteur d'événements. Cependant, les crochets restent cruciaux pour certaines interactions centrales. La recommandation est de favoriser le répartiteur d'événements Symfony chaque fois que ce qui est possible, en raison de sa flexibilité et de ses capacités améliorées, y compris la priorisation de l'écouteur, l'arrêt de la propagation des événements et la modification des données d'événements. (Remarque: les exemples de code dans l'article d'origine peuvent nécessiter des mises à jour en raison du développement de Drupal 8 en cours.)

Comprendre le répartiteur des événements

Le répartiteur d'événements Symfony, tel que décrit sur le site Web de Symfony, fournit des outils pour les composants d'application pour communiquer via la répartition et l'écoute d'événements. Cet article se concentre sur son implémentation Drupal 8. (Reportez-vous à la documentation Symfony pour une compréhension complète de ses principes.)

Un exemple pratique: le module event_dispatcher_demo

Cet exemple démontre le répartiteur d'événements dans un module Drupal 8 personnalisé (event_dispatcher_demo). Ce module comprend un formulaire de configuration avec deux champs. Lors de l'enregistrement, un événement contenant l'objet de configuration est envoyé, permettant à d'autres composants de l'intercepter et de le modifier avant la persistance. Enfin, un abonné à l'événement démontre l'écoute et la réaction de cet événement. (Pour les bases du développement du module Drupal 8, consultez les tutoriels pertinents.)

la forme (DemoForm.php)

Un formulaire de configuration simple avec deux champs de texte (my_name et my_website) est créé. Un itinéraire (event_dispatcher_demo.routing.yml) permet d'accéder via une URL (par exemple, /demo-form).

L'intégration du répartiteur des événements (DemoForm.php)

Le gestionnaire de soumission du formulaire (submitForm) comprend désormais:

1. Récupération du service de répartiteur des événements: $dispatcher = Drupal::service('event_dispatcher'); (l'injection de dépendance est préférée dans le code de production).
2. Création d'un objet DemoEvent (une classe d'événements personnalisée étendant la classe Event de Symfony) et passant l'objet de configuration.
3. Envoiant l'événement: $dispatcher->dispatch('demo_form.save', $e);
4. récupérer la configuration modifiée de l'événement renvoyé et l'enregistrer.

La classe DemoEvent (DemoEvent.php) maintient simplement l'objet de configuration et fournit des méthodes Getter / Setter.

L'abonné de l'événement (ConfigSubscriber.php)

Cette classe implémente EventSubscriberInterface. getSubscribedEvents enregistre la méthode onConfigSave pour écouter l'événement demo_form.save. onConfigSave Ajoute une nouvelle valeur de configuration basée sur celles existantes. Une définition de service (event_dispatcher_demo.services.yml) avec la balise event_subscriber enregistre cet abonné.

crochets dans Drupal 8

Pour la comparaison, l'exemple montre également comment obtenir des fonctionnalités similaires à l'aide de crochets. La méthode submitForm est modifiée pour invoquer le crochet demo_config_save à l'aide du service module_handler. Un exemple d'implémentation de crochet (event_dispatcher_demo.module) montre l'ajout d'une valeur de configuration.

Conclusion

Le répartiteur d'événements Symfony fournit une approche plus robuste et maintenable pour étendre les fonctionnalités de Drupal 8 par rapport au système de crochet traditionnel. Bien que les crochets restent, le répartiteur d'événements est la méthode recommandée pour le nouveau développement, offrant une meilleure flexibilité, une meilleure organisation et une organisation de code. Le changement reflète l'adoption par Drupal des meilleures pratiques de PHP modernes.

Questions fréquemment posées (FAQ)

La section FAQ de l'article d'origine est déjà bien structurée et répond de manière complète aux questions courantes concernant les différences et l'utilisation des crochets Drupal 8 et le répartiteur d'événements Symfony. Aucun changement n'est nécessaire ici.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!