这个项目能做什么

Laravel Umami 为在 Laravel 应用程序中添加 Umami 分析提供了一种简单的方法。该扩展包依赖于 spatie/laravel-settings 将所有 Umami 配置值保存在数据库中，从而无需修改代码即可轻松更改设置。 核心特性： - 简单的 Blade 引入：在布局中添加 @include('umami::script') 即可加载跟踪脚本。 - 数据库驱动的设置：website ID、主机 URL、域名白名单、自动跟踪标志等选项存储在设置表中，可通过代码或管理界面进行编辑。 - 开箱即用的页面浏览量和事件自动跟踪，并提供排除查询字符串或哈希片段的选项。 - 支持自定义标签和域名限制，以实现更精确的分析。 安装步骤： 1. 使用 Composer 安装该扩展包。 2. 确保已安装 spatie/laravel-settings 并运行了其迁移。 3. 发布并运行扩展包提供的 Umami 设置迁移。 4. 在 Blade 布局中添加脚本引入。 配置示例 (PHP)： ``` use JeffersonGoncalves\Umami\Settings\UmamiSettings; $settings = app(UmamiSettings::class); $settings->website_id = 'your-website-id'; $settings->host_analytics = 'https://your-umami-instance.com'; $settings->save(); ``` 可用设置包括： - website_id (必填) - host_analytics (默认 https://cloud.umami.is) - host_url (可选覆盖) - auto_track (布尔值，默认 true) - domains (逗号分隔的列表) - tag (可选的分组标签) - exclude_search 和 exclude_hash (用于去除 URL 部分的布尔值) 该扩展包兼容 PHP 8.2+ 和 Laravel 11+。可以通过 `composer test` 运行测试。它在 MIT 许可下发布。 欲了解更多详情，请参阅仓库的 README、变更日志和贡献指南。