PHPackages                             k1low/faultline - 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. [Mail & Notifications](/categories/mail)
4. /
5. k1low/faultline

ActiveLibrary[Mail & Notifications](/categories/mail)

k1low/faultline
===============

faultline exception and error notifier for PHP

v0.7.0(7y ago)96.9k3[1 PRs](https://github.com/faultline/faultline-php/pulls)MITPHP

Since Dec 8Pushed 7y ago4 watchersCompare

[ Source](https://github.com/faultline/faultline-php)[ Packagist](https://packagist.org/packages/k1low/faultline)[ RSS](/packages/k1low-faultline/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (5)Versions (12)Used By (0)

faultline-php [![Travis](https://camo.githubusercontent.com/4723c15c9d0c8214d616962cb58566b32f8a6508848f03cfe76b028b9dad80d9/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f6661756c746c696e652f6661756c746c696e652d7068702e737667)](https://travis-ci.org/faultline/faultline-php)
================================================================================================================================================================================================================================================================================================

[](#faultline-php-)

> [faultline](https://github.com/faultline/faultline) exception and error notifier for PHP.

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

[](#installation)

```
$ composer require faultline/faultline
```

Usage
-----

[](#usage)

```
// Create new Notifier instance.
$notifier = new Faultline\Notifier([
    'project' => 'faultline-php',
    'apiKey' => 'xxxxXXXXXxXxXXxxXXXXXXXxxxxXXXXXX',
    'endpoint' => 'https://xxxxxxxxx.execute-api.ap-northeast-1.amazonaws.com/v0',
    'timeout' => '30.0',
    'notifications' => [
        [
            'type'=> 'slack',
            'endpoint'=> 'https://hooks.slack.com/services/XXXXXXXXXX/B2RAD9423/WC2uTs3MyGldZvieAtAA7gQq',
            'channel'=> '#random',
            'username'=> 'faultline-notify',
            'notifyInterval'=> 5,
            'threshold'=> 10,
            'timezone'=> 'Asia/Tokyo'
        ],
        [
            'type'=> 'github',
            'userToken'=> 'XXXXXXXxxxxXXXXXXxxxxxXXXXXXXXXX',
            'owner'=> 'k1LoW',
            'repo'=> 'faultline',
            'labels'=> [
                'faultline', 'bug'
            ],
            'if_exist'=> 'reopen-and-comment',
            'notifyInterval'=> 1,
            'threshold'=> 1,
            'timezone'=> 'Asia/Tokyo'
        ]
    ]
]);

// Set global notifier instance.
Faultline\Instance::set($notifier);

// Register error and exception handlers.
$handler = new Faultline\ErrorHandler($notifier);
$handler->register();

// Somewhere in the app...
try {
    throw new Exception('hello from faultline-php');
} catch(Exception $e) {
    Faultline\Instance::notify($e);
}
```

Monolog integration
-------------------

[](#monolog-integration)

```
$log = new Monolog\Logger('acl');
$log->pushHandler(new Faultline\MonologHandler($notifier));

$log->addError('permission denied', ['user_id' => 123]);
```

References
----------

[](#references)

- faultline-php is based on [airbrake/phpbrake](https://github.com/airbrake/phpbrake)
    - PHPBrake is licensed under [The MIT License (MIT)](https://github.com/airbrake/phpbrake/LICENSE).

License
-------

[](#license)

MIT © Ken'ichiro Oyama

###  Health Score

33

—

LowBetter than 74% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity26

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 97.8% 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 ~66 days

Recently: every ~103 days

Total

10

Last Release

2839d ago

### Community

Maintainers

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

---

Top Contributors

[![k1LoW](https://avatars.githubusercontent.com/u/57114?v=4)](https://github.com/k1LoW "k1LoW (45 commits)")[![litencatt](https://avatars.githubusercontent.com/u/17349045?v=4)](https://github.com/litencatt "litencatt (1 commits)")

---

Tags

error-notifierfaultlinenotificationsexceptionerrornotifier

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

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

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

###  Alternatives

[symfony/notifier

Sends notifications via one or more channels (email, SMS, ...)

80640.3M290](/packages/symfony-notifier)[guanguans/notify

Push notification SDK(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).

682104.9k7](/packages/guanguans-notify)[airbrake/phpbrake

Airbrake exception and error notifier for PHP

492.0M25](/packages/airbrake-phpbrake)[symfony/slack-notifier

Symfony Slack Notifier Bridge

426.1M11](/packages/symfony-slack-notifier)[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)[themonkeys/error-emailer

Emails you whenever an error occurs on your server

4916.6k](/packages/themonkeys-error-emailer)

PHPackages © 2026

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