在日常的 php web 开发中，我们常常会遇到这样一个场景：用户提交了一个表单，或者点击了一个删除按钮，后端处理完逻辑后，需要将用户重定向到另一个页面。此时，我们希望在新页面上显示一条消息，告诉用户刚才的操作是否成功，或者提示一些注意事项。
最初，我尝试过最原始的方法：将消息直接存储在 PHP 的
$_SESSION变量中。在重定向前，把消息存进去；在新页面加载时，从
$_SESSION中取出消息并显示；显示完后，再手动从
$_SESSION中删除。这套流程看起来简单，但实际操作起来却有诸多不便：
-
忘记清除： 常常会忘记在消息显示后将其从
$_SESSION
中清除，导致消息在后续请求中反复出现。 - 多条消息管理： 如果需要同时显示多条不同类型的消息（例如“成功消息”和“错误消息”），手动管理数组结构会变得复杂。
- 代码重复： 几乎每个需要瞬时消息的控制器或路由中，都需要重复编写存取和清除消息的逻辑，代码冗余。
- 可读性差： 业务逻辑与消息管理逻辑混杂，降低了代码的可读性和维护性。
这些问题让我感到非常困扰，我迫切需要一个更优雅、更自动化的解决方案。这时，我遇到了
slim/flash，一个专为 Slim Framework 设计的瞬时消息服务提供者，而 Composer 正是将其引入项目的最佳工具。
Composer：引入 slim/flash
的得力助手
Composer 是 PHP 的一个依赖管理工具。它允许你声明项目所依赖的库，并管理它们的安装和更新。通过 Composer 引入
slim/flash变得异常简单：
首先，确保你的项目已经安装了 Composer。然后，在你的项目根目录下打开终端，执行以下命令：
composer require slim/flash
这条命令会下载
slim/flash及其所有依赖，并自动将其加载到你的项目中。你无需手动下载文件，也无需担心依赖冲突，Composer 会帮你处理一切。
slim/flash
：解决瞬时消息难题
slim/flash的核心思想是提供一种机制，让消息只从当前请求持续到下一个请求，然后自动清除。这完美契合了瞬时消息的需求。
下面以 Slim 4 为例，展示如何集成和使用
slim/flash：
addDefinitions(
[
'flash' => function () {
// 初始时可以给一个空数组，实际存储会在中间件中绑定到 $_SESSION
return new Messages([]);
}
]
);
AppFactory::setContainer($containerBuilder->build());
$app = AppFactory::create();
// 2. 添加一个中间件来启动 PHP session 并绑定 flash 消息到 session
$app->add(
function ($request, $next) {
// 确保 PHP session 已经启动
if (session_status() !== PHP_SESSION_ACTIVE) {
session_start();
}
// 将 flash 消息的存储绑定到 $_SESSION
// 这样消息就能在请求间持久化
$this->get('flash')->__construct($_SESSION);
return $next->handle($request);
}
);
$app->addErrorMiddleware(true, true, true);
// 3. 定义路由并使用 flash 消息
// 路由 A: 设置 flash 消息并重定向
$app->get(
'/',
function ($request, $response) {
// 使用 addMessage 方法添加一条消息，键为 'success'，值为 '操作成功！'
$this->get('flash')->addMessage('success', '您的数据已成功保存。');
$this->get('flash')->addMessage('info', '请注意，部分字段已自动修正。');
// 重定向到 /bar 路由
$url = RouteContext::fromRequest($request)->getRouteParser()->urlFor('bar');
return $response->withStatus(302)->withHeader('Location', $url);
}
);
// 路由 B: 获取并显示 flash 消息
$app->get(
'/bar',
function ($request, $response) {
$flash = $this->get('flash');
// 获取所有 flash 消息（一个关联数组，键是消息类型，值是消息数组）
$messages = $flash->getMessages();
echo "所有消息:
";
print_r($messages);
// 获取指定键（例如 'success'）的第一条消息
$successMessage = $flash->getFirstMessage('success');
echo "第一条成功消息:
";
print_r($successMessage);
// 此时，因为消息已经被读取，它们将自动从 session 中清除，不会在下一次请求中出现。
return $response;
}
)->setName('bar');
$app->run();代码解析：
-
依赖注入： 我们在 Slim 的依赖注入容器中注册了一个名为
flash
的服务，它是一个Slim\Flash\Messages
实例。 -
Session 中间件： 这是关键一步。我们添加了一个中间件，在每个请求开始时确保
session_start()
被调用，并将slim/flash
的内部存储指向$_SESSION
。这样，slim/flash
就能利用 PHP 的会话机制来存储和检索消息。 -
添加消息： 在第一个路由 (
/
) 中，我们通过$this->get('flash')->addMessage('键', '值')来添加消息。你可以为不同的消息类型设置不同的键（例如success
,error
,info
）。 -
获取消息： 在第二个路由 (
/bar
) 中，我们通过$flash->getMessages()
获取所有消息，或者通过$flash->getFirstMessage('键')获取特定类型的第一条消息。一旦消息被获取，slim/flash
会自动将其从会话中移除，确保它们只显示一次。
优势与实际应用效果
使用
slim/flash结合 Composer 带来的好处是显而易见的：
-
简洁的代码： 不再需要手动管理
$_SESSION
的存取和清除，代码变得更加简洁和专注于业务逻辑。 - 自动化清除： 消息在被获取后会自动清除，避免了消息重复显示的尴尬。
-
良好的结构： 提供了清晰的 API (
addMessage
,getMessages
,getFirstMessage
) 来管理不同类型的瞬时消息。 - 提高开发效率： 减少了重复劳动，让开发者可以更快地构建功能。
- 提升用户体验： 能够及时、准确地向用户提供操作反馈，让应用更具交互性和友好性。
在我的项目中，引入
slim/flash后，原本散落在各处的 session 消息处理逻辑被集中管理，代码变得异常整洁。用户在提交表单、登录、注册等操作后，都能收到清晰的反馈，大大提升了应用的专业度和用户满意度。
总之，如果你正在使用 Slim Framework 并苦于瞬时消息的传递问题，那么
slim/flash绝对是你的不二之选。通过 Composer 的便捷安装，你可以在几分钟内将其集成到你的项目中，享受它带来的便利和效率提升！
