PHPackages                             radiatecode/dastats - 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. radiatecode/dastats

ActiveLibrary

radiatecode/dastats
===================

Statistics for dashboard or reports

v1.2.1(4y ago)1331MITPHPPHP ^7.4 || ^8.0

Since Aug 1Pushed 4y ago1 watchersCompare

[ Source](https://github.com/radiatecode/dastats)[ Packagist](https://packagist.org/packages/radiatecode/dastats)[ Docs](https://github.com/radiatecode/dastats)[ RSS](/packages/radiatecode-dastats/feed)WikiDiscussions main Synced 6d ago

READMEChangelogDependencies (2)Versions (7)Used By (0)

Da Stats
========

[](#da-stats)

[![Stats](img/stats.png)](img/stats.png)

This package is a lightweight solution to record and view the statistics for the dashboard or reports. Sometimes we need **KPI** / **Metrics** / **Statistics** in our **Dashboard** Or **Reports**, to create those statistics we need to go through lots of calculation, queries etc. But this package may helps you to make statistics in nicer way, the statistics stored in a **single db table**, so it would be faster or easier to retrieve.

Examples
========

[](#examples)

Lots of dashboard or reports have statistic widget like total customer, total user, total pending orders, total sales etc. For these **statistic widgets** we applied query across tables, rows along with mathematical equation to get the single unified numeric value. For small database the approach is ok but for large database the calculation may hamper the performance or create complexity. So what if we could calculate the statistics during the **CRUD operation**.

[![Stats](img/stats-samples.png)](img/stats-samples.png)

### Examples 1:

[](#examples-1)

**Total User Counting:**

Increase a user whenever a new user is store, Decrease a user whenever user delete.

```
use RadiateCode\DaStats\Facades\Stats;
.......

public function storeUser(Request $request){
    // stores statements
    ............

    Stats::title('User count')->key('total-user')->increase();
}

public function deleteUser($id){
    // delete statements
    ............

    Stats::key('total-user')->decrease();
}
```

### Examples 2:

[](#examples-2)

**Total Pending Orders:**

Increase or count total pending order whenever a new pending order placed, Decrease total pending order whenever an order successfully delivered.

```
use RadiateCode\DaStats\Facades\Stats;
.......

public function orderStore(Request $request){
    // pending order placement statements
    ............

    Stats::title('Pending order count')->key('total-pending-order')->increase();
}

public function orderDeliver(Request $request){
    // order delivery statements
    ............

    Stats::key('total-pending-order')->decrease();
}
```

### Examples 3:

[](#examples-3)

**Product Stocks:**

Increase product stock whenever new products purchased,

```
use RadiateCode\DaStats\Facades\Stats;
.......

public function purchaseStore(Request $request){
    // other statements
    ............

    foreach($purchaseProducts as $product){ // multiple products
        // purchase products save statements
        ..............

        // increase stock for a product
        Stats::title('Live stock')->key($product->id)->increase($product->quantity);
    }
}
```

**Update product stock:** sometime we need to update purchase product quantity for example quantity add or subtract in the same view, in that case our **product stock** also need to reflect accordingly.

```
use RadiateCode\DaStats\Facades\Stats;
.......

public function purchaseUpdate(Request $request){
    // other statement
    ............

    foreach($purchaseProducts as $product){
        // purchase products update statements
        ..............
        ..............

        //live stock
        $variation = (int) $newQty - $oldQty;

        Stats::when($variation > 0,function ($stats) use ($product,$variation){
            $stats->title('Live stock')->key($product->id)->increase($variation);
        });

        Stats::when($variation < 0,function ($stats) use ($product,$variation){
            $stats->title('Live stock')->key($product->id)->decrease(abs($variation));
        });
    }
}
```

Decrease product stock whenever a purchase product is delete.

```
use RadiateCode\DaStats\Facades\Stats;
.......

public function productDelete($id){
    // other statement
    ............

    // find product
    $purchaseProduct = PurchaseProduct::findOrFail($id);

    // decrese value for this product
    Stats::title('Live stock')->key($purchaseProduct->id)->decrease($purchaseProduct->quantity);

    $purchaseProduct->delete(); // purchase product delete
}
```

### Get the statistics

[](#get-the-statistics)

Above examples have shown us that how we can create stats by placing increase(), decrease() inside data **CRUD operations**.

Now let's get or view our stats.

```
$stats = Stats::key('total-pending-order')->find();

$stats = Stats::key('total-user')->find();

$stock = Stats::title('Live stock')->get();
```

or

```
$stats = Stats::inKeys('total-pending-order','total-user')->get();

// get stock by product ids
$stocks = Stats::inKeys(1,22,55,66)->get();
```

or

```
$stats = Stats::contains('pending')->get();
```

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require radiatecode/dastats

```

Migrate the stats table

```
php artisan dastats:table

php artisan migrate

```

You can publish config file (optional)

```
php artisan vendor:publish --provider="RadiateCode\DaStats\StatsServiceProvider" --tag="dastats-config"

```

Usages
------

[](#usages)

### Stats increase:

[](#stats-increase)

Increase stats for given key and title.

```
Stats::title('Your Title')->key('your-key')->increase();
```

> Increase by **default 1**, But you can pass any specific numerical value.

> Under the hood **increase()** check is there any stats exits for the given key &amp; title, if yes it will increment, if not it will create new record

### Stats decrease:

[](#stats-decrease)

Decrease stats value for given key.

```
Stats::key('your-key')->decrease();
```

or

```
Stats::title('Your Title')->key('your-key')->decrease();
```

> Decrease method decrease a stats by **1 (default)**, But you can decrease by any specific value.

> Under the hood **decrease()** checks stats existence, if found it will decrement otherwise return null. During decrement if the decrement comes at zero it will delete the stats record from the storage.

### Stats replace:

[](#stats-replace)

In some cases we need to replace our existing stats value in those cases replace() can be used

```
Stats::key('your-key')->replace($value);
```

or

```
Stats::title('Your Title')->key('your-key')->replace($value);
```

### Get stats by keys

[](#get-stats-by-keys)

```
Stats::inKeys('key-1','key-2')->get();
```

### Paginate

[](#paginate)

```
Stats::inKeys('key-1','key-2')->paginate(10);
```

### Find single stats

[](#find-single-stats)

```
Stats::title('Title 1')->key('key-1')->find();
```

or

```
Stats::key('key-1')->find();
```

### Check stats existence

[](#check-stats-existence)

```
Stats::title('Title 1')->key('key-1')->exists(); // return true/false
```

or

```
// based on existence do stats operation

Stats::title('Title')->key('key-1')->exists(
    function ($stats){ // if exists
        $stats->replace(300);
    },function ($stats){ // if not exists
        $stats->increase(25);
    }
);
```

### Get stats by contains a part of key

[](#get-stats-by-contains-a-part-of-key)

```
Stats::contain('partOfkey')->get();

example:
// key name is `total-registered-user`
// we can get stats by the key part `registered`
Stats::contain('registered')->get();
```

### Remove stats:

[](#remove-stats)

```
$stats = Stats::key('key-1')->remove();
```

or

```
Stats::inKeys('key-1','key-2','key-3')->remove();
```

### Join stats

[](#join-stats)

Join stats table with other db tables

#### joinWith()

[](#joinwith)

joinWith used to join a db table with stats table

```
Stats::joinWith('products', 'id') // joining products table
    ->title('inventory')
    ->get(['products.product_name', 'products.product_unit']);
```

#### join()

[](#join)

join as many tables as you want like regular laravel db join

```
Stats::joinWith('products', 'id') // joining products table
    ->join('categories','categories.id','=','products.category_id') // join categories table with products
    ->join('units','units.id','=','products.unit_id') // join units table with products
    ->title('inventory')
    ->get(['products.product_name', 'products.product_unit','categories.category_name','units.unit_name']);
```

> Note: get() method accept an array as an argument where it executes as db **'select'** statement

### Isolate stats:

[](#isolate-stats)

Isolation can be useful for SaaS applications, certain stats can be stored for individual user or organisation or tenant.

```
Stats::isolate('Tenant',101)->title('Total Order')->key('order-count')->increment();

Stats::isolate('Tenant',101)->key('order-count')->find();
```

or

```
Stats::isolate('User',202)->title('Complete Project')->key('project-completion')->increment();

Stats::isolate('User',202)->key('project-completion')->find();
```

### Conditional operation:

[](#conditional-operation)

```
Stats::when($some_condition,function($stats){
    return $stats->title('Title 1')->key('key-1')->increase(8000);
});
```

or

```
Stats::title('Title 1')->key('key-1')
->when($some_condition,
    function($stats){ // when condition true
        return $stats->decrease(2500);
    },function(){ // when condition false
        return $stats->increase(500);
    }
);
```

or

```
Stats::when($has_tenant,function($stats) use ($tenantId){
    return $stats->isolate('Tenant', $tenantId);
})->all();
```

### Multiple increase or decrease or replace

[](#multiple-increase-or-decrease-or-replace)

For multiple increase or decrease we can use **doMany()**

```
use RadiateCode\DaStats\Enum\StatsAction;
...........

// data format
$data =  [
    ['key' => 'key-1','value' = 40],
    ['key' => 'key-2','value' = 25],
    ['key' => 'key-3','value' = 35],
]

// action (ex: StatsAction::INCREASE, StatsAction::DECREASE, StatsAction::REPLACE)
$action = StatsAction::INCREASE

Stats::title('Live stock')->doMany($action,$data);
```

**when required isolation**

```
// data format
$data =  [
    ['key' => 'key-1','value' = 40],
    ['key' => 'key-2','value' = 25],
    ['key' => 'key-3','value' = 35],
]

Stats::isolate('Organisation',$organisaiton->id)->title('Live stock')->doMany(StatsAction::INCREASE,$data);
```

> **Note:** Data format should be followed as the example.

So In example 3 we see that increase operation used inside purchase products loop, but now we can use **doMany()** to do multiple increase by passing an array which contain product id and quantity

```
Stats::title('Live stock')->doMany(
    StatsAction::INCREASE,
    [
        ['key' => 1,'value' = 500], // key => product id and value => quantity
        ['key' => 5,'value' = 152],
        ['key' => 35,'value' = 7569],
        ['key' => 7,'value' = 900],
        ['key' => 9,'value' = 25],
    ]
);
```

### Jobs

[](#jobs)

Sometimes we need to queue our stats so that it can run in the background without delaying user response, so in that case we can use predefined jobs.

> **Note:** make sure we have configured [Laravel Queue](https://laravel.com/docs/8.x/queues) and run the queue worker

**Single stats job:**

```
use RadiateCode\DaStats\Jobs\SingleStatsJob;
use RadiateCode\DaStats\Enum\StatsAction;
..........

// dispatch the job to increase a stats
dispatch(new SingleStatsJob(StatsAction::INCREASE,'Title','key',$value));

or

// dispatch the job to decrease a stats
dispatch(new SingleStatsJob(StatsAction::DECREASE,'Title','key',$value));

// dispatch the job to replace a stats
dispatch(new SingleStatsJob(StatsAction::REPLACE,'Title','key',$value));
```

**Multiple stats job:**

```
use RadiateCode\DaStats\Jobs\MultiStatsJob;
use RadiateCode\DaStats\Enum\StatsAction;
..........

$data = [
            ['key' => 1,'value' = 500],
            ['key' => 5,'value' = 152],
        ];

// dispatch the job to decrease multiple stats value
dispatch(new MultiStatsJob(StatsAction::DECREASE,'Title',$data));
```

or

```
// dispatch the job to increase multiple stats value
dispatch(new MultiStatsJob(StatsAction::INCREASE,'Title',$data));
```

> when required isolation

```
use RadiateCode\DaStats\Jobs\MultiStatsJob;
use RadiateCode\DaStats\Enum\StatsAction;
..........

$data = [
            ['key' => 1,'value' = 500],
            ['key' => 5,'value' = 152],
        ];

$job = new MultiStatsJob(StatsAction::DECREASE,'Title',$data);

$job->withIsolation('Tenant',1001);

dispatch($job);
```

### DB Table Structure

[](#db-table-structure)

[![Stats Table](img/db.png)](img/db.png)

Available methods
-----------------

[](#available-methods)

Stats can be call either by **Stats Facade** or **new Stats()** class

Here are available methods

MethodsReturnNote`isolate(string $name,int $id)`return stats objectused for stats isolation`title(string $title)`return stats objectset stats title`key(string $key)`return stats objectset stats key`contain(string $key)`return stats objectset part of key`increase(int value = 1)`return boolincrease by default 1, can be pass specific numerical value`decrease(int value = 1) `return booldecrease by default 1, can be pass any numerical value`replace(int value) `return boolreplace existing stats value`doMany(string $action, array $data)`return boolincrease, decrease or replace multiple data`inKeys(...$key)`return stats objectfind stats by multiple keys`find()`return mixed or eloquent collectionfind specific stats`paginate(int $perPage = 10)`return mixed or eloquent collectionget stats by paginate`get(array $columns = [])`return mixed or eloquent collectionget stats data, argument used to select table columns`exists(callable $existsCallback = null,callable $notExistsCallback = null)`return true/false if args emptywe can apply stats operation based on exist condition by passing args, 1st arg works when stats exists, 2nd arg works when stats not exists. If no args pass then it simply return true/false.`remove()`return true or falseremove particular stats`when(bool $value,callable $callback,callable $default = null)`return stats objectconditionally apply stats operation`joinWith(string $table,string $pk = 'id')`return stats objectjoin the table with stats table`join($table, $first, $operator = null, $second = null)`return stats objectjoin more than one table with statsContributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security
--------

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Noor Alam](https://github.com/radiatecode)
- [All Contributors](https://github.com/radiatecode/dastats/contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity60

Established project with proven stability

 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

Every ~52 days

Recently: every ~65 days

Total

6

Last Release

1490d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/d4c058d89958aa7ac30c04fb81d7768246c72de5234a78943125b23f9bea4762?d=identicon)[radiatecode](/maintainers/radiatecode)

---

Top Contributors

[![radiatecode](https://avatars.githubusercontent.com/u/51012746?v=4)](https://github.com/radiatecode "radiatecode (29 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/radiatecode-dastats/health.svg)

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

PHPackages © 2026

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