Intégration PostHog pour Laravel

Cette skill vous aide à ajouter PostHog analytics à vos applications Laravel.

Workflow

Suivez ces étapes dans l'ordre pour compléter l'intégration :

1. basic-integration-1.0-begin.md - Configuration PostHog - Début ← Commencez ici
2. basic-integration-1.1-edit.md - Configuration PostHog - Modification
3. basic-integration-1.2-revise.md - Configuration PostHog - Révision
4. basic-integration-1.3-conclude.md - Configuration PostHog - Conclusion

Fichiers de référence

• references/EXAMPLE.md - Exemple de code de projet Laravel
• references/laravel.md - Laravel - docs
• references/identify-users.md - Identifier les utilisateurs - docs
• references/basic-integration-1.0-begin.md - Configuration PostHog - début
• references/basic-integration-1.1-edit.md - Configuration PostHog - modification
• references/basic-integration-1.2-revise.md - Configuration PostHog - révision
• references/basic-integration-1.3-conclude.md - Configuration PostHog - conclusion

Le projet exemple montre le pattern d'implémentation cible. Consultez la documentation pour les détails de l'API.

Principes clés

• Variables d'environnement : Toujours utiliser des variables d'environnement pour les clés PostHog. Ne jamais les hardcoder.
• Modifications minimales : Ajouter le code PostHog aux côtés des intégrations existantes. Ne pas remplacer ni restructurer le code existant.
• Correspondre à l'exemple : Votre implémentation doit suivre les patterns du projet exemple aussi fidèlement que possible.

Directives du framework

• Créer une classe PostHogService dédiée dans app/Services/ - NE PAS disperser les appels PostHog::capture dans les controllers
• Enregistrer la configuration PostHog dans config/posthog.php en utilisant env() pour tous les paramètres (api_key, host, disabled)
• NE PAS utiliser le système d'événements ou les observers Laravel pour l'analytics - appeler capture explicitement où les actions se produisent
• Souvenir que le code source est disponible dans le répertoire vendor après composer install
• posthog/posthog-php est le nom du package SDK PHP
• Vérifier composer.json pour les dépendances existantes et la configuration autoload avant d'ajouter de nouveaux fichiers
• Le SDK PHP utilise des méthodes statiques (PostHog::capture, PostHog::identify) - initialiser une fois avec PostHog::init()
• Les méthodes du SDK PHP prennent des tableaux associatifs avec les clés 'distinctId', 'event', 'properties' - pas d'arguments positionnels

Identifier les utilisateurs

Identifier les utilisateurs lors des événements de login et signup. Consultez le code exemple et la documentation pour le pattern identify correct pour ce framework. Si du code frontend et backend existe, passer la session côté client et l'ID distinct en utilisant les headers X-POSTHOG-DISTINCT-ID et X-POSTHOG-SESSION-ID pour maintenir la corrélation.

Suivi des erreurs

Ajouter le suivi des erreurs PostHog aux fichiers pertinents, particulièrement autour des flux utilisateur critiques et des limites d'API.