Maintenance Symfony

Performance d’une application Symfony : diagnostiquer et optimiser

Une application Symfony lente se corrige rarement au hasard : il faut d’abord mesurer où le temps est perdu, puis traiter les causes dans l’ordre de leur impact. Cette page détaille les outils de mesure, les causes fréquentes, la configuration de production et la méthode pour optimiser une application Symfony sans régression.

Mesurer avant d’optimiser.

La plupart des lenteurs viennent de quelques points connus : requêtes Doctrine, cache absent, tâches lourdes exécutées pendant la requête, configuration de production incomplète.

En bref

La performance Symfony se travaille en quatre temps : mesurer, prioriser, corriger, vérifier. On mesure avec le profiler Symfony et la barre de débogage en développement, avec un outil de profilage ou d’APM et les journaux de requêtes lentes en production. Les causes les plus fréquentes d’une application Symfony lente sont les requêtes Doctrine trop nombreuses (problème N+1) ou trop lourdes, les index manquants en base, les traitements lourds exécutés pendant la requête au lieu de passer par Messenger, et l’absence de cache HTTP ou applicatif. Une configuration de production complète (environnement prod, OPcache, autoloader Composer optimisé, cache préchauffé) est le premier contrôle à faire.

Définition

Ce que recouvre la performance d’une application Symfony

La performance d’une application Symfony est le temps nécessaire pour répondre à une requête et la charge que l’application supporte sans se dégrader. Elle se juge sur le temps de réponse du serveur, sur le nombre de requêtes à la base de données, sur la mémoire consommée et sur la stabilité de ces indicateurs quand le trafic augmente.

Symfony lui-même est rarement la cause d’une lenteur : un framework bien configuré en production ajoute peu de temps à une requête. Ce qui coûte, c’est ce que l’application fait pendant cette requête : interroger la base, appeler des API tierces, générer des documents, envoyer des e-mails, hydrater des milliers d’objets.

Optimiser une application Symfony, c’est donc supprimer le travail inutile (requêtes en double, calculs répétés), reporter le travail différable (traitements asynchrones) et réutiliser le travail déjà fait (cache). Cette page complète notre page maintenance Symfony, qui traite du maintien en condition opérationnelle dans la durée.

Mesurer

Comment mesurer la performance d’une application Symfony

On mesure la performance Symfony à deux endroits : en développement, pour comprendre une page précise, et en production, pour voir ce que vivent réellement les utilisateurs. Voici les outils que nous utilisons pour chaque besoin.

Profiler et barre de débogage

En environnement de développement, la barre de débogage web et le profiler Symfony affichent pour chaque requête le temps total, la mémoire, le nombre de requêtes Doctrine avec leur SQL, les appels HTTP sortants, les événements et le rendu Twig. C’est le premier outil pour repérer un N+1.

Composant Stopwatch

Le composant Stopwatch chronomètre des portions de code choisies. Les mesures apparaissent dans la chronologie du profiler, ce qui isole le coût d’un service, d’un calcul métier ou d’un appel à une API tierce.

Profilage et APM en production

Un outil de profilage ou de suivi des performances applicatives (APM), comme Blackfire, Tideways, New Relic ou Datadog, cités comme exemples, mesure les requêtes réelles en production et montre les fonctions et les appels les plus coûteux.

Journal des requêtes lentes

MySQL, MariaDB et PostgreSQL peuvent journaliser les requêtes qui dépassent un seuil de durée. Ce journal, complété par la commande EXPLAIN, montre les requêtes qui manquent d’index ou parcourent trop de lignes.

Journaux Monolog

Des journaux Monolog structurés, avec un canal dédié aux appels externes et aux traitements longs, gardent la trace des durées et des erreurs en production, là où le profiler n’est pas activé.

Métriques du serveur

Charge processeur, mémoire, processus PHP-FPM occupés, connexions à la base, longueur des files Messenger : ces métriques disent si la lenteur vient du code, de l’infrastructure ou d’une saturation ponctuelle.

Le profiler et la barre de débogage ne doivent jamais être actifs en production : ils exposent des informations internes et ralentissent chaque requête. En production, on mesure avec des outils prévus pour cet usage. Ces mesures sont le point de départ de notre audit d’application Symfony.

Causes

Pourquoi une application Symfony est lente : causes fréquentes et corrections

Une application Symfony lente présente presque toujours l’un de ces symptômes. Chaque ligne associe ce que l’on observe, la cause la plus courante et la correction habituelle.

SymptômeCause fréquenteCorrection
Des dizaines ou des centaines de requêtes SQL sur une seule pageProblème N+1 : des relations Doctrine chargées à la demande (lazy loading) dans une boucle ou un template TwigJointures avec addSelect dans le QueryBuilder, mode de chargement adapté sur la relation, requête dédiée à l’écran
Page lente et forte consommation de mémoire sur les listes ou les exportsHydratation de milliers d’entités complètes alors que quelques champs suffisentRequêtes ciblées sur les champs utiles, résultats en tableaux ou en DTO, pagination, traitement par lots pour les exports
Une requête SQL lente, même seuleIndex manquant sur une colonne de filtre, de tri ou de jointureAnalyse avec EXPLAIN, index ajouté par une migration Doctrine, requête réécrite si besoin
Clic sur « Valider » qui attend plusieurs secondesTraitement lourd exécuté pendant la requête : envoi d’e-mails, génération de PDF, appel à une API tierce, synchronisationEnvoi d’un message Messenger traité en asynchrone par un worker ; l’utilisateur reçoit la réponse tout de suite
Pages identiques recalculées à chaque visiteAucun cache HTTP : en-têtes de cache absents ou réponses toujours privéesEn-têtes Cache-Control adaptés, reverse proxy (HttpCache de Symfony, Varnish ou un CDN), ESI pour les fragments qui varient
Calculs coûteux ou appels externes répétésRésultats jamais mis en cache côté applicationPools de cache Symfony avec un adaptateur adapté (Redis, APCu), clés et durées de vie maîtrisées, invalidation par tags
Temps de base élevé sur toutes les pagesOPcache absent ou mal réglé, environnement de debug actif en productionOPcache activé et dimensionné, préchargement (preloading) avec le fichier généré par Symfony, APP_ENV=prod et APP_DEBUG=0
Temps perdu à charger les classesAutoloader Composer non optimisécomposer dump-autoload --optimize, voire --classmap-authoritative, lors du déploiement
Première requête très lente après chaque déploiementCache du conteneur et des templates construit à la demandeCache compilé de production généré au déploiement avec cache:warmup, avant la bascule
Pages lourdes à afficher côté navigateurFichiers CSS et JavaScript non minifiés, non versionnés, images trop lourdesAssets compilés et versionnés (AssetMapper ou Webpack Encore), images redimensionnées, cache navigateur long

Causes et corrections usuelles sur les applications Symfony avec Doctrine. L’ordre de traitement dépend des mesures : on corrige d’abord ce qui pèse le plus sur les pages les plus utilisées.

Questions fréquentes

Doctrine et performance Symfony : vos questions

Qu’est-ce que le problème N+1 avec Doctrine ?

C’est une requête pour charger une liste, puis une requête supplémentaire par élément pour charger une relation. Il apparaît quand on parcourt des entités et qu’on accède à une relation chargée à la demande. Le profiler le révèle par un grand nombre de requêtes presque identiques.

Non. Le chargement immédiat systématique charge des données inutiles sur les autres écrans. Il vaut mieux garder le chargement à la demande par défaut et écrire, pour chaque écran qui en a besoin, une requête avec les jointures nécessaires.

Doctrine convient aux gros volumes si on l’utilise en conséquence. Pour un export ou un traitement de masse, on lit par lots, on vide régulièrement le gestionnaire d’entités et on préfère des résultats en tableaux. Une requête SQL directe reste possible pour un cas très ciblé.

Oui. En production, les métadonnées des entités et le résultat de l’analyse des requêtes DQL doivent être mis en cache, ce que prévoit la configuration de production. Le cache de résultats est un choix au cas par cas, pour des données qui changent peu.

Check-list

Check-list de configuration de production pour une application Symfony

Avant de modifier le code, on vérifie que l’application tourne avec une configuration de production complète. Ces points corrigent souvent une partie de la lenteur sans toucher à une ligne métier :

Méthode

Optimiser une application Symfony en quatre étapes

01

Mesurer

On établit une base de référence : temps de réponse des pages et des routes d’API les plus utilisées, nombre de requêtes SQL, mémoire, requêtes lentes en base, longueur des files Messenger. Sans cette base, impossible de savoir si une correction a servi.

02

Prioriser

On classe les problèmes selon leur impact réel : une page lente très consultée passe avant un export mensuel. On sépare les gains rapides (configuration, index, cache) des chantiers plus longs (refonte d’une requête, passage en asynchrone).

03

Corriger

Chaque correction est développée dans une branche, couverte par les tests PHPUnit existants ou par un nouveau test, relue, puis déployée en préproduction. Un changement de schéma, comme un index, passe par une migration Doctrine.

04

Vérifier

On mesure à nouveau avec les mêmes outils et les mêmes scénarios, en préproduction puis en production. Le gain est documenté ; s’il n’est pas au rendez-vous, la correction est revue avant de passer au point suivant.

Surveillance

La performance Symfony dans la maintenance courante

La performance se surveille dans la durée : une application rapide aujourd’hui peut ralentir demain, à mesure que les données grossissent, que des fonctionnalités s’ajoutent ou qu’une dépendance change. C’est pourquoi nous l’intégrons à la maintenance d’application Symfony, au même titre que la sécurité et les mises à jour.

Concrètement, cela repose sur quelques habitudes : des alertes sur le temps de réponse et le taux d’erreur, une lecture régulière du journal des requêtes lentes, un suivi des files Messenger et des messages en échec, et une mesure avant et après chaque évolution importante. Une régression de performance se traite alors comme une anomalie, par ticket.

Certaines lenteurs relèvent d’autres sujets. Une version ancienne de Symfony ou de PHP prive l’application des améliorations récentes : voir la montée de version Symfony. Une infrastructure sous-dimensionnée se traite avec l’hébergement, par exemple sur une infrastructure cloud dédiée. Une application reprise sans documentation commence par un état des lieux, décrit dans la reprise d’application Symfony.

Agillia

Un diagnostic de performance Symfony avec Agillia

Agillia est une agence web présente depuis plus de 20 ans, avec des experts seniors qui maintiennent des sites et des applications depuis plus de 16 ans. Nous travaillons avec Symfony au quotidien, car c’est le socle de PrestaShop 8 et 9, et nous intervenons aussi sur Laravel, voir la maintenance et évolution Laravel.

Un diagnostic de performance commence par notre audit d’application Symfony : mesures sur les pages et les routes clés, revue de la configuration de production, des requêtes Doctrine, du cache et des traitements asynchrones. Il débouche sur une liste de corrections classées par impact et par effort, sans promesse de gain chiffré avant mesure.

Les corrections sont ensuite menées en méthode agile, comme décrit dans le développement sur mesure en méthode agile, puis suivies dans le cadre de la maintenance d’application Symfony. Pour estimer l’effort d’un suivi régulier, voir le coût de la maintenance Symfony.

Pour aller plus loin

Pour aller plus loin

Questions fréquentes

Vos questions sur la performance Symfony

Pourquoi mon application Symfony est-elle lente ?

Le plus souvent à cause des requêtes Doctrine, d’un cache absent ou de traitements lourds exécutés pendant la requête. Une configuration de production incomplète, avec le mode debug actif ou OPcache mal réglé, est aussi fréquente. Seule une mesure avec le profiler ou un outil d’APM indique la cause réelle.

En mesurant d’abord, puis en corrigeant les causes par ordre d’impact. On vérifie la configuration de production, on réduit et on cible les requêtes Doctrine, on ajoute les index manquants, on met en cache ce qui peut l’être et on passe les traitements lourds en asynchrone avec Messenger. Chaque correction est mesurée à nouveau.

En développement, le profiler Symfony et sa barre de débogage, complétés par le composant Stopwatch. En production, un outil de profilage ou d’APM et le journal des requêtes lentes de la base. Les journaux Monolog et les métriques du serveur complètent le tableau.

Non, il est réservé au développement. Il ralentit chaque requête et expose des informations internes sur l’application. En production, on utilise des outils prévus pour cet usage, comme un APM ou des journaux structurés.

Messenger permet de sortir un traitement lourd de la requête de l’utilisateur. L’application envoie un message dans une file, répond aussitôt, et un worker exécute le traitement en arrière-plan. C’est adapté aux e-mails, aux exports, aux synchronisations et aux appels à des API lentes.

Oui, dès que des pages ou des réponses d’API peuvent être servies à plusieurs visiteurs. Symfony gère les en-têtes de cache et fournit un reverse proxy en PHP ; un reverse proxy dédié ou un CDN peut prendre le relais. ESI permet de mettre en cache une page tout en gardant certains fragments dynamiques.

Oui, il évite de chercher les fichiers de classe sur le disque à chaque requête. La commande composer dump-autoload --optimize génère une table de correspondance complète ; l’option --classmap-authoritative va plus loin. Le gain s’ajoute à celui d’OPcache.

Diagnostiquer la performance de votre application Symfony

Décrivez-nous les pages ou les traitements lents et la version de votre application : nous vous proposons un audit de performance et un plan de corrections classé par impact.