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));
// Provide some additional data with an exception
$event_id = $client->getIdent($client->captureException($ex, array(
'extra' => array(
'php_version' => phpversion()
),
)));
// 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.
Set this to false
to disable reflection tracing (fuction calling arguments) in stacktraces.
Adjust the default logger name for messages.
Defaults to php
.
- Bug Tracker
- Code
- Mailing List
- IRC (irc.freenode.net, #sentry)