README

Since flippa deleted his repository we republished it so we can keep using it

这是一个功能齐全的客户端，可以为任何PHP >= 5.3应用程序添加与Errbit（或Airbrake）的集成。

我们对php-airbrake-notifier客户端有一些问题，因此我们基于实际的airbrake gem编写了这个。

php-airbrake-notifier客户端会定期尝试向Airbrake服务发送无效的XML，并且完全不与Errbit（免费的自托管Airbrake兼容应用程序）一起工作。

安装

我们没有将其放入PEAR或类似的东西中（请随时贡献），因此您需要本地安装它。

git clone git@github.com:sumocoders/errbit-php.git

Composer

只需将以下行添加到您的composer.json文件中的require部分

composer require sumocoders/errbit-php

如果您使用上面的行，您不需要要求任何内容，所有内容都将通过composer-autoloader自动加载

用法

使用notifier的预期方式是作为一个单例，尽管这并不是强制性的，如果您出于某种奇怪的原因需要多个实例，或者单例一词让您感到难过，您也可以这样做。

require_once 'errbit-php/lib/Errbit.php';

Errbit::instance()
  ->configure(array(
    'api_key'           => 'YOUR API KEY',
    'host'              => 'YOUR ERRBIT HOST, OR api.airbrake.io FOR AIRBRAKE',
    'port'              => 80,                                   // optional
    'secure'            => false,                                // optional
    'project_root'      => '/your/project/root',                 // optional
    'environment_name'  => 'production',                         // optional
    'params_filters'    => array('/password/', '/card_number/'), // optional
    'backtrace_filters' => array('#/some/long/path#' => '')      // optional
  ))
  ->start();

这将安装错误处理器，捕获您的PHP错误（根据您的error_reporting设置）并将它们记录到Errbit。

如果您想手动通知异常，可以调用notify()。

try {
  somethingErrorProne();
} catch (Exception $e) {
  Errbit::instance()->notify(
    $e,
    array('controller'=>'UsersController', 'action'=>'show')
  );
}

使用自己的错误处理器

如果您不希望Errbit安装自己的错误处理器而更喜欢使用自己的，只需省略对start()的调用即可，然后无论您在哪里捕获Exception（注意错误必须转换为Exception），只需简单地调用

Errbit::instance()->notify($exception);

仅使用一些默认处理器

Errbit安装了三个错误处理器：异常、错误和致命。

默认情况下，都会使用这三个。如果您只想使用某些处理器，可以使用其他处理器，可以将列表传递给start()方法。

Errbit::instance()->start(array('error', 'fatal')); // using our own exception handler

待办事项

一些测试将会很棒。

许可 & 版权

版权 © Flippa.com Pty. Ltd. 根据MIT许可协议授权。有关详细信息，请参阅LICENSE文件。