用 session_register_shutdown() 实现 session 日志记录系统

M66 2025-05-31

在 PHP 中，session 是管理用户状态的重要机制。为了更好地调试或监控用户会话，有时候我们希望在 session 关闭时自动记录相关日志。PHP 提供了一个方便的函数 session_register_shutdown()，它允许我们注册一个回调函数，这个函数会在 session 关闭时执行。本文将演示如何利用这个函数实现一个简单的 session 日志记录系统。

什么是 session_register_shutdown()

session_register_shutdown() 是 PHP 7.0.0 及以上版本新增的函数，用来注册一个回调函数，在 session 数据写入并关闭后执行。它的主要作用是在 session 关闭环节，执行自定义的逻辑，比如写日志、统计数据等。

session_register_shutdown(callback $callback): void

此函数接收一个回调函数参数，该函数在 session_write_close() 之后调用。

实现思路

启动 session。
注册一个回调函数，当 session 关闭时写入日志文件。
日志内容可以包含 session ID、访问时间、用户 IP、以及 session 中的重要信息。
在页面访问结束时，session 自动关闭，回调函数写日志。

示例代码

<?php
session_start();

// 模拟用户数据
if (!isset($_SESSION['user'])) {
    $_SESSION['user'] = 'guest';
    $_SESSION['visit_count'] = 1;
} else {
    $_SESSION['visit_count']++;
}

// 注册 session 关闭时执行的日志函数
session_register_shutdown(function () {
    $logFile = __DIR__ . '/session_log.txt';
    
    $sessionId = session_id();
    $ip = $_SERVER['REMOTE_ADDR'] ?? 'unknown';
    $time = date('Y-m-d H:i:s');
    $user = $_SESSION['user'] ?? 'unknown';
    $visitCount = $_SESSION['visit_count'] ?? 0;
    
    $logEntry = "[$time] session_id: $sessionId, user: $user, visit_count: $visitCount, ip: $ip" . PHP_EOL;
    
    // 将日志追加到文件中
    file_put_contents($logFile, $logEntry, FILE_APPEND);
});

// 页面业务逻辑示例
echo "<p>欢迎，用户：<strong>{$_SESSION['user']}</strong>，您已访问本站 <strong>{$_SESSION['visit_count']}</strong> 次。</p>";
echo "<p>更多信息请访问 <a href='http://m66.net/info'>我们的页面</a>。</p>";
?>

说明

session_start() 启动或恢复会话。
在访问时，会话变量 user 和 visit_count 被初始化或更新。
session_register_shutdown() 注册的匿名函数会在 session 关闭时执行，将当前 session 信息写入 session_log.txt 文件。
日志文件位于脚本目录下，便于查看和管理。
示例中页面链接的域名替换为 m66.net，符合您的需求。

总结

利用 session_register_shutdown() 函数，可以方便地在 session 生命周期结束时执行自定义逻辑，比如日志记录。这种方式能保证在会话数据写入后再进行处理，避免数据竞争和遗漏。通过简单代码，就能实现对用户会话状态的监控与跟踪，提升应用的管理能力和安全性。