leeroy/sail-sentryio

Sentry.io 模块用于 SailCMS

1.0.7 2023-09-14 19:21 UTC

This package is auto-updated.

Last update: 2024-09-14 21:55:24 UTC


README

这是官方的 Sentry.io 包,用于 SailCMS。Sentry.io 是一个出色的应用程序性能和问题跟踪服务。

安装

php sail install:official leeroy/sail-sentryio

这将使用 composer 安装该包,然后更新您的 composer 文件来自动加载该包。

如果您想手动安装,可以执行以下操作

composer require leeroy/sail-sentryio

之后,您可以将 Leeroy\\Sentry 添加到 composer.json 文件中 sailcms 属性的模块部分。它应该看起来像这样

"sailcms": {
  "containers": ["Spec"],
  "modules": [
    "Leeroy\\SentryIO"
  ],
  "search": {}
}

配置

安装后,您需要将以下内容添加到您的 .env 文件中。

SENTRY_DSN="https://xxxxxxxxxxxxx.ingest.sentry.io/xxxxxxxxxxxxxx"
SENTRY_ORG="yourProjectOrOrganization"

使用

包的激活是自动的。激活后,您可以使用的是自定义异常处理。

这里有3种可用的方法。

capture

这会捕获异常,但不再进行其他操作。

try {
    //...
} catch (Exception $e) {
    Leeroy\Sentry::capture($e);
}

captureWithContext

这比 capture 更高级。使用此方法,您可以捕获异常,为它添加上下文和标签,并在 sentry 的 UI 中显示自定义消息。

try {
    //...
} catch (Exception $e) {
    Leeroy\Sentry::capture(
        $e, 
        'yourContextName', 
        ['your' => 'context data'], // don't add too much data
        ['tag1', 'tag2'], 
        'custom message!'
    );
}

captureLastError

这会捕获最后错误并将其发送到 Sentry。