在PHP中使用Sentry非常简单。安装库后,您可以直接与客户端连接并开始提交数据。
一、基本
最重要的部分是创建raven客户端。创建一次,并从想要与Sentry接口的任何地方引用它:
$sentryClient = new Raven_Client('https://<key>@sentry.io/<project>');
二、捕获错误
Sentry包含用于报告任何未捕获的异常或PHP错误的基本功能。这是通过错误处理程序完成的,并为PHP的每个内置报告提供了适当的挂钩:
$error_handler = new Raven_ErrorHandler($sentryClient);
$error_handler->registerExceptionHandler();
$error_handler->registerErrorHandler();
$error_handler->registerShutdownFunction();
三、上报错误
如果要手动报告异常,可以使用captureException函数。
// Basic Reporting
$sentryClient->captureException($ex);
// Provide some additional data with an exception
$sentryClient->captureException($ex, array(
'extra' => array(
'php_version' => phpversion()
),
));
四、上报其他错误
有时您没有实际的异常对象,但发生了一些不好的事情并且您想要报告它。这就是captureMessage的用武之地。它接收一条消息并将其报告给哨兵。
// Capture a message
$sentryClient->captureMessage('my log message');
注意,captureMessage的API与captureException略有不同,以支持参数化格式:
$sentryClient->captureMessage('my %s message', array('log'), array(
'extra' => array(
'foo' => 'bar',
),
));