Pourquoi la configuration du plugin est portée par le bundle¶
Cette page explique pourquoi le plugin web porte lui-même sa configuration de conteneur, et pourquoi une petite partie du câblage reste malgré tout au niveau de l'application. Elle prolonge Architecture des plugins de diffusion (le pourquoi d'un plugin amovible) et la section « Pourquoi les plugins sont des Symfony Bundles isolés » d'Architecture, sans les répéter. Pour comment installer, voir le guide Installer le plugin web sur une instance ; pour quoi exactement, la Référence : configuration du plugin web.
Le bundle porte sa config de conteneur (prependExtension)¶
La contrainte fondatrice des plugins est qu'on doit pouvoir les ajouter ou les retirer sans toucher au cœur. Si le cœur devait connaître le mapping Doctrine du plugin, son transport Messenger, son pool de cache ou son namespace de composants Twig, alors chaque plugin laisserait des traces dans config/ — et supprimer un plugin voudrait dire chasser ces traces une à une, en risquant d'en oublier.
La méthode prependExtension() de KirexoPluginWebBundle déplace cette configuration dans le bundle lui-même : elle est injectée dans le conteneur au moment où le bundle est chargé, avant les extensions. Le cœur n'a donc rien à déclarer. Retirer le plugin, c'est retirer une ligne de config/bundles.php : sa configuration part avec lui, mécaniquement. C'est la déclinaison, au niveau du conteneur, du principe « le supprimer ne casse rien » exposé dans Architecture des plugins de diffusion.
Le même mouvement porte les défauts d'environnement : le manifeste ENV_VARS du bundle est l'unique source des valeurs par défaut (posées au prepend) et de la validation au boot des variables requises. Le cœur n'a pas à connaître les variables d'un plugin pour qu'elles aient un défaut fonctionnel.
Corollaire de cohérence : les chemins sont calculés depuis le bundle (__DIR__), jamais via %kernel.project_dir%. La configuration reste juste si le plugin devient un jour un paquet installé sous vendor/ — l'horizon composer require kirexo/plugin-<nom> décrit dans Architecture des plugins de diffusion.
Pourquoi routes et importmap restent au niveau app¶
Deux éléments ne passent pas par prependExtension, parce qu'ils ne sont pas des extensions de conteneur : le routing et l'importmap. Symfony ne les auto-importe pas depuis un bundle sans une recipe Flex — et le plugin web, bundle de monorepo, n'en fournit pas.
Le compromis retenu est une procédure documentée minimale plutôt qu'une recipe :
- Routes. Le bundle possède sa ressource de routing (
src/Plugin/Web/config/routes.yaml) : c'est elle qui scanne ses controllers. Côté application, il reste une unique ligne d'import (resource: '@KirexoPluginWebBundle/config/routes.yaml'). L'app importe, le bundle scanne : la logique de routing n'est pas dupliquée dans le cœur. - Importmap. L'entrypoint
sitedu plugin est déclaré dans l'importmap.phpracine. L'installation se limite à vérifier sa présence.
Ce résidu de câblage app-level est volontairement le plus petit possible : une ligne d'import et une vérification, sans configuration Doctrine / Messenger / cache à recopier. C'est ce qui rend l'installation « simple », et vérifiable objectivement par la checklist du guide d'installation.
Voir aussi¶
- Architecture des plugins de diffusion — pourquoi un plugin est un bundle isolé et amovible.
- Architecture — les choix structurants de la plateforme.
- Installer le plugin web sur une instance — la marche à suivre.
- Référence : configuration du plugin web — la surface de configuration exhaustive.