genlytics

Genlytics 是一个适用于 Laravel 的 Composer 包，可将 Google Analytics 4（GA4）集成到 PHP 应用中。它在 GA4 数据 API 上提供仓储模式抽象，并支持自动缓存、队列后台任务和实时报告辅助工具。该包支持 Laravel 9.x 至 12.x，要求 PHP 8.1+。使用前需配置 GA4 属性及具备 Analytics Data API 访问权限的 Google Cloud 服务账户。 安装命令为 `composer require zfhassaan/genlytics`。包会自动注册服务提供者和门面；开发者可通过 Artisan 命令发布配置文件和测试桩。环境变量控制缓存有效期、后台队列行为和实时更新间隔。核心用法包括构建日期范围、维度数组和指标数组，再传入 `Genlytics` 类或门面提供的 `runReports()`、`runRealTime()` 或 `runDimensionReport()` 方法。 README 强调了依赖倒置、接口隔离和数据获取周期中的事件监听器等架构设计。缓存响应减少重复 API 调用，后台任务将繁重查询从请求线程中分离。库附带小型测试套件，示例控制器展示仪表盘小部件、实时访客计数和国家排名分析。文档涵盖安装步骤、配置选项、版本迁移指南和故障排查。