PHP中使用Sentry（一）

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