nbeyond/raygun-exception-listener

此包使用 Raygun4PHP 包。它使得过滤发送到 Raygun 的数据变得更容易,使您的应用程序符合 GDPR 规定。

V1.0.2 2022-01-24 10:09 UTC

This package is not auto-updated.

Last update: 2024-09-16 23:15:51 UTC


README

此包允许您向依赖的 Raygun 包(此包)添加过滤器。通过使用此包,您可以过滤发送到 Raygun 的数据以符合 GDPR 法规。您还可以添加/覆盖过滤器以更好地满足您的应用程序需求。

## 安装 Raygun 数据过滤器依赖 Raygun4PHP,为了使用 Raygun 数据过滤器,请确保 Raygun4PHP 包正常工作。

使用 Composer

Composer 是 PHP 的包管理工具,可以自动获取依赖项,并支持自动加载 - 这是一种低影响的方式将 Raygun4PHP 添加到您的站点。

1. 如果您使用 *nix 环境,请按照安装 Composer 的说明进行操作。Windows 用户可以运行此安装程序以自动将其添加到 Path。

2. 在项目根目录中运行以下控制台命令

php composer.phar require tripledotzero/raygun-exception-listener

3. 在您的 shell 中运行 php composer.phar install (*nix) 或 composer install (Windows)。这将下载 Raygun4PHP 并创建适当的自动加载数据。

## 使用您可以将 PHP 错误和面向对象的异常自动发送到 Raygun。RaygunClient 需要一个 HTTP 传输(例如 Guzzle 或其他 PSR-7 兼容接口)。

目前,有 2 个基于 Guzzle 的传输类。异步和同步。您可以选择使用 GuzzleSync 或 GuzzleAsync,通过设置 setUseAsynctrue 来选择。

### 示例代码

<?php

namespace App\EventListener;

use RaygunFilterParams\Config;
use RaygunFilterParams\DataFilter;
use Symfony\Component\HttpKernel\Event\ExceptionEvent;

class ExceptionListener
{
    public function onKernelException(ExceptionEvent $event)
    {
        $config = new Config($_ENV['RAYGUN_BASE_URI'], $_ENV['RAYGUN_API_KEY']);
        $config->setUserTracking(true);
        $dataFilter = new DataFilter($config);
        $dataFilter->sendToRaygun($event->getThrowable());
    }
}

如您所见,为了将数据发送到 Raygun,您首先需要使用 BASE_URI 和 API_KEY 创建配置对象。默认情况下,DisableUserTracking 是关闭的,要打开它使用

$config->setUserTracking(true);

代理的情况相同

$config->setProxy('proxy:8080');

更多信息请参阅 Raygun4PHP 的 文档Raygun 网站