README

This package provides a wrapper around the langfuse-php package, allowing you to easily integrate Langfuse into your Laravel applications. It uses as few dependencies as possible.

This package supports the following features:

Prompts

• Get text prompts
• Get chat prompts
• Compile text prompts
• Compile chat prompts
• Create text prompts
• Create chat prompts
• Fallback handling for prompt fetching errors
• Fallback handling when no prompt is found

Ingestion

• Create traces
• Create generations

Requires PHP 8.3 or PHP 8.4 in combination with Laravel 11 or Laravel 12

⚡️ Install the package using Composer:

composer require dij-digital/langfuse-laravel  

How to use this package

Prompt

Add the following env keys to your projects .env file:

LANGFUSE_BASE_URI=https://cloud.langfuse.com
LANGFUSE_PUBLIC_KEY=
LANGFUSE_SECRET_KEY=

use DIJ\Langfuse\Laravel\Facades\Langfuse;

Langfuse::prompt()->text('promptName', 'fallback')->compile(['key' => 'value']);
Langfuse::prompt()->text('promptName', 'fallback')->compile(['key' => 'value']);
Langfuse::prompt()->chat('chatName', ['role' => 'user', 'content' => 'fallback'])->compile(['key' => 'value']);
Langfuse::prompt()->list();
Langfuse::prompt()->create('promptName', 'text', PromptType::TEXT);

Ingestion

use DIJ\Langfuse\Laravel\Facades\Langfuse;

// Creates a trace and a generation visible in Langfuse UI
$traceId = 'trace-id-123';

Langfuse::ingestion()->trace(
    input: 'prompt text',
    output: null,
    traceId: $traceId,
    name: 'name',
    sessionId: null,
    metadata: ['key' => 'value']
);

Langfuse::ingestion()->generation(
    input: 'prompt text',
    output: 'model output',
    traceId: $traceId,
    name: 'name',
    sessionId: null,
    promptName: 'promptName',
    promptVersion: 1,
    model: 'gpt-4o',
    modelParameters: ['temperature' => 0.7],
    metadata: ['key' => 'value']
);

Langfuse Laravel was created by Tycho Engberink and is maintained by DIJ Digital under the MIT license.