Pan:轻量级且注重隐私的PHP产品分析库
1. 项目介绍
Pan 是一个轻量级且注重隐私的 PHP 产品分析库。它的设计非常简单,可以通过 composer require
安装,并使用 data-pan
属性开始跟踪你的页面或组件。Pan 目前跟踪的事件包括展示次数、悬停和点击,并且不会收集任何个人识别信息,如 IP 地址、用户代理等。
Pan 与 Laravel 堆栈完美配合,无论你是使用 React、Inertia 还是 Livewire,Pan 都能无缝工作。通过终端命令,你可以轻松地可视化你的分析数据,以帮助你改进应用。
2. 项目快速启动
首先,确保你的环境满足以下要求:
- PHP 8.3+
- Laravel 11.0+
接下来,通过 Composer 将 Pan 安装到你的 PHP 项目中:
composer require panphp/pan
然后,在 Laravel 项目中安装 Pan:
php artisan install:pan
最后,在你的 HTML 元素上添加 data-pan
属性来开始跟踪页面或组件:
<div>
<button>Tab 1</button>
<button data-pan="tab-1">Tab 1</button>
<button>Tab 2</button>
<button data-pan="tab-2">Tab 2</button>
</div>
请注意,事件名称只能包含字母、数字、短横线和下划线。
3. 应用案例和最佳实践
以下是一些使用 Pan 的场景:
- 如果你页面中有多个标签页,且同一 URL 下你想要知道哪个标签页查看次数最多,可以在标签页上添加
data-pan
属性来跟踪。 - 如果你的应用中有多个注册按钮,你想要知道哪个按钮点击次数最多,可以在按钮上添加
data-pan
属性来跟踪。 - 如果你的应用中有多个帮助弹出悬停,你想要知道哪个悬停次数最多,可以在弹出悬停上添加
data-pan
属性来跟踪。
要可视化你的产品分析,可以使用以下 Artisan 命令:
php artisan pan
或者,如果你想过滤特定的分析数据:
php artisan pan --filter=tab-profile
4. 典型生态项目
Pan 是一个开源项目,你可以通过 GitHub 上的一些指标来了解其生态:
- 星标数:1.2k
- 观察者数:7
- 分支数:58
Pan 的代码主要使用 PHP(79.2%)、TypeScript(10.7%)、JavaScript(9.6%)和 Blade(0.5%)编写。Pan 作为一个开源项目,鼓励社区参与和贡献,以共同推动项目的发展。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考