README

糟糕的软件无处不在，我们对此感到厌倦。Sentry的使命是帮助开发者更快地编写更好的软件，以便我们能够重新享受技术。如果您想加入我们，请查看我们的职位空缺

官方Sentry SDK for Laravel

这是Sentry的官方Laravel SDK。

入门指南

以下安装步骤适用于Laravel框架的8.x、9.x和10.x版本。

对于旧版本的Laravel和Lumen，请参阅

• Laravel 8.x & 9.x & 10.x
• Laravel 6.x & 7.x
• Laravel 5.x
• Laravel 4.x
• Lumen

安装

安装sentry/sentry-laravel包

composer require sentry/sentry-laravel

通过修改app/Exceptions/Handler.php，启用捕获未处理的异常并报告给Sentry

use Sentry\Laravel\Integration;

public function register(): void
{
    $this->reportable(function (Throwable $e) {
        Integration::captureUnhandledException($e);
    });
}

或者，您可以将Sentry配置为Laravel Log Channel，以便捕获info和debug日志。

配置

使用以下命令配置Sentry DSN

php artisan sentry:publish --dsn=___PUBLIC_DSN___

它将创建配置文件（config/sentry.php）并将DSN添加到您的.env文件中。

SENTRY_LARAVEL_DSN=___PUBLIC_DSN___

用法

use function Sentry\captureException;

try {
    $this->functionThatMayFail();
} catch (\Throwable $exception) {
    captureException($exception);
}

有关如何使用SDK的更多信息，请参阅我们的文档。

Laravel版本兼容性

以下列出的Laravel和Lumen版本都受到支持

• Laravel >= 10.x.x 在PHP >= 8.1 上从3.2.0开始支持
• Laravel >= 9.x.x 在PHP >= 8.0 上从2.11.0开始支持
• Laravel >= 8.x.x 在PHP >= 7.3 上从1.9.0开始支持
• Laravel >= 7.x.x 在PHP >= 7.2 上从1.7.0开始支持
• Laravel >= 6.x.x 在PHP >= 7.2 上从1.2.0开始支持

请注意，从版本>= 2.0.0开始，我们要求PHP版本>= 7.2，因为我们正在使用我们新的PHP SDK。

以下列出的Laravel版本在Sentry SDK for Laravel的早期版本中得到支持

• Laravel <= 4.2.x 直到0.8.x得到支持
• Laravel <= 5.7.x 在PHP <= 7.0 上直到0.11.x得到支持
• Laravel >= 5.x.x 在PHP >= 7.1 上直到2.14.x得到支持

为SDK做出贡献

请参阅CONTRIBUTING.md。

获取帮助/支持

如果您需要帮助设置或配置Laravel SDK（或Sentry宇宙中的任何其他内容），请访问Sentry Discord社区。我们的Discord社区中有很多乐于助人的人！

资源

许可证

根据MIT许可证授权，请参阅LICENSE。