PHP 中的輕鬆 Flash 訊息：基於會話的通知的強大套件

作為開發人員，我們通常需要一種簡單的方法來在執行特定操作後在網站上向用戶顯示通知、警報或閃現訊息。無論是成功訊息、錯誤或訊息警報，實施閃現訊息都可能變得重複且容易出錯。但不一定是這樣！

介紹 FlashMessages，這是一個輕量級且易於使用的 PHP 包，可幫助您輕鬆處理 Web 應用程式中的 Flash 訊息。無論您是建立小型應用程式還是大型項目，FlashMessages 都提供了一種無縫的方式來管理和顯示基於會話的通知，同時可自訂和可擴展。

為什麼要使用 FlashMessages？

這就是 FlashMessages 脫穎而出的原因：

• 使用簡單：只需幾行程式碼即可新增成功、錯誤、訊息或警告訊息。
• 可自訂：可以使用自訂訊息類型輕鬆擴充。 翻譯器支援：為您的即時訊息新增翻譯邏輯。
• 持久：支援基於會話的存儲，確保訊息在多個頁面加載時持續存在。
• 無相依性：獨立包，無需任何額外的函式庫或框架即可運作。

---

如何安裝

FlashMessages 已準備好在任何 PHP 專案中使用。您可以透過 PHP 依賴管理器 Composer 安裝它。如果您還沒有使用 Composer，那麼現在就開始吧！

透過 Composer 安裝：

在專案的根目錄中執行此指令：

composer require nassiry/flash-messages

預設用法

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();

這將為新增的每個訊息輸出 HTML，如下所示：

<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);  

---

結論

FlashMessages 是一個簡單但功能強大的 PHP 包，用於管理和顯示 Flash 訊息。它被設計為輕量級、易於使用且可擴展。無論您是新增成功訊息、錯誤通知還是自訂警報，FlashMessages 都可以讓您輕鬆管理並以一致的方式顯示它們。

您今天就可以開始使用 FlashMessages，透過 Composer 安裝它並將其整合到您的 PHP 專案中。查看 GitHub 上的儲存庫以了解更多詳細信息，或為這個開源專案做出貢獻！

---

我希望您覺得這個包有用！如果您有任何問題或建議，請隨時為儲存庫加註星標、貢獻或開啟問題。快樂編碼！ ？