raven-php is an experimental PHP client for Sentry.

// Instantiate a new client with a compatible DSN
$client = new Raven_Client('http://public:[email protected]/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();

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"
    }
}

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';

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',
));

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

Defaults to Raven_Compat::gethostname()

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

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

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.

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

• Bug Tracker
• Code
• Mailing List
• IRC (irc.freenode.net, #sentry)