第42章 Flarum 统计扩展功能解析：仪表盘、图表导出与多维度数据分析

版本：2.x 统计（Statistics） Statistics 扩展（flarum/statistics）可以展示论坛的活跃程度：包括成员数、讨论数、帖子数量，以及这些数据随时间的变化。它是一个内置扩展，默认已启用。 统计数据仅对管理员可见。 面向开发者：任何扩展都可以在内置统计旁边添加自己的统计数据，具体可参阅开发者文档中的「添加统计」部分。 安装 该扩展随 Flarum 自带，新安装的论坛默认启用。如果你曾禁用它，可在后台管理面板的「扩展」页面重新启用。 如果你的安装中没有该扩展，可以像安装其他软件包一样引入它： composer require flarum/statistics php flarum cache:clear

仪表盘小组件

管理面板仪表盘中的论坛统计组件显示各项统计指标的总量。点击“查看更多统计”可打开统计页面。

统计页面

您可以通过仪表盘组件上的“查看更多统计”，或从管理面板导航栏中的扩展项打开统计页面。

每个统计指标均有一个卡片，显示：

• 总量；
• 所选时间段的数量；
• 相较于上一时间段的百分比变化（上升或下降）。

点击卡片可绘制该统计指标的图表。图表会并排展示所选时间段与其前一周期的数据，以便对比。点击“导出为 SVG 图表”即可下载图表图片。

时间周期

在卡片左侧的下拉菜单中选择时间周期。页面默认选中“最近 7 天”。

周期	图表粒度	单位
今日	小时
最近 7 天	天
前 7 天	天
最近 28 天	天
前 28 天	天
最近 12 个月	周
自定义范围...	天

“自定义范围...”需输入开始和结束日期（均包含在内）。对于自定义范围，卡片不显示百分比变化。

日期按 UTC 时区从中到次中计算，与论坛或浏览器所在时区无关。

统计内容

统计项	统计对象	时间依据
用户	所有成员账户，无论其邮箱是否已确认。	成员加入时间
讨论	所有讨论，包括隐藏和私密内容。	讨论创建时间
帖子	所有评论帖，包括隐藏和私密内容。事件帖（如“重命名讨论”）不计入。	帖子发布时间

统计数据基于论坛数据库中的内容，而非访客可见内容，因此包含隐藏和私密内容。永久删除的内容不再被统计，故总量和历史数量可能减少。

其他扩展可添加自有统计指标，显示在内置统计之后。例如，Messages 扩展（flarum/messages）添加了：

统计项	统计对象	时间依据
私信开始	每个私密会话。	会话开始时间
私信回复	会话首条消息之后的所有私信。	消息发送时间

数据实时性

为确保大型论坛上统计功能的响应速度，数据会缓存一小段时间后再重新计算：

数值类型	重新计算间隔
总量	5 分钟
下拉菜单中各周期的数量	15 分钟
自定义范围的数量	每次选择时重新计算

通过仪表盘的“清除缓存”或运行 php flarum cache:clear 命令清除缓存后，下次打开统计页面时将重新计算所有数据。