Webman框架下用户行为路径追踪系统-php教程-PHP中文网

webman本身不内置用户行为路径追踪，但可通过中间件统一记录pageview与referrer、手动埋点采集点击等事件、基于anonymous_id/user_id与时序排序还原路径，并需注意索引优化、批量写入及表分区以保障性能与数据准确性。

webman框架下用户行为路径追踪系统

Webman 是 PHP 生态中面向高性能场景的常驻进程框架，它本身不内置用户行为路径追踪能力，但提供了足够灵活的中间件、事件系统和数据库集成机制，可以构建轻量、可控、低侵入的行为路径追踪系统。关键在于：**路径不是靠框架自动推导，而是靠你定义事件语义 + 关联 session/user + 时序存储 + 后续聚合分析**。

如何用中间件记录基础访问路径（pageview + referrer）

最简路径追踪起点是页面级访问，适合快速上线并覆盖 80% 的漏斗分析需求。不要直接在控制器里写日志——那样分散、难维护、易遗漏。

推荐在 app/middleware/AccessLogMiddleware.php 中统一拦截：

提取 $_SERVER['REQUEST_URI']、$_SERVER['HTTP_REFERER']、$_SERVER['HTTP_USER_AGENT']
从 session 或 cookie 中获取 user_id 或生成临时 anonymous_id（如 md5($_SERVER['REMOTE_ADDR'] . $_SERVER['HTTP_USER_AGENT'])）
使用 Db::table('access_logs')->insert() 写入，字段至少包含：url、referrer、anonymous_id、created_at
避免在中间件里做耗时操作（如远程调用、复杂计算），写库建议用异步队列或批量插入（见下一条）

为什么不能只靠 pageview？点击/曝光类事件必须手动埋点

pageview 只能告诉你“用户来了”，但无法回答“他点了什么”“在哪卡住了”“是否滚动到底部”。这些必须由前端主动上报，后端提供接收入口。

例如，在控制器中暴露一个轻量 API：

public function track(Request $request)
{
    $data = $request->post();
    // 校验必要字段：event_type, page_url, element_id, timestamp
    if (!in_array($data['event_type'], ['click', 'expose', 'submit'])) {
        return json(['code' => 400, 'msg' => 'invalid event_type']);
    }
    Db::table('behavior_logs')->insert([
        'user_id'      => $data['user_id'] ?? null,
        'anonymous_id' => $data['anonymous_id'],
        'event_type'   => $data['event_type'],
        'page_url'     => $data['page_url'],
        'element_id'   => $data['element_id'] ?? '',
        'timestamp'    => date('Y-m-d H:i:s', $data['timestamp'] / 1000),
        'created_at'   => date('Y-m-d H:i:s')
    ]);
    return json(['code' => 0]);
}

注意：timestamp 前端应传毫秒时间戳，后端转为标准时间；element_id 或 data-track 属性需前端统一约定，否则后端无法归因。

路径还原的关键：session_id 或 user_id + 时间排序

单条日志毫无意义。真正构成“路径”的，是同一 anonymous_id 或 user_id 在一段时间内（如 30 分钟）按 created_at 排序的行为序列。

Webman 2.2.0

Webman 2.2.0版本强化了 TCP/UDP 服务支持，优化路由组管理，并增强异步任务处理能力。结合协程与连接池技术，Webman 能轻松应对高并发场景，适用于网站、接口服务、即时通讯、物联网及游戏开发，兼具高性能、灵活扩展与稳定可靠，是多场景 PHP 服务开发的理想选择。

下载

查询示例（MySQL）：

SELECT event_type, page_url, element_id, created_at
FROM behavior_logs 
WHERE anonymous_id = 'xxx' 
  AND created_at BETWEEN '2026-06-23 19:00:00' AND '2026-06-23 20:00:00'
ORDER BY created_at;

容易踩的坑：