Symfony API请求内容校验：如何验证所需键是否存在？

我在Symfony里处理application/json格式的POST请求时，是这么获取内容的：

$content = json_decode($request->getContent());

用dd($content)输出的结果是这样的关联数组：

[ "subject" => "test", "content" => "content" ]

现在我需要用subject字段来填充SubjectEntity对象，目前的写法是：

$subject = new SubjectEntity();
$subject->setSubject($content['subject']);

但我不想在subject键不存在的时候调用setSubject()。我知道可以用if判断或者$subject->setSubject($content['subject'] ?? null)来处理，但场景复杂（比如有多个必填字段、还要验证字段类型）的时候，这种写法就会特别繁琐。想问问有没有更优雅的办法能验证请求内容里是否包含所有需要的键？

方法1：用Symfony Validator组件做结构化验证 #

Symfony自带的Validator组件专门用来处理这种数据验证场景，不仅能检查字段是否存在，还能验证类型、长度等规则，非常适合复杂场景。

首先定义一个用来承载请求规则的类（相当于DTO）：

use Symfony\Component\Validator\Constraints as Assert;

class SubjectRequest
{
    // 标注subject是必填字段，且必须是字符串类型
    #[Assert\NotBlank(message: 'subject字段不能为空')]
    #[Assert\Type('string')]
    public ?string $subject = null;

    // 如果还有其他必填字段，比如content，直接在这里添加约束即可
    #[Assert\NotBlank(message: 'content字段不能为空')]
    #[Assert\Type('string')]
    public ?string $content = null;
}

然后在控制器里用Validator来验证请求内容：

use Symfony\Component\Validator\Validator\ValidatorInterface;

public function createSubject(Request $request, ValidatorInterface $validator)
{
    // 把JSON转成关联数组
    $content = json_decode($request->getContent(), true);
    
    // 实例化请求规则类，把请求数据映射进去
    $subjectRequest = new SubjectRequest();
    foreach ($content as $key => $value) {
        if (property_exists($subjectRequest, $key)) {
            $subjectRequest->$key = $value;
        }
    }

    // 执行验证
    $errors = $validator->validate($subjectRequest);

    // 如果有错误，返回400响应和错误信息
    if (count($errors) > 0) {
        $errorMessages = [];
        foreach ($errors as $error) {
            $errorMessages[$error->getPropertyPath()] = $error->getMessage();
        }
        return $this->json($errorMessages, 400);
    }

    // 验证通过，放心填充实体
    $subject = new SubjectEntity();
    $subject->setSubject($subjectRequest->subject);

    // 后续的业务逻辑...
}

方法2：结合Serializer组件自动映射+验证 #

如果想更高效，还可以搭配Symfony的Serializer组件，自动把JSON请求转成我们定义的SubjectRequest对象，同时完成验证，省去手动映射的步骤：

use Symfony\Component\Serializer\SerializerInterface;
use Symfony\Component\Validator\ValidatorInterface;

public function createSubject(Request $request, SerializerInterface $serializer, ValidatorInterface $validator)
{
    try {
        // 自动把JSON反序列化成SubjectRequest对象
        $subjectRequest = $serializer->deserialize(
            $request->getContent(),
            SubjectRequest::class,
            'json'
        );
    } catch (\Exception $e) {
        // 处理JSON格式错误的情况
        return $this->json(['error' => '无效的JSON格式'], 400);
    }

    // 同样执行验证
    $errors = $validator->validate($subjectRequest);

    if (count($errors) > 0) {
        $errorMessages = [];
        foreach ($errors as $error) {
            $errorMessages[$error->getPropertyPath()] = $error->getMessage();
        }
        return $this->json($errorMessages, 400);
    }

    // 填充实体
    $subject = new SubjectEntity();
    $subject->setSubject($subjectRequest->subject);

    // ...
}

这种方式不仅能验证必填字段，还能自动处理类型转换，比如把JSON里的数值转成对应类型，非常省心。

方法3：手动验证数组键（适合简单场景） #

如果你的场景很简单，只是检查几个必填键是否存在，也可以直接手动验证：

// 定义所有必填字段的键名
$requiredKeys = ['subject', 'content'];
// 找出请求中缺失的键
$missingKeys = array_diff($requiredKeys, array_keys($content));

if (!empty($missingKeys)) {
    return $this->json([
        'error' => '缺少必填字段',
        'missing_fields' => $missingKeys
    ], 400);
}

// 验证通过再填充实体
$subject = new SubjectEntity();
$subject->setSubject($content['subject']);

这种写法简单直接，但如果后续需要加更多验证规则（比如字段长度、格式），就会变得臃肿，还是推荐用Validator组件。

内容的提问来源于stack exchange，提问作者Gaylord.P