getsentry/sentry-php-sdk

sentry-php-sdk 是做什么的？

为PHP应用程序提供完整的Sentry SDK配置。当用户要求“为PHP添加Sentry”、“安装sentry/sentry”、“在PHP中设置Sentry”，或配置错误监控、追踪、性能分析、日志记录、指标或定时任务（Crons）时，使用此技能。支持纯PHP、Laravel和Symfony框架。

使用方法

1. 确定项目类型：检查 composer.json 以确定项目是纯PHP、Laravel还是Symfony。
2. 安装SDK：

   composer require sentry/sentry
   

3. 获取DSN：如果尚未配置，引导用户从Sentry项目设置中获取DSN。
4. 配置Sentry：
   • 纯PHP：在 index.php 或引导文件中初始化：

     \Sentry\init(['dsn' => '__DSN__']);
     

   • Laravel：发布配置文件：

     php artisan vendor:publish --provider="Sentry\Laravel\ServiceProvider"
     

     然后在 .env 中设置 SENTRY_DSN。
   • Symfony：在 .env 中设置 SENTRY_DSN，或手动配置 config/packages/sentry.yaml。

高级功能

• 性能追踪：启用 traces_sample_rate（例如：1.0 表示100%的请求被追踪）。
• Profiling：与追踪结合使用，设置 profiles_sample_rate。
• 日志记录：使用Monolog Handler将日志路由到Sentry（例如：Laravel的 sentry 日志通道）。
• Crons：使用Sentry的Crons接口监控定时任务执行。
• 指标：通过Sentry的Metrics API发送自定义业务指标。

框架说明

• 纯PHP：手动初始化SDK。
• Laravel：提供自动错误处理和队列/作业监控。
• Symfony：通过Monolog集成，自动绑定异常和日志。

回退

如果项目类型不在上述范围内，提供最接近的通用配置指导，并建议参考 Sentry PHP 官方文档。