integration-laravel

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 の呼び出しを散在させないでください。
• すべての設定（api_key、host、disabled）に env() を使用し、config/posthog.php に PostHog の設定を登録してください。
• アナリティクスに 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 キーを含む連想配列を渡してください。

ユーザーの識別

ログインイベントとサインアップイベントの際にユーザーを識別してください。このフレームワークで正しく識別する方法については、サンプルコードとドキュメントを参照してください。フロントエンドとバックエンドの両方のコードがある場合は、相関を維持するため、クライアント側のセッション ID と distinct ID を X-POSTHOG-DISTINCT-ID ヘッダーおよび X-POSTHOG-SESSION-ID ヘッダーで渡してください。

エラートラッキング

関連するファイルに PostHog のエラートラッキングを追加してください。特に、重要なユーザーフローや API 境界の周辺に追加してください。