Aller au contenu principal
Version: 26.0.8.0

flash

La variable globale flash fournit un accès au service FlashBag, un conteneur de messages qui permet de stocker des messages entre deux requêtes HTTP. Cette fonctionnalité est particulièrement utile pour afficher des messages de confirmation, d'erreur ou d'information à l'utilisateur après une redirection.

Méthodes disponibles​

MéthodeDescription
get(type)Récupère tous les messages d'un type donné
all()Récupère tous les messages, groupés par type
has(type)Vérifie s'il existe des messages d'un certain type
getFirst(type)Récupère le premier message d'un type donné

Types de messages standards​

  • success : Pour les opérations réussies
  • error : Pour les erreurs
  • warning : Pour les avertissements
  • info : Pour les informations générales

Exemples d'utilisation​

Afficher les messages flash dans un template​

{% for type, messages in flash.all() %}
    <div class="alert alert-{{ type }}">
        {% for message in messages %}
            {{ message }}
        {% endfor %}
    </div>
{% endfor %}

Vérifier et afficher un type spécifique de message​

{% if flash.has('success') %}
    <div class="success-message">
        {{ flash.get('success')|join(' ') }}
    </div>
{% endif %}

Bonnes pratiques​

  • Utilisez des types de messages cohérents dans toute l'application
  • Ne stockez pas de données sensibles dans les messages flash
  • Les messages flash sont automatiquement supprimés après avoir été lus
  • Utilisez des clés personnalisées pour des cas d'utilisation spécifiques

Remarque​

Les messages flash sont stockés dans la session et ne sont disponibles que pour la prochaine requête. Si vous avez besoin de conserver les messages plus longtemps, vous devez les réinjecter manuellement.