本文旨在解决magento 1.9中控制器重定向后核心会话消息消失的常见问题。文章详细介绍了如何正确设置成功、错误和通知等会话消息，并强调了在执行重定向前调用`session_write_close()`的关键性，以确保消息能正确持久化并显示在目标页面。此外，还涵盖了不同类型的重定向方法，包括针对已发送输出后的javascript重定向策略。
在Magento 1.9开发中，开发者经常需要通过会话（Session）机制在不同页面间传递临时消息，例如操作成功提示、错误警告或重要通知。Magento提供了便捷的Mage::getSingleton('core/session')接口来管理这些消息。然而，一个常见的困扰是，当控制器设置了会话消息并立即执行页面重定向后，这些消息却无法在目标页面显示。本文将深入探讨这一问题的原因，并提供一套完整的解决方案和最佳实践。
Magento 1.9 会话消息机制概述
Magento的核心会话消息系统允许您在应用程序的任何部分设置消息，这些消息通常会在页面的顶部区域（如通过core/template块渲染的global_messages）显示给用户。以下是设置不同类型消息的常用方法：
-
成功消息 (Success Message)：用于提示用户操作已成功完成。
Mage::getSingleton('core/session')->addSuccess("您的操作已成功完成。"); -
错误消息 (Error Message)：用于警告用户操作失败或出现问题。
Mage::getSingleton('core/session')->addError("处理您的请求时发生错误，请稍后再试。"); -
通知消息 (Notice Message)：用于提供一般性的信息或警告。
Mage::getSingleton('core/session')->addNotice("请注意，部分设置可能需要手动调整。");
这些方法会将消息添加到当前的会话集合中。当页面渲染时，Magento会自动从会话中检索并显示这些消息，然后清除它们以避免重复显示。
核心问题：会话消息消失的原因分析
当您在控制器中设置消息并立即重定向时，例如：
$session = Mage::getSingleton('core/session');
$session->addError('这是一个测试消息');
$this->_redirect('/'); // 重定向到首页在目标页面（如首页）通过Mage::getSingleton("core/session")->getMessages()调试时，可能会发现会话消息集合（_messages）是空的，但_lastAddedMessage属性中却包含了您刚刚设置的消息。这表明消息确实被添加了，但不知何故未能正确地保存到会话存储中，以供后续请求检索。
根本原因在于PHP的会话管理机制。在PHP中，会话数据通常在脚本执行结束时自动写入存储（如文件或数据库），或者在调用session_write_close()函数时显式写入。当您在设置消息后立即进行HTTP重定向时，当前脚本的执行会立即终止，而会话数据可能还没有来得及被完全写入到存储中。这意味着，当浏览器收到重定向指令并请求新页面时，新的请求会启动一个新的会话周期，但上一个请求中设置的消息由于未被持久化，因此无法被新会话加载。
解决方案：确保会话消息持久化
解决这个问题的关键在于，在执行任何重定向操作之前，显式地将会话数据写入存储并关闭会话。PHP提供了session_write_close()函数来完成此任务。
session_write_close() 的作用： 此函数会将会话数据立即保存到会话存储（如服务器上的文件或数据库），并释放会话文件锁。释放锁是至关重要的，因为它允许其他并发请求（例如通过AJAX发起的请求）访问同一个会话，而不会被阻塞。
在控制器中应用解决方案：
class Your_Module_IndexController extends Mage_Core_Controller_Front_Action
{
public function saveAction()
{
try {
// ... 您的业务逻辑处理 ...
$session = Mage::getSingleton('core/session');
$session->addSuccess('数据已成功保存。');
// 关键步骤：在重定向前显式关闭会话写入
session_write_close();
// 执行重定向
$this->_redirect('/'); // 重定向到Magento根目录
return;
} catch (Exception $e) {
Mage::logException($e);
$session = Mage::getSingleton('core/session');
$session->addError('保存失败：' . $e->getMessage());
// 即使发生错误，也需要确保会话消息被保存
session_write_close();
// 重定向回上一页或指定页面
$this->_redirectReferer();
return;
}
}
}通过在$this->_redirect()或$this->_redirectUrl()调用之前添加session_write_close();，您可以确保在重定向发生之前，所有会话数据（包括您的消息）都已正确地保存到会话存储中，从而在目标页面能够被成功检索和显示。
Magento 中的重定向方法
Magento提供了多种重定向方法，您可以根据具体需求选择：
-
内部路径重定向 (_redirect)： 用于重定向到Magento内部的控制器动作。
// 重定向到模块/控制器/动作 $this->_redirect('module/controller/action'); // 重定向到带参数的路径 $this->_redirect('module/controller/action', array('param1' => 'value1')); -
外部URL重定向 (_redirectUrl)： 用于重定向到任何完整的URL。
$url = 'https://www.example.com/some/path'; $this->_redirectUrl($url);
无论使用哪种重定向方法，session_write_close()都应在其之前调用。
特殊情况：输出已发送后的重定向
在某些特殊情况下，例如在视图层（PHTML文件）或在控制器中输出内容后才决定进行重定向，HTTP头部的重定向（header('Location: ...')）将不再有效，因为HTTP头必须在任何输出之前发送。在这种情况下，您只能通过客户端JavaScript来实现重定向：
注意： 尽管JavaScript重定向在技术上可行，但在控制器中直接执行HTTP重定向是更推荐和更符合MVC架构的最佳实践。JavaScript重定向通常作为无法进行服务器端重定向的最后手段。
注意事项与最佳实践
- 始终在重定向前关闭会话：这是解决会话消息消失问题的核心。养成在_redirect()或_redirectUrl()之前调用session_write_close()的习惯。
- 避免在视图层重定向：将重定向逻辑放在控制器中，保持视图层的纯粹性，只负责内容的展示。
- 消息类型选择：根据信息的性质选择addSuccess、addError或addNotice，这有助于保持用户界面的清晰和一致性。
- 错误处理：在try-catch块中处理业务逻辑，并在catch块中设置错误消息并同样调用session_write_close()，以确保错误信息能够显示。
总结
Magento 1.9中会话消息在重定向后消失的问题，根本原因在于PHP会话数据未能在HTTP重定向发生前及时写入存储。通过在控制器中执行重定向之前显式调用session_write_close()函数，可以确保会话数据（包括所有设置的消息）被正确持久化，从而在目标页面上成功显示。理解并遵循这一最佳实践，将大大提高您在Magento 1.9开发中处理用户反馈和状态管理的效率和可靠性。
