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ôme | Cause fréquente | Correction |
|---|---|---|
| Des dizaines ou des centaines de requêtes SQL sur une seule page | Problème N+1 : des relations Doctrine chargées à la demande (lazy loading) dans une boucle ou un template Twig | Jointures 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 exports | Hydratation de milliers d’entités complètes alors que quelques champs suffisent | Requê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 seule | Index manquant sur une colonne de filtre, de tri ou de jointure | Analyse avec EXPLAIN, index ajouté par une migration Doctrine, requête réécrite si besoin |
| Clic sur « Valider » qui attend plusieurs secondes | Traitement lourd exécuté pendant la requête : envoi d’e-mails, génération de PDF, appel à une API tierce, synchronisation | Envoi 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 visite | Aucun cache HTTP : en-têtes de cache absents ou réponses toujours privées | En-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és | Résultats jamais mis en cache côté application | Pools 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 pages | OPcache absent ou mal réglé, environnement de debug actif en production | OPcache 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 classes | Autoloader 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éploiement | Cache du conteneur et des templates construit à la demande | Cache compilé de production généré au déploiement avec cache:warmup, avant la bascule |
| Pages lourdes à afficher côté navigateur | Fichiers CSS et JavaScript non minifiés, non versionnés, images trop lourdes | Assets 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.
Faut-il passer toutes les relations Doctrine en chargement immédiat ?
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 est-il trop lent pour les gros volumes ?
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é.
Le cache de Doctrine est-il utile en production ?
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 :
-
Environnement de production :
APP_ENV=prodetAPP_DEBUG=0; les variables d’environnement peuvent être compilées aveccomposer dump-env prod. -
Dépendances de production : installation avec
composer install --no-dev --optimize-autoloader, à partir ducomposer.lockversionné. -
Autoloader optimisé : classmap générée, voire
--classmap-authoritativequand aucune classe n’est générée à l’exécution. - OPcache activé : mémoire et nombre de fichiers dimensionnés pour le projet ; vérification des horodatages désactivée en production, le cache étant vidé à chaque déploiement.
-
Préchargement : le fichier de préchargement généré par Symfony déclaré dans la directive
opcache.preload, si la version de PHP et l’hébergement le permettent. -
Cache Symfony préchauffé :
cache:clearetcache:warmuplancés au déploiement, avant que le trafic n’arrive sur la nouvelle version. - Cache Doctrine : cache des métadonnées et des requêtes configuré sur un adaptateur de production, pas sur un tableau en mémoire.
- Pools de cache applicatif : adaptateur Redis ou APCu pour les données partagées, plutôt que le système de fichiers sur une infrastructure à plusieurs serveurs.
-
Journaux maîtrisés : niveau de journalisation de production, par exemple avec le gestionnaire
fingers_crossedde Monolog, pour ne pas écrire chaque détail sur disque. - Workers Messenger : transports asynchrones configurés, workers supervisés et redémarrés après chaque déploiement.
- Assets : fichiers compilés, minifiés et versionnés au déploiement, servis directement par le serveur web avec un cache navigateur long.
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
- Audit d’application Symfony : l’état des lieux technique et les mesures de performance.
- Maintenance d’application Symfony : le suivi régulier, performance comprise.
- Maintenance Symfony : interventions et évolutions en méthode agile.
- Sécurité d’une application Symfony : correctifs, dépendances et bonnes pratiques.
- Montée de version Symfony : passer à une version maintenue sans régression.
- Reprise d’une application Symfony : reprendre un code existant avec méthode.
- Coût de la maintenance Symfony : ce qui fait varier l’effort de maintenance.
- Évolution Symfony : faire grandir votre application sans la casser.
- Lexique de la maintenance : les termes techniques expliqués simplement.
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.
Comment optimiser les performances d’une application Symfony ?
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.
Quel outil utiliser pour mesurer la performance Symfony ?
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.
Le profiler Symfony peut-il rester actif en production ?
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.
À quoi sert Messenger pour la performance ?
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.
Faut-il un cache HTTP sur une application Symfony ?
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.
L’autoloader Composer optimisé change-t-il vraiment quelque chose ?
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.
