প্রকল্প সম্পর্কে

Genlytics 是一个适用于 Laravel 的 Composer 包，可将 Google Analytics 4 (GA4) 集成到 PHP 应用程序中。它在 GA4 Data API 上提供仓库模式抽象，并支持自动缓存、队列后台任务和实时报告辅助工具。该包支持 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 调用，而后台任务将繁重查询从请求线程中分离。库附带小型测试套件，示例控制器展示仪表板小部件、实时访客计数和国家排名分解。文档页面涵盖安装步骤、配置选项、从早期版本迁移及故障排除。