Laravel通过Redis HyperLogLog可高效实现不重复元素的基数统计，适用于UV、设备去重等大规模数据场景。首先确保安装predis/predis并正确配置Redis连接信息。利用PFADD添加元素、PFCOUNT获取估算基数、PFMERGE合并多个集合，结合日期动态生成Key可实现按日、周等维度统计独立访问量。例如使用Redis::pfadd('uv:page:home', 'user_123')记录访问，Redis::pfcount('uv:page:home')获取UV值，并通过循环构造周数据键名后调用PFMERGE合并计算周UV。HyperLogLog为概率算法，误差率低于0.81%，单个结构仅占约12KB内存，支持上亿级数据去重。建议避免高频写入大Key，应用层缓冲合并操作，设置TTL定期清理历史数据以控制内存增长，同时监控关键Key的内存与访问频率，保障系统稳定性。该方案在高并发下表现优异，实现简单且资源消耗低。
在 Laravel 中利用 Redis 的 HyperLogLog 功能，可以高效实现基数统计（即统计不重复的元素数量），特别适用于大规模数据场景，比如统计独立访客数（UV）、去重设备 ID 等。HyperLogLog 是一种概率数据结构，用极小的内存误差可控地估算集合中唯一元素的数量。
启用 Redis 支持
Laravel 默认集成了 Redis 扩展包 predis/predis 或通过 PhpRedis 扩展，确保项目已正确配置：
- 安装依赖：composer require predis/predis
- 在 config/database.php 中配置 Redis 连接
- 确保 .env 文件中的 REDIS_HOST、REDIS_PASSWORD 等设置正确
使用 HyperLogLog 基本命令
Redis 提供了三个核心命令用于 HyperLogLog 操作：
- PFADD key element [element ...]：添加一个或多个元素到 HyperLogLog 结构中
- PFCOUNT key [key ...]：获取一个或多个 HyperLogLog 结构的基数估算值
- PFMERGE destkey sourcekey [sourcekey ...]：合并多个 HyperLogLog 到目标结构
Laravel 中可通过 Redis 门面直接调用这些命令：
use Illuminate\Support\Facades\Redis;
// 添加用户访问记录（如用户ID或IP）
Redis::pfadd('uv:page:home', 'user_123');
Redis::pfadd('uv:page:home', 'user_456');
Redis::pfadd('uv:page:home', 'user_123'); // 重复，不影响计数
// 获取页面独立访问人数
$uv = Redis::pfcount('uv:page:home'); // 返回约 2
按时间维度统计 UV 示例
实际项目中常需按天统计 UV，并支持累计周/月 UV。可结合日期键名实现：
$date = now()->format('Y-m-d');
$key = "uv:page:article_{$articleId}:{$date}";
Redis::pfadd($key, $userId);
// 获取当日 UV
$todayUv = Redis::pfcount($key);
// 合并本周数据
$weekKeys = [];
for ($i = 0; $i < 7; $i++) {
$day = now()->subDays($i)->format('Y-m-d');
$weekKeys[] = "uv:page:article_{$articleId}:{$day}";
}
Redis::pfmerge("uv:week:article_{$articleId}", ...$weekKeys);
$weekUv = Redis::pfcount("uv:week:article_{$articleId}");
注意事项与优化建议
- HyperLogLog 是估算值，误差率通常低于 0.81%，适合不要求精确去重的场景
- 单个 HyperLogLog 结构内存占用极小（约 12KB），可存储上亿级唯一元素
- 避免频繁对单个大 Key 执行 PFADD，可在应用层做简单缓冲合并后再写入
- 定期归档历史数据，防止 Redis 内存无限增长，可配合 TTL 设置自动过期
- 生产环境建议监控关键 Key 的内存和访问频率
基本上就这些。Laravel 配合 Redis HyperLogLog 能轻松应对高并发下的高效基数统计需求，实现简单且性能优越。
