nbeyond / raygun-exception-listener
此包使用 Raygun4PHP 包。它使得过滤发送到 Raygun 的数据变得更容易,使您的应用程序符合 GDPR 规定。
Requires
- php: ^7.3|^8.0
- mindscape/raygun4php: ^2.0
Requires (Dev)
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,通过设置 setUseAsync
为 true
来选择。
### 示例代码
<?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');