references/EXAMPLE-laravel.md · 48000
w to integrate PostHog with a Laravel application.
<form wire:submit="login">
<label for="email">Email</label>
<input
type="email"
id="email"
wire:model="email"
required
>
@error('email') <div class="error">{{ $message }}</div> @enderror
<label for="password">Password</label>
<input
type="password"
id="password"
wire:model="password"
required
>
@error('password') <div class="error">{{ $message }}</div> @enderror
<div style="margin-bottom: 15px;">
<label style="display: inline; font-weight: normal;">
<input type="checkbox" wire:model="remember" style="width: auto; margin-right: 5px;">
Remember me
</label>
</div>
<button type="submit">Login</button>
</form>
<p style="margin-top: 16px;" class="text-sm text-gray">
Don't have an account? <a href="{{ route('register') }}">Sign up here</a>
</p>
<p class="text-sm text-gray">
<strong>Tip:</strong> Default credentials are [email protected]/admin
</p>
</div>
<div class="card">
<h2>Features Demonstrated</h2>
<ul class="text-gray">
<li>User registration and identification</li>
<li>Event tracking</li>
<li>Feature flags</li>
<li>Error tracking</li>
</ul>
</div>
---
## resources/views/livewire/auth/register.blade.php
```php
<div>
<div class="card">
<h1>Create an Account</h1>
<p class="text-gray mb-4">Sign up to explore the PostHog Laravel integration example.</p>
<form wire:submit="register">
<label for="email">Email *</label>
<input
type="email"
id="email"
wire:model="email"
required
>
@error('email') <div class="error">{{ $message }}</div> @enderror
<label for="password">Password *</label>
<input
type="password"
id="password"
wire:model="password"
required
>
@error('password') <div class="error">{{ $message }}</div> @enderror
<label for="password_confirmation">Confirm Password *</label>
<input
type="password"
id="password_confirmation"
wire:model="password_confirmation"
required
>
<button type="submit">Sign Up</button>
</form>
<p style="margin-top: 16px;" class="text-sm text-gray">
Already have an account? <a href="{{ route('login') }}">Login here</a>
</p>
</div>
<div class="card">
<h2>PostHog Integration</h2>
<p class="text-gray">When you sign up, the following PostHog events are captured:</p>
<ul class="text-gray" style="margin-top: 10px;">
<li><code>identify()</code> - Associates your email with the user</li>
<li><code>capture()</code> - Sets person properties (email, etc.)</li>
<li><code>user_signed_up</code> event - Tracks the signup action</li>
</ul>
<h3 style="margin-top: 20px;">Code Example</h3>
<pre>// After creating the user
$posthog->identify($user->email, $user->getPostHogProperties());
$posthog->capture($user->email, 'user_signed_up', [
'signup_method' => 'form'
]);</pre>
</div>
</div>
resources/views/livewire/burrito-tracker.blade.php
<div>
<div class="card">
<h1>Burrito Consideration Tracker</h1>
<p class="text-gray mb-4">This page demonstrates custom event tracking with PostHog.</p>
<div class="count">{{ $burritoCount }}</div>
<p style="text-align: center; color: #666; margin-bottom: 20px;">Times you've considered a burrito</p>
<div style="text-align: center;">
<button
wire:click="considerBurrito"
wire:loading.attr="disabled"
>
<span wire:loading.remove>Consider a Burrito</span>
<span wire:loading>Considering...</span>
</button>
</div>
</div>
<div class="card">
<h3>Code Example</h3>
<pre>// Livewire component method
public function considerBurrito(PostHogService $posthog)
{
$this->burritoCount++;
session(['burrito_count' => $this->burritoCount]);
$user = Auth::user();
$posthog->identify($user->email, $user->getPostHogProperties());
$posthog->capture($user->email, 'burrito_considered', [
'total_considerations' => $this->burritoCount,
]);
}</pre>
</div>
</div>
resources/views/livewire/dashboard.blade.php
<div>
<div class="card">
<h1>Dashboard</h1>
<p class="text-gray">Welcome back, {{ auth()->user()->email }}!</p>
</div>
<div class="card">
<h2>Error Tracking Demo</h2>
<p class="text-gray">Test manual exception capture in PostHog. These buttons trigger errors in the context of your logged-in user.</p>
@if($successMessage)
<div style="background: #d4edda; border: 1px solid #c3e6cb; color: #155724; padding: 12px; border-radius: 4px; margin: 15px 0;">
{{ $successMessage }}
</div>
@endif
@if($errorMessage)
<div style="background: #f8d7da; border: 1px solid #f5c6cb; color: #721c24; padding: 12px; border-radius: 4px; margin: 15px 0;">
{{ $errorMessage }}
</div>
@endif
<div style="display: flex; gap: 10px; margin-top: 15px;">
<button wire:click="testErrorWithCapture" class="btn" style="background: #dc3545; color: white;">
Capture Error in PostHog
</button>
<button wire:click="testErrorWithoutCapture" class="btn" style="background: #c82333; color: white;">
Skip PostHog Capture
</button>
</div>
<h3 style="margin-top: 20px;">Code Example</h3>
<pre>try {
// Critical operation that might fail
processPayment();
} catch (\Throwable $e) {
// Manually capture this specific exception
$errorId = $posthog->captureException($e, $user->email);
return response()->json([
'error' => 'Operation failed',
'error_id' => $errorId
], 500);
}</pre>
<p class="text-gray" style="margin-top: 10px;">This demonstrates manual exception capture where you have control over whether errors are sent to PostHog.</p>
</div>
<div class="card">
<h2>Feature Flags</h2>
@if($showNewFeature)
<div class="feature-flag">
<strong>New Feature Enabled!</strong>
<p style="margin-top: 10px;">You're seeing this because the <code>new-dashboard-feature</code> flag is enabled for you.</p>
@if($featureConfig)
<p style="margin-top: 15px;"><strong>Feature Configuration:</strong></p>
<pre>{{ json_encode($featureConfig, JSON_PRETTY_PRINT) }}</pre>
@endif
</div>
@else
<p class="text-gray">The <code>new-dashboard-feature</code> flag is not enabled for your account.</p>
@endif
<h3 style="margin-top: 20px;">Code Example</h3>
<pre>// Check if feature flag is enabled
$showNewFeature = $posthog->isFeatureEnabled(
'new-dashboard-feature',
$user->email,
$user->getPostHogProperties()
);
// Get feature flag payload
$featureConfig = $posthog->getFeatureFlagPayload(
'new-dashboard-feature',
$user->email
);</pre>
</div>
</div>
resources/views/livewire/profile.blade.php
<div>
<div class="card">
<h1>Your Profile</h1>
<p class="text-gray mb-4">This page demonstrates error tracking with PostHog.</p>
<table>
<tr>
<th>Email</th>
<td>{{ auth()->user()->email }}</td>
</tr>
<tr>
<th>Date Joined</th>
<td>{{ auth()->user()->created_at->format('Y-m-d H:i') }}</td>
</tr>
<tr>
<th>Staff Status</th>
<td>{{ auth()->user()->is_staff ? 'Yes' : 'No' }}</td>
</tr>
</table>
</div>
<div class="card">
<h2>Error Tracking Demo</h2>
<p class="text-gray">Test manual exception capture in PostHog. These buttons trigger errors in the context of your logged-in user.</p>
@if($successMessage)
<div style="background: #d4edda; border: 1px solid #c3e6cb; color: #155724; padding: 12px; border-radius: 4px; margin: 15px 0;">
{{ $successMessage }}
</div>
@endif
@if($errorMessage)
<div style="background: #f8d7da; border: 1px solid #f5c6cb; color: #721c24; padding: 12px; border-radius: 4px; margin: 15px 0;">
{{ $errorMessage }}
</div>
@endif
<div style="display: flex; gap: 10px; margin-top: 15px;">
<button wire:click="testErrorWithCapture" class="btn" style="background: #dc3545; color: white;">
Capture Error in PostHog
</button>
<button wire:click="testErrorWithoutCapture" class="btn" style="background: #c82333; color: white;">
Skip PostHog Capture
</button>
</div>
<p class="text-gray" style="margin-top: 15px;">
This demonstrates manual exception capture where you have control over whether errors are sent to PostHog.
</p>
</div>
<div class="card">
<h3>Code Example</h3>
<pre>try {
throw new \Exception('Test exception from critical operation');
} catch (\Throwable $e) {
// Capture exception with user context
$posthog->identify($user->email, $user->getPostHogProperties());
$eventId = $posthog->captureException($e, $user->email);
return response()->json([
'error' => 'Operation failed',
'error_id' => $eventId,
'message' => "Error captured in PostHog. Reference ID: {$eventId}"
], 500);
}</pre>
</div>
</div>
routes/api.php
<?php
use App\Http\Controllers\Api\BurritoController;
use App\Http\Controllers\Api\ErrorTestController;
use Illuminate\Support\Facades\Route;
Route::middleware('auth:sanctum')->group(function () {
Route::post('/burrito/consider', [BurritoController::class, 'consider']);
Route::post('/test-error', [ErrorTestController::class, 'test']);
});
routes/web.php
<?php
use App\Http\Livewire\Auth\Login;
use App\Http\Livewire\Auth\Register;
use App\Http\Livewire\BurritoTracker;
use App\Http\Livewire\Dashboard;
use App\Http\Livewire\Profile;
use App\Services\PostHogService;
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Facades\Route;
// Guest routes
Route::middleware('guest')->group(function () {
Route::get('/', Login::class)->name('login');
Route::get('/register', Register::class)->name('register');
});
// Authenticated routes
Route::middleware('auth')->group(function () {
Route::get('/dashboard', Dashboard::class)->name('dashboard');
Route::get('/burrito', BurritoTracker::class)->name('burrito');
Route::get('/profile', Profile::class)->name('profile');
Route::post('/logout', function (PostHogService $posthog) {
$user = Auth::user();
// PostHog: Track logout
$posthog->capture($user->email, 'user_logged_out');
Auth::logout();
request()->session()->invalidate();
request()->session()->regenerateToken();
return redirect('/');
})->name('logout');
});