API Platform：自定义POST操作的HTTP状态码

<?php

namespace App\ApiResource;

use ApiPlatform\Metadata\ApiResource;
use ApiPlatform\Metadata\Post;
use Symfony\Component\Validator\Constraints as Assert;

#[ApiResource(
    // 定义集合操作
    collectionOperations: [
        'post' => [
            'path' => '/grimoire', // 定义POST请求的URI路径
            'status' => 200,      // 将POST操作的HTTP状态码设置为200 OK
            'method' => 'POST',   // 明确指定这是一个POST方法
            'openapi_context' => [
                'summary' => '处理魔法咒语并返回结果',
                'description' => '此端点用于接收魔法咒语输入，执行特定逻辑，并返回处理结果，不创建持久化资源。',
                'responses' => [
                    '200' => [
                        'description' => '咒语处理成功',
                        'content' => [
                            'application/json' => [
                                'schema' => [
                                    'type' => 'object',
                                    'properties' => [
                                        'message' => ['type' => 'string', 'example' => '咒语已成功施放！'],
                                        'result' => ['type' => 'array', 'items' => ['type' => 'string']],
                                    ],
                                ],
                            ],
                        ],
                    ],
                    '400' => [
                        'description' => '无效的咒语输入',
                    ],
                ],
            ],
            // 如果需要，可以指定一个自定义的处理器（processor）
            // 'processor' => GrimoireProcessor::class,
        ],
    ],
    // 定义资源的数据传输对象 (DTO) 或输入/输出类型
    input: GrimoireInput::class,
    output: GrimoireOutput::class,
)]
class Grimoire
{
    // 资源属性定义 (如果需要，即使不持久化也可以有内部结构)
    // ...
}

// 示例输入DTO (GrimoireInput.php)
class GrimoireInput
{
    #[Assert\NotBlank]
    public string $spell;

    public array $params = [];
}

// 示例输出DTO (GrimoireOutput.php)
class GrimoireOutput
{
    public string $message;
    public array $result;
}