PHPackages                             hms/statistics - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. hms/statistics

ActiveLibrary[Utility & Helpers](/categories/utility)

hms/statistics
==============

This is a statistics expansion package based on laravel

v1.0(5y ago)841MITPHPPHP >=7.0

Since Nov 11Pushed 5y ago1 watchersCompare

[ Source](https://github.com/mingking1024/statistics)[ Packagist](https://packagist.org/packages/hms/statistics)[ RSS](/packages/hms-statistics/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (1)Dependencies (2)Versions (3)Used By (0)

statistics
==========

[](#statistics)

基于laravel的数据统计存储扩展包
===================

[](#基于laravel的数据统计存储扩展包)

环境要求
====

[](#环境要求)

- Laravel >= 5.5
- Jenssegers/mongodb >= 3.3

安装
==

[](#安装)

```
composer require hms/statistics

```

配置
==

[](#配置)

创建配置文件:

```
php artisan vendor:publish --tag=statistics-config

```

基本用法
====

[](#基本用法)

#### 在你的model中定义：

[](#在你的model中定义)

```
use Hms\Statistics\Eloquents\Statistics;
use Jenssegers\Mongodb\Eloquent\Model;

class Example extends Model
{
    use Statistics;

    public function __construct()
    {
        parent::__construct();

        $this->statisticsConditionFields = [
            'day'
        ];

        $this->incrementFields = [
            'number'
        ];
    }
}
```

你的统计表中必须包含至少一个条件字段和一个统计字段，并且你需要在`statisticsConditionFields`数组中定义你的条件字段，在`incrementFields`中定义你的统计字段。

#### 存入统计业务表

[](#存入统计业务表)

```
use App\Example;

$example = new Example();
$example->statistics([
    'day'       => Carbon::now()->toDateString(),
    'number'    => 1
]);
```

如上所示，`statistics`方法会接收两个参数，第一个参数是需要存储的数据数组，该方法会默认将数据按model中定义的规则进行判断是新增或是累加操作，如果你期望数据按定义的条件进行强制覆盖操作则可传入第二个参数。 第二个参数是可选参数默认为`null`，当传入`force`时数据将以覆盖的形式存入collection中，当传入`new`时表示该数据以新增方式存入collection中。

#### 使用redis将数据进行缓存

[](#使用redis将数据进行缓存)

```
$example->cache([
    'day'       => Carbon::now()->toDateString(),
    'number'    => 3
]);
```

如果你需要在高并发的业务中进行数据统计，那么强烈推荐你使用此方法存储数据，`cache`方法也会将数据按model中定义的规则用hash表保存在你的`redis`中。

#### 将redis中存储的数据同步到mongodb

[](#将redis中存储的数据同步到mongodb)

在使用前你需要开启Laravel提供的[任务调度](https://learnku.com/docs/laravel/5.8/scheduling/3924) 功能

```
* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1

```

并且在`config/statistics.php`的`namespaces`数组中定义你需要进行同步的 model，如下所示:

```
'namespaces' => [
    App\Example::class
]
```

然后在`App\Console\Kernel`的 `schedule` 方法中加入`statistics`的 [Artisan 命令](https://learnku.com/docs/laravel/5.8/artisan/3913)

```
protected function schedule(Schedule $schedule)
{
    $schedule->command('statistics:sync')->daily();
}
```

至此`statistics`为你提供了一套非常便利的数据统计

> 注：statistics提供了数据redis的存储与查询方法的封装，但是并未实现在查询mongodb时默认将缓存中的数据读取的功能，此时需要自行将缓存数据读出进行合并操作。

其他用法
====

[](#其他用法)

#### setDistinct

[](#setdistinct)

如果你需要统计UV值那么你可以使用该方法：

```
$example->setDistinct([
    'client' => 'ios',
    'device_id' => 'balabala...'
]);
```

or

```
use Hms\Statistics\Models\StatisticsLog;

// 设置去重条件
$example->setDistinct(function () {
    return Example::query()->where('client', 'ios')->whereIn('user_id', 1234)->first();
});

// 此时应该这样调用cache
$example->cache([
    'day'       => Carbon::now()->toDateString(),
    'number'    => 3
], function () {
    StatisticsLog::create([
        'client'    => 'ios',
        'user_id'   => 1234
    ]);
});
```

通过`setDistinct`方法定义你的去重条件，支持数组或闭包形式。如果传入闭包，调用 `cache` 方法则第二个参数需传入一个闭包函数来记录你的去重条件。

> 注意：去重条件不推荐用or语句，如果这样做就失去了去重的意义。

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

2007d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9041d0f873a91a995b8e6cd6c781109cb8dd9b14f9b458b779204a338f9b9845?d=identicon)[hms1024](/maintainers/hms1024)

---

Top Contributors

[![jerry-hms](https://avatars.githubusercontent.com/u/50130776?v=4)](https://github.com/jerry-hms "jerry-hms (15 commits)")

### Embed Badge

![Health badge](/badges/hms-statistics/health.svg)

```
[![Health](https://phpackages.com/badges/hms-statistics/health.svg)](https://phpackages.com/packages/hms-statistics)
```

###  Alternatives

[grumpydictator/firefly-iii

Firefly III: a personal finances manager.

22.8k69.3k](/packages/grumpydictator-firefly-iii)[blair2004/nexopos

The Free Modern Point Of Sale System build with Laravel, TailwindCSS and Vue.js.

1.2k2.3k](/packages/blair2004-nexopos)[vcian/pulse-active-sessions

A Laravel Pulse card to show active user session.

11469.2k](/packages/vcian-pulse-active-sessions)[splitsoftware/split-sdk-php

Split SDK for PHP

161.3M2](/packages/splitsoftware-split-sdk-php)[vwo/vwo-php-sdk

VWO server side sdk

12166.4k](/packages/vwo-vwo-php-sdk)[ada-u/chocoflake

64bit time based id generator

14117.3k](/packages/ada-u-chocoflake)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)