Symfony : UX Turbo et Mercure
Le temps rĂ©el de Symfony repose sur Mercure, un protocole ouvert et non une invention maison. Les mises Ă jour arrivent au navigateur en HTTP ordinaire, sous forme de Server-Sent Events, et nâimporte quel client peut sây abonner, pas seulement un front Symfony.
composer require symfony/mercure-bundle
# Mercure hub runs as a small standalone binary, or via Docker
use Symfony\Component\Mercure\HubInterface;
use Symfony\Component\Mercure\Update;
class OrderController
{
public function ship(Order $order, HubInterface $hub): Response
{
$order->markShipped();
$hub->publish(new Update(
"orders/{$order->getId()}",
json_encode(['status' => 'shipped']),
));
return new Response('OK');
}
}
Turbo, par le paquet symfony/ux-turbo, abonne la page à cette mise à jour et remplace le fragment HTML concerné. Un attribut de données tient lieu de JavaScript écrit à la main :
<turbo-stream-source src="{{ mercure('orders/' ~ order.id) }}"></turbo-stream-source>
<div id="order-{{ order.id }}-status">
{{ order.status }}
</div>
Quand le serveur diffuse une mise à jour Turbo Stream correspondante, Turbo remplace ce <div> sur place. Pas de rechargement, pas de code client à écrire.
Quand le choisir
Un projet Symfony qui veut des mises Ă jour en direct sans framework JavaScript sĂ©parĂ©, et en particulier un projet oĂč un protocole ouvert, fondĂ© sur HTTP, compte pour des raisons dâinfrastructure ou de conformitĂ©.
Quand ce nâest pas le bon outil
Un trafic bidirectionnel à haute fréquence : une interaction multijoueur en direct, un tableau de bord de trading rafraßchi plusieurs fois par seconde. Les Server-Sent Events ne vont que dans un sens, par conception, et une connexion WebSocket convient mieux à ce travail.
Sous le capot : les Server-Sent Events sont une fonctionnalitĂ© HTTP ordinaire : une rĂ©ponse longue qui continue dâenvoyer des morceaux au fil du temps. Mercure bĂątit un hub complet de publication et dâabonnement sur cette seule primitive, et câest pourquoi il traverse lâinfrastructure HTTP habituelle (proxies, rĂ©partiteurs de charge) lĂ oĂč un WebSocket brut rĂ©clame parfois une configuration Ă part.