PHPackages                             mmb/thunder - 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. mmb/thunder

ActiveLibrary

mmb/thunder
===========

031PHP

Since Nov 19Pushed 1y agoCompare

[ Source](https://github.com/rapidmmb/thunder)[ Packagist](https://packagist.org/packages/mmb/thunder)[ RSS](/packages/mmb-thunder/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (3)Used By (0)

⚡ Mmb Thunder
=============

[](#-mmb-thunder)

What Is Thunder?
----------------

[](#what-is-thunder)

Thunder run a listener to the telegram and open some process in the background (grouped by [Tagger](#Tagger)), and then pass the updates to child processes.

That means the application is ready to handle updates! Doesn't need to load all packages, configs, service providers per each update.

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

[](#installation)

Easily install using:

```
composer require mmb/thunder:dev-main
```

Commands
--------

[](#commands)

### Start Command

[](#start-command)

To start the thunder service, run this command:

```
php artisan thunder:start
```

Or run it in background process:

```
php artisan thunder:start > /dev/null &
```

### Stop Command

[](#stop-command)

To stop the thunder service that running in the background, run this command:

```
php artisan thunder:stop
```

This command send a message to main thunder process and request to stop that. It may take a long time, because the main process is blocked for listening to Telegram. You can send a message to Telegram to make it faster XD.

### Hot Reload

[](#hot-reload)

If you change a code, the thunder process will not refresh the process (actually this is the point of thunder to speeding up). But you can run the following command to kill and reload the processes.

```
php artisan thunder:hot-reload
```

Customize
---------

[](#customize)

### Publish

[](#publish)

Publish the config with following command:

```
php artisan vendor:publish --tag=thunder
```

### Puncher

[](#puncher)

Puncher is the way to open new process for a tag and update.

```
'driver' => 'process',
```

> Currently, only "process" driver is available.

Release is time to release a tagged process when no updates are available for that.

```
'release' => 180,
```

### Tagger

[](#tagger)

Tagging is grouping the updates to handle by a separate process.

```
'tagger' => [
    'class' => Tagger\ChatTagger::class,
],
```

You can customize tagger:

```
class UserTagger implements Tagger
{
    public function tag(Update $update) : string
    {
        return $update->getUser()?->id ?? 'global';
    }
}
```

### Sharing

[](#sharing)

Sharing is the way to main process and child process should connect to each other and send messages.

```
'driver' => 'pipe',
```

> Currently, only "pipe" and "file" driver is available.

### Hook

[](#hook)

Hook is settings for listening for updates.

The "long" key is the timeout for "getUpdates" method in Telegram api. This parameter is time to wait by telegram until new update passed.

```
'long' => 60,
```

###  Health Score

17

—

LowBetter than 6% of packages

Maintenance31

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity20

Early-stage or recently created project

 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.

### Community

Maintainers

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

---

Top Contributors

[![MahdiSaremi](https://avatars.githubusercontent.com/u/95860107?v=4)](https://github.com/MahdiSaremi "MahdiSaremi (26 commits)")

### Embed Badge

![Health badge](/badges/mmb-thunder/health.svg)

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

PHPackages © 2026

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