PHPackages                             tigris/tigris - 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. [Framework](/categories/framework)
4. /
5. tigris/tigris

ActiveLibrary[Framework](/categories/framework)

tigris/tigris
=============

Tigris is a modern Telegram bot framework written in PHP

0.2.5(8y ago)3873MITPHPPHP >=7.0

Since Nov 8Pushed 8y ago2 watchersCompare

[ Source](https://github.com/tigris-php/tigris)[ Packagist](https://packagist.org/packages/tigris/tigris)[ RSS](/packages/tigris-tigris/feed)WikiDiscussions master Synced today

READMEChangelog (8)Dependencies (4)Versions (9)Used By (0)

Tigris: Telegram Bot Framework
==============================

[](#tigris-telegram-bot-framework)

[![Build Status](https://camo.githubusercontent.com/38089c2ecb51ec10b270504b8d7e04af3716d6f23e361b52f1849179f59ef95d/68747470733a2f2f7472617669732d63692e6f72672f7469677269732d7068702f7469677269732e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/tigris-php/tigris)[![Join the chat at https://gitter.im/tigris-php/tigris](https://camo.githubusercontent.com/ba8bd54b203b2b6f29b55f2b3786d16d0b7dc4332df66f878c2b02b9b563db67/68747470733a2f2f6261646765732e6769747465722e696d2f7469677269732d7068702f7469677269732e737667)](https://gitter.im/tigris-php/tigris?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)[![GitHub license](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://raw.githubusercontent.com/tigris-php/tigris/master/LICENSE.md)

Tigris is a modern reactive event-driven Telegram bot framework written in PHP.

Usage
-----

[](#usage)

### Without extending the Bot class

[](#without-extending-the-bot-class)

*Create a bot instance*

```
$bot = (new BotFactory())->create($apiToken);
```

*Define your custom even handlers*

```
$bot = (new BotFactory())->create($apiToken);
$bot->addListener(MessageEvent::EVENT_TEXT_MESSAGE_RECEIVED, function (MessageEvent $event) use ($bot) {
    // sending your first message
    $bot->getApi()->sendMessage([
        'chat_id' => $event->message->chat->id,
        'text' => 'Hello World!',
    ]);
});
```

*Run your bot*

```
$bot->run();
```

### Extending the Bot class

[](#extending-the-bot-class)

*Extend the Tigris\\Bot class to create your own bot implementation*

```
class SampleBot extends \Tigris\Bot
{
    // bootstraping your bot
    public function bootstrap()
    {
        // registering event callback
        $this->addListener(MessageEvent::EVENT_TEXT_MESSAGE_RECEIVED, function (MessageEvent $event) {
            // sending your first message
            $this->getApi()->sendMessage([
                'chat_id' => $event->message->chat->id,
                'text' => 'Hello World!',
            ]);
        });
    }
}
```

*Run the bot instance*

```
$bot = (new BotFactory(SampleBot::class))->create($apiToken);
$bot->run();
```

License
-------

[](#license)

MIT

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 87.1% 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 ~38 days

Recently: every ~1 days

Total

8

Last Release

3256d ago

PHP version history (2 changes)0.1PHP >=5.5.0

0.2PHP >=7.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1297270?v=4)[Vahid G](/maintainers/lagman)[@lagman](https://github.com/lagman)

---

Top Contributors

[![metalagman](https://avatars.githubusercontent.com/u/1983796?v=4)](https://github.com/metalagman "metalagman (142 commits)")[![doozookn](https://avatars.githubusercontent.com/u/12435740?v=4)](https://github.com/doozookn "doozookn (11 commits)")[![theorder83](https://avatars.githubusercontent.com/u/23296280?v=4)](https://github.com/theorder83 "theorder83 (9 commits)")[![gitter-badger](https://avatars.githubusercontent.com/u/8518239?v=4)](https://github.com/gitter-badger "gitter-badger (1 commits)")

---

Tags

apiframeworkbottelegram

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[ccxt/ccxt

A cryptocurrency trading API with more than 100 exchanges in JavaScript / TypeScript / Python / C# / PHP / Go

43.1k337.6k1](/packages/ccxt-ccxt)[nutgram/nutgram

The Telegram bot library that doesn't drive you nuts

729266.3k8](/packages/nutgram-nutgram)[nutgram/laravel

Laravel package for Nutgram

49120.7k4](/packages/nutgram-laravel)[digitalstars/simplevk

Powerful PHP library/framework for VK API bots, supporting LongPoll & Callback & OAuth

924.2k3](/packages/digitalstars-simplevk)[psx/psx

PHP REST API Framework

17112.6k3](/packages/psx-psx)[kornrunner/ccxt

A PHP cryptocurrency trading library with support for more than 90 bitcoin/altcoin exchanges

371.6k](/packages/kornrunner-ccxt)

PHPackages © 2026

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