🔁 Symfony Reprise 1.0 : Vite et Rsbuild remplacent Webpack Encore

📚 Introduction

Webpack Encore a rendu un service énorme à l’écosystème Symfony : pendant près de dix ans, il a évité à des générations de développeurs PHP de configurer Webpack à la main. Mais Webpack lui-même a pris de l’âge face à Vite et aux bundlers basés sur Rust ou Go, et Encore restait figé sur cette base.

Symfony Reprise, publié en version 1.0.0 le 26 août 2026, prend le relais. Ce n’est pas un nouveau bundler : c’est une fine couche de compatibilité qui branche Vite ou Rsbuild sur Symfony, exactement au même endroit où intervenait Encore. Le composer.json du projet le dit sans détour : « a reprise of Webpack Encore Bundle ».

Le passage de l’état expérimental à la 1.0 n’est pas anodin non plus : l’API publique suit désormais le versionnage sémantique et entre dans la promesse de compatibilité ascendante de Symfony, ce qui en fait un candidat sérieux pour un vrai projet, pas seulement pour un essai.

🔎 Qu’est-ce que Symfony Reprise, concrètement ?

Reprise ne compile rien lui-même. Il ajoute la « glue Symfony » qu’un bundler générique ne fournit pas : génération de entrypoints.json et manifest.json, intégrité des sous-ressources (SRI), et des fonctions Twig pour afficher les balises correspondant à un point d’entrée. Le travail de bundling reste entièrement à la charge de Vite ou de Rsbuild.

Concrètement, deux paquets à installer :

composer require symfony/reprise
npm install @symfony/reprise --save-dev

Puis le plugin s’enregistre dans la configuration du bundler choisi :

// vite.config.ts
import { defineConfig } from 'vite';
import Symfony from '@symfony/reprise/vite';
 
export default defineConfig({
	build: {
		rolldownOptions: {
			input: {
				app: './assets/app.js'
			}
		}
	},
	plugins: [Symfony({})]
});

Côté Rsbuild, la même logique avec @symfony/reprise/rsbuild et l’entrée déclarée dans source.entry.

🧩 Rendre les assets en Twig

Côté Symfony, la configuration par défaut tient dans config/packages/reprise.yaml :

reprise:
  output_path: '%kernel.project_dir%/public/build'
  builds: {}
  strict_mode: true
  cache: false
  crossorigin: false
  preload: true

strict_mode: true par défaut : Reprise lève une exception si entrypoints.json ou l’entrée demandée est manquante, plutôt que de rendre silencieusement une page sans assets. Et le rendu dans base.html.twig reprend presque à l’identique la syntaxe d’Encore :

{% block stylesheets %}
    {{ reprise_entry_link_tags('app') }}
{% endblock %}
 
{% block javascripts %}
    {{ reprise_entry_script_tags('app') }}
{% endblock %}

Un point d’entrée optionnel se protège simplement :

{% if reprise_entry_exists('checkout') %}
    {{ reprise_entry_script_tags('checkout') }}
{% endif %}

🔒 Intégrité, CDN et Stimulus

Trois fonctionnalités héritées d’Encore, mais avec une configuration qui passe désormais par le bundler plutôt que par des méthodes enableXxx() :

Subresource Integrity. Symfony({ integrity: { enabled: command === 'build', algorithms: ['sha384'] } }) calcule les hashes sha256, sha384 ou sha512 de chaque fichier généré, exposés ensuite dans entrypoints.json sous la clé integrity et injectés automatiquement dans les balises Twig.

CDN et chemin public. publicPath pointe vers l’URL du CDN en production (https://mon-cdn.fastly.net/build/) et reste local en dev ; manifestKeyPrefix devient alors obligatoire pour que le manifeste garde des clés cohérentes.

Pont Stimulus. Symfony({ stimulus: 'assets/controllers.json' }) retrouve la logique du Stimulus Bridge d’Encore : les contrôleurs sous assets/controllers/*_controller.js s’enregistrent automatiquement, hello_controller.js devenant l’identifiant hello et admin/user_controller.js devenant admin--user. Le chargement paresseux se marque avec un commentaire /* stimulusFetch: 'lazy' */ dans le contrôleur. Si votre projet utilise déjà Symfony UX, rien ne change côté Stimulus ou Twig Components : seule la brique de bundling change sous le capot.

🔁 Migrer depuis Webpack Encore

La documentation officielle fournit une table de correspondance quasi fonction par fonction. Les cas les plus fréquents :

La bascule n’est donc pas un simple changement de nom de fonction : Encore configurait Webpack pour vous (Sass, PostCSS, TypeScript, React, alias, variables globales), alors que Vite et Rsbuild gèrent tout ça nativement ou via leurs propres plugins. Migrer un projet Encore existant revient à reconstruire sa configuration de build avec les outils natifs du bundler choisi, puis à ne garder de Reprise que la partie rendu Twig.

⚠️ Quelques précautions

PHP 8.4 minimum. Le composer.json de Reprise fixe la barre à PHP 8.4 et Symfony 7.4 ou 8.0 : pas question de l’installer sur un projet encore en PHP 8.2 ou Symfony 6.x sans monter de version au préalable.

Le projet vient tout juste d’atteindre sa 1.0. Les huit versions 0.x qui précèdent (de 0.2.0 à 0.8.0) montrent une API qui a bougé pendant la phase expérimentale. La 1.0.0 fige le contrat public, mais l’historique de production reste court comparé aux dix ans d’Encore.

Ce n’est pas un remplacement automatique. Reprise ne migre rien pour vous : il faut réécrire la configuration de build (entrées, préprocesseurs CSS, TypeScript, alias) dans la syntaxe de Vite ou de Rsbuild. Sur un projet Encore avec beaucoup de enableXxx() custom, prévoir un vrai chantier plutôt qu’un remplacement de dépendance.

🎉 Conclusion

Symfony Reprise fait exactement ce que son nom promet : une reprise, pas une réinvention. La syntaxe Twig reste familière pour qui a utilisé Encore, la configuration se déplace simplement du PHP vers le fichier du bundler. Le vrai changement est en dessous : Vite et Rsbuild démarrent en une fraction du temps qu’Encore mettait sur un projet volumineux, avec un vrai hot module replacement.

Pour un nouveau projet Symfony, Reprise avec Vite est aujourd’hui le choix par défaut raisonnable. Pour un projet existant sous Encore, la 1.0 donne enfin la stabilité d’API nécessaire pour planifier la migration sereinement, sans craindre de reconfigurer une deuxième fois dans les mois qui suivent.

🔗 Liens utiles

• Annonce officielle Symfony Reprise 1.0.0
• Documentation Symfony Reprise
• Dépôt GitHub symfony/reprise
• Package Composer symfony/reprise
• Symfony UX : interfaces réactives en Twig, sans framework JS