mcpField
I
integration-laravel

integration-laravel

github.com/posthog数据与数据库7695 次安装今天更新
代码仓库

关于 integration-laravel

用于在 Laravel 应用中集成 PostHog 分析的技能，按阶段提供配置指南，并强调专用服务、环境变量配置、显式事件采集及用户和错误跟踪。

主要功能

  1. 01四阶段集成流程
  2. 02Laravel 专属配置指南
  3. 03专用 PostHogService 模式
  4. 04基于环境变量的配置
  5. 05显式事件采集指南
  6. 06用户与错误跟踪建议

适用场景

  1. 01为 Laravel 应用添加 PostHog
  2. 02通过专用服务跟踪操作
  3. 03在登录和注册时识别用户

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/posthog/skills --skill integration-laravel

安装后在 Claude Code 中输入/integration-laravel确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
basic-integration-1.0-begin.md
basic-integration-1.1-edit.md
basic-integration-1.2-revise.md
basic-integration-1.3-conclude.md
EXAMPLE.md
identify-users.md
laravel.md

详细介绍

Laravel 的 PostHog 集成

此技能可帮助你在 Laravel 应用中添加 PostHog 分析。

工作流

请按以下顺序完成集成：

  1. basic-integration-1.0-begin.md - PostHog 设置 - 开始 ← 从这里开始
  2. basic-integration-1.1-edit.md - PostHog 设置 - 编辑
  3. basic-integration-1.2-revise.md - PostHog 设置 - 修订
  4. basic-integration-1.3-conclude.md - PostHog 设置 - 结束

参考文件

  • references/EXAMPLE.md - Laravel 示例项目代码
  • references/laravel.md - Laravel - 文档
  • references/identify-users.md - 用户识别 - 文档
  • references/basic-integration-1.0-begin.md - PostHog 设置 - 开始
  • references/basic-integration-1.1-edit.md - PostHog 设置 - 编辑
  • references/basic-integration-1.2-revise.md - PostHog 设置 - 修订
  • references/basic-integration-1.3-conclude.md - PostHog 设置 - 结束

示例项目展示了目标实现模式。API 详情请参阅文档。

核心原则

  • 环境变量：始终使用环境变量存储 PostHog 密钥。切勿将其硬编码。
  • 尽量少改动：在现有集成旁添加 PostHog 代码。不要替换或重构现有代码。
  • 遵循示例：实现应尽可能遵循示例项目中的模式。

框架指南

  • 在 app/Services/ 中创建专用的 PostHogService 类——不要在各个控制器中零散调用 PostHog::capture
  • 在 config/posthog.php 中注册 PostHog 配置，并对所有设置（api_key、host、disabled）使用 env()
  • 不要使用 Laravel 的事件系统或观察者进行分析——在操作发生的位置显式调用 capture
  • 请记住，运行 composer install 后，源代码会出现在 vendor 目录中
  • posthog/posthog-php 是 PHP SDK 的软件包名称
  • 添加新文件前，检查 composer.json 中现有的依赖项和自动加载配置
  • PHP SDK 使用静态方法（PostHog::capture、PostHog::identify）——使用 PostHog::init() 初始化一次
  • PHP SDK 方法接受包含 'distinctId'、'event'、'properties' 键的关联数组，而不是位置参数

识别用户

在登录和注册事件期间识别用户。有关此框架中正确的识别模式，请参阅示例代码和文档。如果同时存在前端和后端代码，请通过 X-POSTHOG-DISTINCT-ID 和 X-POSTHOG-SESSION-ID 标头传递客户端会话 ID 和 distinct ID，以保持关联。

错误追踪

在相关文件中添加 PostHog 错误追踪，尤其是在关键用户流程和 API 边界附近。

评论

支持 Markdown