PHPackages                             ingress-it-solutions/bugtrap - 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 &amp; Monitoring](/categories/logging)
4. /
5. ingress-it-solutions/bugtrap

ActiveLibrary[Logging &amp; Monitoring](/categories/logging)

ingress-it-solutions/bugtrap
============================

Laravel 5 bug notifier

v1.3(6y ago)067MITPHPPHP &gt;=5.6.0

Since Feb 13Pushed 6y agoCompare

[ Source](https://github.com/ingress-it-solutions/bug-trap)[ Packagist](https://packagist.org/packages/ingress-it-solutions/bugtrap)[ RSS](/packages/ingress-it-solutions-bugtrap/feed)WikiDiscussions master Synced yesterday

READMEChangelog (4)Dependencies (2)Versions (5)Used By (0)

 [![](https://camo.githubusercontent.com/fa68d2ac467a0473239b09cbf07687befaa255cc9159ba45e64b9671be9f8371/68747470733a2f2f7777772e696e677265737369742e636f6d2f696d616765732f69636f6e313238783132312e706e67)](https://www.bugtrap.io)

BugTrap
=======

[](#bugtrap)

Laravel 5 package for logging errors to bugtrap.io

[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)

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

[](#installation)

You can install the package through Composer.

```
composer require ingress-it-solutions/bugtrap
```

*In case of Laravel 5.5, you still need to manually register this as the service provider has to be the first provider that needs to be registered.*

You must install this service provider. Make this the very *first* provider in list.

```
// config/app.php
'providers' => [
    // Make this very first provider
    BugTrap\ServiceProvider::class,

    //...
    //...
];
```

Then publish the config and migration file of the package using artisan.

```
php artisan vendor:publish --provider="BugTrap\ServiceProvider"
```

And adjust config file (`config/bugtrap.php`) with your desired settings.

Add to your Exception Handler's (`/app/Exceptions/Handler.php` by default) `report` method these line and add the use line:

```
use BugTrap\BugTrap;
...

public function render(Exception $e, $request)
{
    if ($this->shouldReport($e)) {
        (new BugTrap)->handle($e, $request);
    }

    return parent::report($e);
}
```

Usage
-----

[](#usage)

All that is left to do is to define 3 ENV configuration variables.

```
BT_KEY=
BT_PROJECT_KEY=
BT_URL=

```

`BT_KEY` is your profile key which authorises your account to the API. `BT_PROJECT_KEY` is your project API key which you receive when creating a project. `BT_PROJECT_KEY` is your base URL of Bugtrap Installation.

Get these variables at [bugtrap.com](https://www.bugtrap.com)

Optional
--------

[](#optional)

You can also return a specific view if an error has been generated. This eliminates the ugly 'Whoops something went wrong' page.

All you have to do is create a view (`500.blade.php`) that you return for your user, recommended in the `views/errors` directory.

Then in your `App\Exceptions\Handler.php` add the following code inside the `render` method:

```
if (($errorView = (new BugTrap)->errorView()) !== false) {
    return $errorView;
}
```

Make sure you add this **before** the `return parent::render($request, $exception);` code.

Example:

```
/**
 * Render an exception into an HTTP response.
 *
 * @param  \Illuminate\Http\Request  $request
 * @param  \Exception  $exception
 * @return \Illuminate\Http\Response
 */
public function render($request, Exception $exception)
{
    ...

    if (($errorView = (new BugTrap)->errorView()) !== false) {
        return $errorView;
    }

    return parent::render($request, $exception);
}
```

License
-------

[](#license)

The bugtrap package is open source software licensed under the [license MIT](http://opensource.org/licenses/MIT)

Contributors
------------

[](#contributors)

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

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 ~113 days

Total

4

Last Release

2304d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/47470909?v=4)[vandanafuletra](/maintainers/vandanafuletra)[@vandanafuletra](https://github.com/vandanafuletra)

---

Tags

loglaravelerror

### Embed Badge

![Health badge](/badges/ingress-it-solutions-bugtrap/health.svg)

```
[![Health](https://phpackages.com/badges/ingress-it-solutions-bugtrap/health.svg)](https://phpackages.com/packages/ingress-it-solutions-bugtrap)
```

###  Alternatives

[larabug/larabug

Laravel 6.x/7.x/8.x/9.x/10.x/11.x/12.x/13.x bug notifier

299549.3k1](/packages/larabug-larabug)[saasscaleup/laravel-log-alarm

Laravel log Alarm help you to set up alarm when errors occur in your system and send you a notification via Slack and email

27025.0k](/packages/saasscaleup-laravel-log-alarm)[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)[yaro/log-envelope

Laravel 5 email on error

4147.0k](/packages/yaro-log-envelope)[hosmelq/laravel-logsnag

Integrate the power of LogSnag's real-time event tracking into your Laravel application.

237.9k](/packages/hosmelq-laravel-logsnag)

PHPackages © 2026

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