منصوبے کے بارے میں

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 命令发布配置和测试存根。环境变量控制缓存生命周期、后台队列行为和实时更新间隔。核心使用方式是构建日期范围、维度数组和指标数组，然后传递给 `runReports()`、`runRealTime()` 或 `runDimensionReport()` 方法，这些方法可通过 `Genlytics、队列后台任务和实时报告辅助功能。该包支持 Laravel 9.x 至 12.x，要求 PHP 8.1+。前提条件包括一个 GA4 属性和具有 Analytics Data API 访问权限的 Google Cloud 服务账户。 安装命令为 `composer require zfhassaan/genlytics`。包会自动注册其服务提供者和门面；开发者可通过 Artisan 命令发布配置和测试存根。环境变量控制缓存生命周期、后台队列行为和实时更新间隔。核心使用方式是构建日期范围、维度数组和指标数组，然后传递给 `runReports()`、`runRealTime()` 或 `runDimensionReport()` 方法，这些方法可通过 `Genlytics` 类或门面调用。 README 强调了依赖倒置、接口隔离和数据抓取周期的事件监听器等架构选择。缓存响应减少重复 API 调用，后台任务将繁重查询从请求线程中分离。库附带小型测试套件，示例控制器展示仪表板小部件、实时访客计数和国家排名分解。文档页面涵盖安装步骤、配置选项、版本迁移和故障排除。