PHPackages                             mamitech/tikus - 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. [Logging & Monitoring](/categories/logging)
4. /
5. mamitech/tikus

ActiveProject[Logging & Monitoring](/categories/logging)

mamitech/tikus
==============

An abstract layer for remote error reporting

v4.0.0(9mo ago)02.9kMITPHPPHP ~7.4.0|^8

Since Aug 18Pushed 9mo ago6 watchersCompare

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

READMEChangelog (3)Dependencies (7)Versions (8)Used By (0)

mamitech/tikus
==============

[](#mamitechtikus)

Add Tikus to report your errors to remote error reporting systems such as Bugsnag and Sentry.

This library supports PHP 7.4+.

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

[](#installation)

Merge this into your composer.json

```
  ...
  "require": {
    "mamitech/tikus": "^1.0"
  }
  ...
  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/mamitech/tikus.git"
    }
  ],
  ...
```

Run the command below:

```
composer update mamikos/tikus
```

Register `tikus` service provider in providers array in `config/app.php` before your `AppServiceProvider::class`:

```
'providers' => [
    // ...
    Mamikos\Tikus\Facades\TikusFacade::class,
    // ...
],
```

Register an alias in `config/app.php`:

```
'aliases' => [
    // ...
    'Tikus' => Mamikos\Tikus\Facades\TikusFacade::class,
],
```

Put this code in `report` method of `app/Exceptions/Handler.php`

```
use Tikus;

...

public function report(Exception $exception)
{
    if ($this->shouldReport($exception)) {
        Tikus::reportException($exception);
    }
    parent::report($exception);
}
```

To use the configured Bugsnag client, import an alias each time:

```
use Tikus;

Tikus::reportException($e);
```

Basic configuration
-------------------

[](#basic-configuration)

Configure your Bugsnag or Sentry keys in your `.env` file:

```
BUGSNAG_API_KEY=your-api-key-here

SENTRY_ENVIRONMENT="${APP_ENV}"
SENTRY_LARAVEL_DSN=your-sentry-dsn

```

Methods
=======

[](#methods)

reportException(Throwable $throwable, Array $metadata = \[\])
-------------------------------------------------------------

[](#reportexceptionthrowable-throwable-array-metadata--)

- throwable: Any Throwable, Any Exception
- metadata: metadata in array

### Usage

[](#usage)

```
use Tikus;
...
catch (Exception $e)
{
  Tikus::reportException($e);
}
```

```
Tikus::reportException(new Exception('Data not found'), [
  'data_id': $data->id
]);
```

reportError($name, $message, Array $metadata = \[\])
----------------------------------------------------

[](#reporterrorname-message-array-metadata--)

- name: error type
- message: error message
- metadata: metadata in array

### Usage

[](#usage-1)

```
use Tikus;

Tikus::reportError('Info', 'Data is expired');

Tikus::reportError('Info', 'Data is expired', ['expired_at': '2022-07-01 12:59:00']);

// supports nested array
Tikus::reportError('Info', 'My wishlist is', [
  'wishlist': [
    'game': 'overwatch 2',
    'movie': 'topgun: maverick'
  ]
]);
```

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance58

Moderate activity, may be stable

Popularity17

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 59.3% 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 ~274 days

Total

5

Last Release

272d ago

Major Versions

v1.0.0 → v2.0.02023-01-10

v2.1.0 → v3.0.02024-10-21

v3.0.0 → v4.0.02025-08-18

PHP version history (2 changes)v1.0.0PHP >=7.4

v2.0.0PHP ~7.4.0|^8

### Community

Maintainers

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

---

Top Contributors

[![gilbok](https://avatars.githubusercontent.com/u/1301040?v=4)](https://github.com/gilbok "gilbok (16 commits)")[![ikanlangit](https://avatars.githubusercontent.com/u/64217980?v=4)](https://github.com/ikanlangit "ikanlangit (5 commits)")[![githubmamiteam](https://avatars.githubusercontent.com/u/68682309?v=4)](https://github.com/githubmamiteam "githubmamiteam (3 commits)")[![tofasuriawan24](https://avatars.githubusercontent.com/u/136300993?v=4)](https://github.com/tofasuriawan24 "tofasuriawan24 (2 commits)")[![edchkm](https://avatars.githubusercontent.com/u/23701945?v=4)](https://github.com/edchkm "edchkm (1 commits)")

---

Tags

mamitechmamikostikusmamiteam

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[guanguans/laravel-exception-notify

Monitor exception and report to the notification channels(Log、Mail、AnPush、Bark、Chanify、DingTalk、Discord、Gitter、GoogleChat、IGot、Lark、Mattermost、MicrosoftTeams、NowPush、Ntfy、Push、Pushback、PushBullet、PushDeer、PushMe、Pushover、PushPlus、QQ、RocketChat、ServerChan、ShowdocPush、SimplePush、Slack、Telegram、WeWork、WPush、XiZhi、YiFengChuanHua、ZohoCliq、ZohoCliqWebHook、Zulip).

14642.7k1](/packages/guanguans-laravel-exception-notify)[kitloong/laravel-app-logger

Laravel log for your application

101.2M8](/packages/kitloong-laravel-app-logger)[label84/laravel-auth-log

Log user authentication actions in Laravel.

3654.0k](/packages/label84-laravel-auth-log)[shaffe/laravel-mail-log-channel

A package to support logging via email in Laravel

1286.2k](/packages/shaffe-laravel-mail-log-channel)

PHPackages © 2026

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