Messages Flash sans effort en PHP : un package puissant pour les notifications basées sur la session

En tant que développeurs, nous avons souvent besoin d'un moyen simple d'afficher aux utilisateurs des notifications, des alertes ou des messages flash sur un site Web après une certaine action. Qu'il s'agisse d'un message de réussite, d'une erreur ou d'une alerte d'information, la mise en œuvre de messages Flash peut devenir répétitive et sujette aux erreurs. Mais ce n’est pas obligatoire !

Présentation de FlashMessages, un package PHP léger et facile à utiliser qui vous aide à gérer facilement les messages flash dans vos applications Web. Que vous créiez une petite application ou un projet à grande échelle, FlashMessages offre un moyen transparent de gérer et d'afficher les notifications basées sur la session, tout en étant personnalisable et extensible.

Pourquoi utiliser les messages Flash ?

Voici pourquoi FlashMessages se démarque :

• Simple à utiliser : Juste quelques lignes de code pour ajouter des messages de réussite, d'erreur, d'informations ou d'avertissement.
• Personnalisable : facilement extensible avec des types de messages personnalisés. Prise en charge du traducteur : ajoutez une logique de traduction à vos messages flash.
• Persistant : prend en charge le stockage basé sur la session, garantissant la persistance des messages sur plusieurs chargements de pages.
• Aucune dépendance : package autonome qui fonctionne sans bibliothèques ni frameworks supplémentaires.

---

Comment installer

FlashMessages est prêt à être utilisé dans n'importe quel projet PHP. Vous pouvez l'installer via Composer, le gestionnaire de dépendances PHP. Si vous n'utilisez pas encore Composer, il est temps de commencer !

Installer via Composer :

Exécutez cette commande dans le répertoire racine de votre projet :

composer require nassiry/flash-messages

Utilisation par défaut

require __DIR__ . '/vendor/autoload.php';

use Nassiry\FlashMessages\FlashMessages;

// Create an instance
$flash = FlashMessages::create();

// Standard messages
$flash->success('Operation completed successfully.');
$flash->error('Something went wrong!');
$flash->info('Here is some useful information.');
$flash->warning('Be cautious about this!');

// Custom message type
$flash->addCustomType('notification', 'This is a custom notification!', true);
$flash->addCustomType('success-green', 'This is a green-themed success message!', false);


// Render messages on the next page template file
$flash->render();

Cela affichera du HTML pour chaque message ajouté, comme ceci :

<div>




<hr>

<h3>
  
  
  Instant vs. Persistent Messages
</h3>

<p>You can control whether a message is shown immediately or stored for the next page load using the $instant parameter.</p>

<ul>
<li>
<strong>Instant Message</strong>: Use $instant = true to display the message on the current page.</li>
<li>
<strong>Persistent Message</strong>: Use $instant = false to store the message in the session, to be rendered on the next page load default is false.
</li>
</ul>

<pre class="brush:php;toolbar:false">// Shown immediately
$flash->success('This is an instant success message!', true);  
// Stored for next page
$flash->error('This error will be shown on the next page.', false);  

---

Conclusion

FlashMessages est un package PHP simple mais puissant pour gérer et afficher des messages flash. Il est conçu pour être léger, facile à utiliser et extensible. Que vous ajoutiez des messages de réussite, des notifications d'erreur ou des alertes personnalisées, FlashMessages facilite leur gestion et leur affichage de manière cohérente.

Vous pouvez commencer à utiliser FlashMessages dès aujourd'hui en l'installant via Composer et en l'intégrant dans vos projets PHP. Consultez le référentiel sur GitHub pour plus de détails ou contribuez à ce projet open source !

---

J'espère que ce package vous sera utile ! N'hésitez pas à mettre en vedette le dépôt, à contribuer ou à ouvrir des problèmes si vous avez des questions ou des suggestions. Bon codage ! ?