PHP怎么让Claude输出固定JSON？Schema定义、解析与失败处理-php教程-PHP中文网

需要把claude的回答接入表单、数据库或后续程序时，可以使用结构化输出指定字段与类型。php sdk支持通过jsonoutputformat和outputconfig提交json schema。下面以fable 5.2生成文章标题和标签为例，区别于仅在提示词中要求“返回json”。

定义必填字段和额外字段规则

先安装anthropic-ai/sdk及兼容HTTP客户端，并准备API密钥。Schema中的required控制必填项，additionalProperties设为false，用于约束未声明字段。

官方PHP JSON Schema示例，示例模型以截图为准

<?php require __DIR__ . '/vendor/autoload.php';
use Anthropic\Client;
use Anthropic\Messages\JSONOutputFormat;
use Anthropic\Messages\OutputConfig;
$key = getenv('ANTHROPIC_API_KEY');
if (!$key) { throw new RuntimeException('请先设置ANTHROPIC_API_KEY'); }
$schema = [
    'type' => 'object',
    'properties' => [
        'title' => ['type' => 'string'],
        'tags' => ['type' => 'array', 'items' => ['type' => 'string']],
    ],
    'required' => ['title', 'tags'],
    'additionalProperties' => false,
];
$message = (new Client(apiKey: $key))->messages->create(
    maxTokens: 4096,
    model: 'claude-fable-5-2',
    messages: [['role' => 'user', 'content' => '为一篇PHP数组入门文章拟标题，并给出两个标签。']],
    outputConfig: OutputConfig::with(format: JSONOutputFormat::with(schema: $schema)),
);
$text = '';
foreach ($message->content as $block) {
    if ($block->type === 'text') { $text .= $block->text; }
}
if ($text === '') { throw new RuntimeException('未取得文本，请先检查停止原因'); }
$data = json_decode($text, true, 512, JSON_THROW_ON_ERROR);
var_dump($data);