Raven is a PHP client for Sentry (getsentry.com)
PHP JavaScript
Pull request Compare This branch is 707 commits behind getsentry:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
lib/Raven
test
.gitignore
.travis.yml
AUTHORS
LICENSE
Makefile
README.rst
composer.json
phpunit.xml.dist

README.rst

raven-php

https://secure.travis-ci.org/getsentry/raven-php.png?branch=master

raven-php is a PHP client for Sentry.

// Instantiate a new client with a compatible DSN
$client = new Raven_Client('http://public:secret@example.com/1');

// Capture a message
$event_id = $client->getIdent($client->captureMessage('my log message'));

// Capture an exception
$event_id = $client->getIdent($client->captureException($ex));

// Give the user feedback
echo "Sorry, there was an error!";
echo "Your reference ID is " . $event_id;

// Install error handlers
$error_handler = new Raven_ErrorHandler($client);
$error_handler->registerExceptionHandler();
$error_handler->registerErrorHandler();

Installation

Install with Composer

If you're using Composer to manage dependencies, you can add Raven with it.

{
    "require": {
        "raven/raven": ">=0.2.0"
    }
}

or to get the latest version off the master branch:

{
    "require": {
        "raven/raven": "dev-master"
    }
}

Install source from GitHub

To install the source code:

$ git clone git://github.com/getsentry/raven-php.git

And include it in your scripts:

require_once '/path/to/Raven/library/Raven.php';

Or, alternatively use the autoloader:

require_once '/path/to/Raven/library/Raven/Autoloader.php';
Raven_Autoloader::register();

Or, if you're using Composer:

require_once 'vendor/autoload.php';

Configuration

Several options exist that allow you to configure the behavior of the Raven_Client. These are passed as the second parameter of the constructor, and is expected to be an array of key value pairs:

$client = new Raven_Client($dsn, array(
    'option_name' => 'value',
));

name

A string to override the default value for the server's hostname.

Defaults to Raven_Compat::gethostname()

tags

An array of tags to apply to events in this context.

'tags' => array(
    'php_version': phpversion(),
)

signing

Instructs the client to sign all messages. This behavior is deprecated in modern Sentry servers, and should only be enabled if you need it for legacy compatibility.

trace

Sets this to false to disable reflection tracing (fuction calling arguments) in stacktraces.

Resources