Claude-PHP-SDK copilot-instructions.md

Copilot Instructions for Claude PHP SDK

This is a PHP clone of the Anthropic Python SDK (https://github.com/anthropics/anthropic-sdk-python), designed as a universal, framework-agnostic PHP SDK following PSR standards for easy integration with Laravel, Symfony, Slim, and other frameworks.

Project Goals

• API Parity: Full implementation of latest Claude API endpoints (Messages, Files, Batches, Models APIs)
• PSR Compliance: Follow PHP Standards Recommendations (PSR-12 coding style, PSR-11 containers for DI)
• Dependency Injection Ready: Support framework-agnostic DI patterns for seamless integration
• Latest Models & Features: Support Claude Sonnet 4.5, Haiku 4.5, Opus 4.1, plus extended thinking, streaming, tool use, vision, embeddings
• Async & Sync Support: Both synchronous and asynchronous clients via Amphp/PHP async patterns
• Python SDK Parity: Mirror error handling, configuration, and patterns from the official Python SDK

Architecture & Core Components

Directory Structure (to be created)

Claude-PHP-SDK/
├── src/
│   ├── Anthropic.php           # Main client class (factory/entry point)
│   ├── Client/                 # Core HTTP client implementation
│   ├── Messages/               # Messages API (main resource)
│   ├── Files/                  # Files API resource
│   ├── Batches/                # Batch processing API
│   ├── Models/                 # Models API
│   ├── Embeddings/             # Embeddings API
│   ├── Resources/              # Base resource classes
│   ├── Requests/               # Request builders/DTOs
│   ├── Responses/              # Response objects & streaming
│   └── Contracts/              # Interfaces for DI
├── tests/
├── composer.json
└── README.md

Key Architectural Patterns

1. Client Pattern: Anthropic class acts as main entry point, returns resource instances

   $client = new Anthropic(apiKey: $key);
   $response = $client->messages->create([...]);