用途:为 PHP 项目接入 Sentry,覆盖错误监控、追踪、性能分析、日志、指标、Crons 与 AI 监控。适用于纯 PHP、Laravel、Symfony 应用,以及队列、计划任务和 AI 库场景。
主要能力:先扫描 composer.json、框架标记文件、队列与 AI 库,判断项目类型;再按需推荐功能组合,并逐项引导配置与验证。错误监控与日志为基线,检测到 Web 框架时推荐追踪,生产环境可启用性能分析,检测到调度模式可配置 Crons,检测到 laravel/ai 可启用 AI 监控。
使用方式:安装命令为 composer require sentry/sentry "^4.0"(纯 PHP)、composer require sentry/sentry-laravel "^4.0"(Laravel)、composer require sentry/sentry-symfony "^5.0"(Symfony)。纯 PHP 在入口文件顶部调用 \Sentry\init();Laravel 在 bootstrap/app.php 注册 Integration::handles($exceptions),再执行 php artisan sentry:publish --dsn=YOUR_DSN;Symfony 注册 SentryBundle 并创建 config/packages/sentry.yaml。验证可用 throw new \Exception('Sentry PHP SDK test')、\Sentry\captureMessage() 或 php artisan sentry:test。
限制:需 PHP 7.2+ 及 ext-json、ext-mbstring、ext-curl;性能分析需 excimer 扩展,仅 Linux/macOS;enable_logs 需 sentry/sentry >=4.12.0 等版本;队列错误需在工作进程内初始化;SDK 版本与 API 以官方文档为准。