{"componentChunkName":"component---src-templates-post-jsx","path":"/fr/inbound-outbound-processing","result":{"data":{"markdownRemark":{"html":"

Comprendre le Inbound et Outbound Processing dans Drupal : principes et exemples

\n

Introduction

\n

Dans un site Drupal, lorsqu’un utilisateur interagit avec le système (par exemple, en accédant à une URL, en soumettant un formulaire, ou en consommant une API), Drupal traite la requête via un cycle d’entrée et de sortie : c’est ce qu’on appelle les processus Inbound et Outbound.

\n

Ces deux mécanismes permettent à Drupal :

\n\n

Voyons tout cela en détail avec des exemples concrets.

\n

1. Le Inbound Processing : traiter ce qui entre

\n

Le Inbound Processing s’applique à tout ce que l’utilisateur envoie vers le système :

\n\n

Objectif

\n\n

Exemple : Modifier une URL d’entrée

\n

Imaginons qu’on souhaite rediriger les chemins /produits vers /product tout en gardant la logique interne de Drupal.

\n
use Symfony\\Component\\HttpKernel\\Event\\RequestEvent;\nuse Symfony\\Component\\EventDispatcher\\EventSubscriberInterface;\n\nclass InboundPathSubscriber implements EventSubscriberInterface {\n\n  public static function getSubscribedEvents() {\n    return ['kernel.request' => ['onKernelRequest', 30]];\n  }\n\n  public function onKernelRequest(RequestEvent $event) {\n    $request = $event->getRequest();\n    $path = $request->getPathInfo();\n\n    if ($path === '/produits') {\n      $request->server->set('REQUEST_URI', '/product');\n    }\n  }\n}
\n

Ici, nous utilisons l’événement kernel.request pour intercepter l’URL avant que Drupal ne résolve le routeur.

\n

2. Le Outbound Processing : manipuler ce qui sort

\n

Le Outbound Processing intervient lorsque Drupal génère une réponse (HTML, JSON, etc.). Il est souvent utilisé pour :

\n\n

Exemple : Réécriture dynamique des liens

\n

Supposons que vous souhaitiez transformer tous les liens /user/ID en /profil/ID lors du rendu HTML :

\n
use Drupal\\Core\\PathProcessor\\OutboundPathProcessorInterface;\nuse Symfony\\Component\\HttpFoundation\\Request;\nuse Drupal\\Core\\Render\\BubbleableMetadata;\n\nclass OutboundPathProcessor implements OutboundPathProcessorInterface {\n  public function processOutbound($path, &$options = [], Request $request = NULL, BubbleableMetadata $bubbleable_metadata = NULL) {\n    if (strpos($path, '/user/') === 0) {\n      return str_replace('/user/', '/profil/', $path);\n    }\n    return $path;\n  }\n}
\n

Déclaration dans services.yml :

\n
services:\n  my_module.path_processor.outbound:\n    class: Drupal\\my_module\\OutboundPathProcessor\n    tags:\n      - { name: path_processor_outbound, priority: 100 }
\n

Quand utiliser Inbound vs Outbound ?

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
SituationInboundOutbound
Modifier le chemin avant qu’il ne soit résoluOuiNon
Modifier un lien avant de l'afficherNonOui
Réécrire les paramètres d’une URLOuiOui
Ajouter des entêtes HTTPNonOui
Gérer la redirection conditionnelleOuiNon
\n

Utilisation combinée : cas typique d’un site multilingue

\n\n

C’est PathProcessorManager qui orchestre ces opérations dans Drupal Core.

\n

Debug & Bonnes pratiques

\n\n

Conclusion

\n

Les systèmes Inbound et Outbound dans Drupal sont des outils puissants pour contrôler le flux des données HTTP. Que vous créiez un site multilingue, headless, ou que vous souhaitiez personnaliser les chemins de votre site, ces hooks vous donnent un contrôle fin sur l’entrée et la sortie des données — sans modifier le cœur de Drupal.

","excerpt":"Comprendre le Inbound et Outbound Processing dans Drupal : principes et exemples Introduction Dans un site Drupal, lorsqu’un utilisateur interagit avec le…","frontmatter":{"date":"2025-05-12","metaDate":"2025-05-12","title":"Inbound & Outbound Processing","tags":["Drupal","Core feature","HTTP requests","Module development"],"path":"/inbound-outbound-processing","cover":{"childImageSharp":{"fluid":{"base64":"data:image/jpeg;base64,/9j/2wBDABALDA4MChAODQ4SERATGCgaGBYWGDEjJR0oOjM9PDkzODdASFxOQERXRTc4UG1RV19iZ2hnPk1xeXBkeFxlZ2P/2wBDARESEhgVGC8aGi9jQjhCY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2P/wgARCAAgABQDASIAAhEBAxEB/8QAFwAAAwEAAAAAAAAAAAAAAAAAAAIDAf/EABgBAQADAQAAAAAAAAAAAAAAAAEAAgME/9oADAMBAAIQAxAAAAGFUXry00TZ3QspQJ//xAAaEAACAwEBAAAAAAAAAAAAAAAAAQIREhBB/9oACAEBAAEFAkaHJElzNjKtynz3KP/EABURAQEAAAAAAAAAAAAAAAAAABEg/9oACAEDAQE/ASP/xAAUEQEAAAAAAAAAAAAAAAAAAAAg/9oACAECAQE/AR//xAAcEAABAwUAAAAAAAAAAAAAAAAQAAERISIxUaH/2gAIAQEABj8CMMtPCkXcVBkf/8QAHhAAAgMAAgMBAAAAAAAAAAAAAREAITFBYVGRodH/2gAIAQEAAT8hZ1G5HqMYYAI+u4QAQArFeYCEJsem3oXE0h+okjAUT5gFqV1Oz5P/2gAMAwEAAgADAAAAEG/1AP/EABcRAQEBAQAAAAAAAAAAAAAAAAEAESH/2gAIAQMBAT8QOLsOFpf/xAAWEQEBAQAAAAAAAAAAAAAAAAABACH/2gAIAQIBAT8QUsmRv//EAB0QAQEBAAICAwAAAAAAAAAAAAERACExQVFxgZH/2gAIAQEAAT8Q7n40muBl+L9zGsUp+B1hiI64eHDhoAAxxgAFphZEYThEesxg+Bc8cBL3zdxtVcdtQKKHpv/Z","aspectRatio":0.625081788440567,"src":"/static/1d4893aa934642fb4398940d90f06b8a/88110/inbound-outbound.jpg","srcSet":"/static/1d4893aa934642fb4398940d90f06b8a/0b320/inbound-outbound.jpg 480w,\n/static/1d4893aa934642fb4398940d90f06b8a/60b32/inbound-outbound.jpg 960w,\n/static/1d4893aa934642fb4398940d90f06b8a/88110/inbound-outbound.jpg 1920w,\n/static/1d4893aa934642fb4398940d90f06b8a/522de/inbound-outbound.jpg 2866w","srcWebp":"/static/1d4893aa934642fb4398940d90f06b8a/d1a9d/inbound-outbound.webp","srcSetWebp":"/static/1d4893aa934642fb4398940d90f06b8a/bc3bf/inbound-outbound.webp 480w,\n/static/1d4893aa934642fb4398940d90f06b8a/39337/inbound-outbound.webp 960w,\n/static/1d4893aa934642fb4398940d90f06b8a/d1a9d/inbound-outbound.webp 1920w,\n/static/1d4893aa934642fb4398940d90f06b8a/f0a30/inbound-outbound.webp 2866w","sizes":"(max-width: 1920px) 100vw, 1920px"},"resize":{"src":"/static/1d4893aa934642fb4398940d90f06b8a/c4f3a/inbound-outbound.jpg"}}}}}},"pageContext":{"isCreatedByStatefulCreatePages":false,"pathSlug":"/inbound-outbound-processing","locale":"fr","prev":{"fields":{"locale":"fr"},"frontmatter":{"path":"/drupal-architectures","title":"Drupal Monolithique, Découplé et Progressivement Découplé : Quelle Architecture Choisir ?","tags":["Drupal 10","Drupal 11","Architecture","Conception","Strategy"]}},"next":{"fields":{"locale":"fr"},"frontmatter":{"path":"/drupal-cms","title":"Drupal CMS 1.0 (Starshot) : Une nouvelle ère pour la création de sites web","tags":["Drupal 11","News","Drupal CMS","UX"]}}}}}