​

Key Features

• Type Safety: Full PHP 8.3+ type system support with strict typing
• Multiple LLM Support: Works with OpenAI, Anthropic, Gemini, Cohere, and more
• Validation: Built-in validation with custom rules and LLM-powered validation
• Streaming: Real-time partial object updates for better UX
• Function Calling: Native support for LLM function/tool calling
• Zero Dependencies: Clean, lightweight implementation

​

Quick Example

<?php
use Cognesy\Instructor\StructuredOutput;

class Person {
    public string $name;
    public int $age;
    public string $occupation;
}

$text = "Extract: Jason is 25 years old and works as a software engineer.";

$person = (new StructuredOutput)
    ->withResponseClass(Person::class)
    ->withMessages($text)
    ->get();

echo $person->name; // "Jason"
echo $person->age;  // 25
echo $person->occupation; // "software engineer"

​

Getting Started

• Quick Start - Get up and running in 5 minutes
• Setup Guide - Detailed installation and configuration
• Cookbook - Practical examples and recipes

​

Architecture

• Instructor - Main structured output library
• Polyglot - Low-level LLM abstraction layer
• HTTP Client - Flexible HTTP client for API calls
• HTTP Pool - Concurrent request execution for fan-out workloads

​

Community

• GitHub: cognesy/instructor-php
• Issues: Report bugs or request features
• Discussions: Join the conversation