--- title: PHP SDK url: https://platform.claude.com/docs/ru/cli-sdks-libraries/sdks/php description: Установка и настройка Anthropic PHP SDK с объектами-значениями и паттернами построителя --- Библиотека Anthropic PHP обеспечивает удобный доступ к Claude API из любого приложения на PHP 8.1.0+. PHP SDK в настоящее время находится в бета-версии. API могут изменяться между версиями. Документацию по функциям API с примерами кода см. в [справочнике API](https://platform.claude.com/docs/ru/api/overview). На этой странице рассматриваются специфичные для PHP функции SDK и его настройка. ## Установка SDK использует [PSR-18](https://www.php-fig.org/psr/psr-18/) для HTTP и автоматически обнаруживает любой установленный клиент PSR-18. Рекомендуется [Guzzle](https://docs.guzzlephp.org/), поскольку SDK настраивает его для «streaming» (потоковой передачи) без дополнительной конфигурации: ```bash composer require "anthropic-ai/sdk" "guzzlehttp/guzzle:^7" ``` ## Требования PHP 8.1.0 или выше. ## Использование Эта библиотека использует именованные параметры для указания необязательных аргументов. Параметры со значением по умолчанию должны задаваться по имени. ```php $client = new Client(); $message = $client->messages->create( maxTokens: 1024, messages: [['role' => 'user', 'content' => 'Hello, Claude']], model: 'claude-opus-5-5', ); $textBlock = array_find($message->content, static fn ($block): bool => $block->type === 'text'); echo $textBlock->text; ``` Варианты аутентификации, включая Workload Identity Federation, описаны в разделе [Аутентификация](https://platform.claude.com/docs/ru/manage-claude/authentication). Если ваш ключ API является [персональным ключом или ключом сервисного аккаунта](https://platform.claude.com/docs/ru/manage-claude/authentication#key-types) с доступом к нескольким рабочим пространствам, укажите идентификатор рабочего пространства в заголовке запроса `anthropic-workspace-id`; в разделе [Выбор рабочего пространства](https://platform.claude.com/docs/ru/manage-claude/authentication#select-a-workspace) показан вариант настройки для отдельного запроса в этом SDK. ## Объекты-значения Для инициализации «value objects» (объектов-значений) рекомендуется использовать статический конструктор `with` — `Base64ImageSource::with(data: "U3RhaW5sZXNzIHJvY2tz", ...)` — и именованные параметры. Однако также предоставляются построители: `(new Base64ImageSource)->withData("U3RhaW5sZXNzIHJvY2tz")`. ## Потоковая передача SDK поддерживает потоковую передачу ответов с использованием «Server-Sent Events» (событий, отправляемых сервером), или SSE. ```php $client = new Client(); $stream = $client->messages->createStream( maxTokens: 1024, messages: [['role' => 'user', 'content' => 'Hello, Claude']], model: 'claude-opus-5-5', ); foreach ($stream as $event) { echo $event->type . PHP_EOL; } ``` Для потоковой передачи требуется HTTP-клиент, который возвращает тело ответа по частям. Когда обнаруженным клиентом PSR-18 является Guzzle, SDK автоматически настраивает его для потоковой передачи. При использовании буферизующего клиента цикл `foreach` выдаёт все события сразу после завершения ответа, а не постепенно; если вы наблюдаете такой симптом, установите Guzzle или передайте клиент PSR-18 с поддержкой потоковой передачи через параметр запроса `streamingTransporter`: ```php $client = new \Anthropic\Client( requestOptions: \Anthropic\RequestOptions::with(streamingTransporter: $myStreamingClient), ); ``` ## Обработка ошибок Когда библиотеке не удаётся подключиться к API или если API возвращает код состояния, отличный от успешного (то есть ответ 4xx или 5xx), выбрасывается подкласс `Anthropic\Core\Exceptions\APIException`: ```php messages->create( maxTokens: 1024, messages: [['role' => 'user', 'content' => 'Hello, Claude']], model: 'claude-opus-5-5', ); } catch (APIConnectionException $e) { echo "The server could not be reached", PHP_EOL; echo $e->getPrevious()?->getMessage(), PHP_EOL; } catch (RateLimitException $_) { echo "A 429 status code was received; we should back off a bit.", PHP_EOL; } catch (APIStatusException $e) { echo "Another non-200-range status code was received", PHP_EOL; echo $e->getMessage(); } ``` Коды ошибок следующие: | Причина | Тип ошибки | | ------------------ | ------------------------------ | | HTTP 400 | `BadRequestException` | | HTTP 401 | `AuthenticationException` | | HTTP 403 | `PermissionDeniedException` | | HTTP 404 | `NotFoundException` | | HTTP 409 | `ConflictException` | | HTTP 422 | `UnprocessableEntityException` | | HTTP 429 | `RateLimitException` | | HTTP >= 500 | `InternalServerException` | | Другая ошибка HTTP | `APIStatusException` | | Тайм-аут | `APITimeoutException` | | Сетевая ошибка | `APIConnectionException` | ## Повторные попытки Некоторые ошибки по умолчанию автоматически повторяются два раза с короткой экспоненциальной задержкой. Ошибки соединения (например, из-за проблем с сетевым подключением), 408 Request Timeout, 409 Conflict, 429 Rate Limit («ограничение скорости»), внутренние ошибки >=500 и тайм-ауты по умолчанию повторяются. Вы можете использовать параметр `maxRetries`, чтобы настроить или отключить это поведение: ```php use Anthropic\RequestOptions; // ... // Настройте значение по умолчанию для всех запросов: $client = new Client(requestOptions: RequestOptions::with(maxRetries: 0)); // Или настройте для отдельного запроса: $result = $client->messages->create( maxTokens: 1024, messages: [['role' => 'user', 'content' => 'Hello, Claude']], model: 'claude-opus-5-5', requestOptions: RequestOptions::with(maxRetries: 5), ); ``` ## Пагинация Методы списков в Claude API поддерживают пагинацию. Эта библиотека предоставляет итераторы с автоматической пагинацией для каждого ответа со списком, поэтому вам не нужно вручную запрашивать последующие страницы: ```php $client = new Client(); $page = $client->beta->messages->batches->list(limit: 20); // получить элементы с текущей страницы foreach ($page->getItems() as $item) { echo $item->id, PHP_EOL; } // выполнить дополнительные сетевые запросы для получения элементов со всех страниц, включая текущую и последующие // ... foreach ($page->pagingEachItem() as $item) { echo $item->id, PHP_EOL; // ... } ``` ## Расширенное использование ### Недокументированные свойства Вы можете отправлять недокументированные параметры на любую конечную точку и читать недокументированные свойства ответа следующим образом: Параметры `extra*` с тем же именем переопределяют документированные параметры. ```php messages->create( maxTokens: 1024, messages: [['role' => 'user', 'content' => 'Hello, Claude']], model: 'claude-opus-5-5', requestOptions: RequestOptions::with( extraQueryParams: ['my_query_parameter' => 'value'], extraBodyParams: ['my_body_parameter' => 'value'], extraHeaders: ['my-header' => 'value'], ), ); ``` ### Недокументированные параметры запроса Если вы хотите явно отправить дополнительный параметр, вы можете сделать это с помощью параметров `extraQueryParams`, `extraBodyParams` и `extraHeaders` в `RequestOptions::with()` при выполнении запроса, как показано в предыдущем примере. ### Недокументированные конечные точки Чтобы выполнять запросы к недокументированным конечным точкам, сохраняя преимущества аутентификации, повторных попыток и других функций клиента, вы можете выполнять запросы с помощью `client->request` следующим образом: ```php $client = new Client(); $response = $client->request( method: "post", path: '/undocumented/endpoint', query: ['dog' => 'woof'], headers: ['useful-header' => 'interesting-value'], body: ['hello' => 'world'] ); ``` ## Интеграции с платформами Подробные руководства по настройке платформ с примерами кода см. здесь: * [Amazon Bedrock](https://platform.claude.com/docs/ru/build-with-claude/claude-in-amazon-bedrock) * [Amazon Bedrock (Opus 4.6 и более ранние)](https://platform.claude.com/docs/ru/build-with-claude/claude-on-amazon-bedrock-legacy) * [Claude Platform на AWS](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws) * [Google Cloud](https://platform.claude.com/docs/ru/build-with-claude/claude-on-vertex-ai) * [Microsoft Foundry](https://platform.claude.com/docs/ru/build-with-claude/claude-in-microsoft-foundry) PHP SDK поддерживает следующие платформы: * **Agent Platform:** `Anthropic\Vertex\Client`. Используйте `::fromEnvironment()`. * **Bedrock:** `Anthropic\Bedrock\MantleClient`. Используйте `new MantleClient(awsRegion: ...)`. * **Bedrock (устаревший):** `Anthropic\Bedrock\Client`. Используйте `::fromEnvironment()` или `::withCredentials()`. * **Claude Platform на AWS:** `Anthropic\Aws\Client` (требует `aws/aws-sdk-php` в качестве мягкой зависимости). Используйте `new Anthropic\Aws\Client(workspaceId: ...)` или задайте `ANTHROPIC_AWS_WORKSPACE_ID`. Доступно в бета-версии. * **Foundry:** `Anthropic\Foundry\Client`. Используйте `::withCredentials()`. Используйте `MantleClient` для новых проектов; `Anthropic\Bedrock\Client` остаётся для существующих приложений, использующих API Bedrock `InvokeModel`. ## Семантическое версионирование Этот пакет следует соглашениям [SemVer](https://semver.org/spec/v2.0.0.html). Поскольку библиотека находится на начальной стадии разработки и имеет мажорную версию `0`, API могут измениться в любое время. Этот пакет считает улучшения определений типов PHPDoc (не влияющих на выполнение) изменениями, не нарушающими обратную совместимость. ## Дополнительные ресурсы * [Репозиторий GitHub](https://github.com/anthropics/anthropic-sdk-php) * [Packagist](https://packagist.org/packages/anthropic-ai/sdk) * [Справочник API](https://platform.claude.com/docs/ru/api/overview) * [Потоковая передача сообщений](https://platform.claude.com/docs/ru/build-with-claude/streaming)