composer require airbrake/phpbrake// Create new Notifier instance.
$notifier = new Airbrake\Notifier([
'projectId' => 12345, // FIX ME
'projectKey' => 'abcdefg' // FIX ME
]);
// Set global notifier instance.
Airbrake\Instance::set($notifier);
// Register error and exception handlers.
$handler = new Airbrake\ErrorHandler($notifier);
$handler->register();
// Somewhere in the app...
try {
throw new Exception('hello from phpbrake');
} catch(Exception $e) {
Airbrake\Instance::notify($e);
}Notifier API consists of 4 methods:
buildNotice- builds Airbrake notice.sendNotice- sends notice to Airbrake.notify- shortcut forbuildNoticeandsendNotice.addFilter- adds filter that can modify and/or filter notices.
$notifier->addFilter(function ($notice) {
$notice['context']['environment'] = 'production';
return $notice;
});$notifier->addFilter(function ($notice) {
if (isset($notice['params']['password'])) {
$notice['params']['password'] = 'FILTERED';
}
return $notice;
});$notifier->addFilter(function ($notice) {
if ($notice['errors'][0]['type'] == 'MyExceptionClass') {
// Ignore this exception.
return null;
}
return $notice;
});Notifier can handle PHP errors, uncaught exceptions and shutdown. You can register appropriate handlers using following code:
$handler = new Airbrake\ErrorHandler($notifier);
$handler->register();Under the hood $handler->register does following:
set_error_handler([$this, 'onError'], error_reporting());
set_exception_handler([$this, 'onException']);
register_shutdown_function([$this, 'onShutdown']);See https://github.com/TheoKouzelis/laravel-airbrake
See https://github.com/aminin/airbrake-bundle
See https://gist.github.com/mauriciovillalobos/01a97f9ee6179ad70b17d54f37cc5010
$log = new Monolog\Logger('billing');
$log->pushHandler(new Airbrake\MonologHandler($notifier));
$log->addError('charge failed', ['client_id' => 123]);The version of your application that you can pass to differentiate exceptions between multiple versions. It's not set by default.
$notifier = new Airbrake\Notifier([
// ...
'appVersion' => '1.2.3',
// ...
]);By default, it is set to api.airbrake.io. A host is a web address containing a
scheme ("http" or "https"), a host and a port. You can omit the port (80 will be
assumed) and the scheme ("https" will be assumed).
$notifier = new Airbrake\Notifier([
// ...
'host' => 'errbit.example.com', // put your errbit host here
// ...
]);Configures the root directory of your project. Expects a String or a Pathname, which represents the path to your project. Providing this option helps us to filter out repetitive data from backtrace frames and link to GitHub files from our dashboard.
$notifier = new Airbrake\Notifier([
// ...
'rootDirectory' => '/var/www/project',
// ...
]);Configures the environment the application is running in. Helps the Airbrake dashboard to distinguish between exceptions occurring in different environments. By default, it's not set.
$notifier = new Airbrake\Notifier([
// ...
'environment' => 'staging',
// ...
]);Configures the underlying http client. Expects "guzzle", "curl" or "default".
- In order to use the "guzzle" client, the composer package "guzzlehttp/guzzle" must be installed.
- Curl needs the curl php extension installed. See phpinfo().
- The default client uses the php function "file_get_contents". Make sure "allow_url_fopen" is set to "1" in your php.ini. If not set the default client is used.
$notifier = new Airbrake\Notifier([
// ...
'httpClient' => 'curl',
// ...
]);composer install
vendor/bin/phpunitcomposer require phpdocumentor/phpdocumentor
bin/phpdoc -d src
firefox output/index.htmlPHPBrake is licensed under The MIT License (MIT).