这个项目能做什么

Laravel Plausible 是一个将 Plausible Analytics 集成到 Laravel 应用中的包。它提供了一个简单的 Facade 来与 Plausible Stats API 交互,允许开发者获取实时访客数、聚合指标、时间序列数据以及按各种属性分组的数据。通过运行 `composer require njoguamos/laravel-plausible` 安装,然后执行 `php artisan plausible:install` 发布配置文件。安装后,用户需在 .env 文件中添加 Plausible site ID 和 API key,自托管实例可设置 PLAUSIBLE_BASE_URL。包提供的方法包括:Plausible::realtime() 返回当前访客数;Plausible::aggregates() 获取汇总指标,支持 period、metrics、comparison、filters、date range 和 imported data 等可选参数;Plausible::timeSeries() 返回随时间变化的数据点,支持配置间隔;Plausible::breakdown() 提供按页面、浏览器或国家等属性的分组统计,支持 limits、分页和过滤。默认缓存 3 分钟以减少 API 调用,可通过 PLAUSIBLE_CACHE_DURATION 和 PLAUSIBLE_CACHE_DRIVER 环境变量调整缓存时长与驱动,或通过 PLAUSIBLE_CACHE=false 完全禁用缓存。包包含可通过 `composer test` 运行的测试套件,遵循标准 Laravel 贡献规范。