如何在Symfony 6中使用约束属性验证路由参数？

方法一：直接在控制器参数上使用断言属性 #

Symfony 6+ 支持直接在控制器方法的参数上标注验证约束，无需依赖ParamConverter的constraints选项。示例代码：

use Symfony\Component\Validator\Constraints as Assert;

/**
 * @Route("/article/{id}", name="article_show")
 */
public function show(
    #[Assert\NotNull]
    #[Assert\Type(type: 'digit')]
    string $id
) {
    // 业务逻辑
}

需要确保项目已启用验证组件：在config/packages/framework.yaml中确认framework.validation.enabled: true，此配置默认已开启。验证不通过时，Symfony会自动抛出ValidationFailedException，可通过异常处理器统一处理错误响应。

方法二：使用DTO（数据传输对象）绑定并验证 #

将路由参数封装到DTO类中，对DTO的属性添加约束，再通过MapRequestPayload属性（Symfony 6.2+ 可用）自动绑定参数并验证：

1. 创建DTO类：

// src/DTO/ArticleRequest.php
namespace App\DTO;

use Symfony\Component\Validator\Constraints as Assert;

class ArticleRequest
{
    #[Assert\NotNull]
    #[Assert\Type(type: 'digit')]
    public string $id;
}

2. 控制器中使用DTO：

use App\DTO\ArticleRequest;
use Symfony\Component\HttpKernel\Attribute\MapRequestPayload;

/**
 * @Route("/article/{id}", name="article_show")
 */
public function show(#[MapRequestPayload] ArticleRequest $request)
{
    $id = $request->id;
    // 业务逻辑
}

此方式适合参数较多的场景，便于统一管理验证规则。

方法三：手动注入Validator服务验证 #

如果需要更灵活的验证逻辑，可以直接在控制器中注入ValidatorInterface，手动对参数进行验证：

use Symfony\Component\Validator\Validator\ValidatorInterface;
use Symfony\Component\Validator\Constraints as Assert;
use Symfony\Component\HttpFoundation\JsonResponse;

/**
 * @Route("/article/{id}", name="article_show")
 */
public function show(string $id, ValidatorInterface $validator)
{
    // 定义约束规则
    $constraints = [
        new Assert\NotNull(),
        new Assert\Type(type: 'digit'),
    ];

    // 执行验证
    $violations = $validator->validate($id, $constraints);

    // 处理验证错误
    if (count($violations) > 0) {
        return new JsonResponse(
            ['errors' => (string) $violations],
            400
        );
    }

    // 业务逻辑
}

方法四：自定义ParamConverter实现验证 #

针对复杂的参数验证/转换逻辑，可以自定义ParamConverter，在其中集成验证逻辑：

1. 创建自定义转换器类：

// src/ParamConverter/ArticleIdConverter.php
namespace App\ParamConverter;

use Sensio\Bundle\FrameworkExtraBundle\Configuration\ParamConverter;
use Sensio\Bundle\FrameworkExtraBundle\Request\ParamConverter\ParamConverterInterface;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\Validator\Validator\ValidatorInterface;
use Symfony\Component\Validator\Constraints as Assert;
use Symfony\Component\HttpKernel\Exception\BadRequestHttpException;

class ArticleIdConverter implements ParamConverterInterface
{
    public function __construct(private ValidatorInterface $validator)
    {
    }

    public function apply(Request $request, ParamConverter $configuration)
    {
        $id = $request->get('id');
        // 定义约束
        $constraints = [
            new Assert\NotNull(),
            new Assert\Type(type: 'digit'),
        ];

        $violations = $this->validator->validate($id, $constraints);
        if (count($violations) > 0) {
            throw new BadRequestHttpException((string) $violations);
        }

        $request->attributes->set($configuration->getName(), $id);
        return true;
    }

    public function supports(ParamConverter $configuration)
    {
        // 指定此转换器仅处理名为"id"的参数
        return $configuration->getName() === 'id' && $configuration->getClass() === null;
    }
}

2. 控制器中引用自定义转换器：

use Sensio\Bundle\FrameworkExtraBundle\Configuration\ParamConverter;

/**
 * @Route("/article/{id}", name="article_show")
 * @ParamConverter("id", converter="app.article_id_converter")
 */
public function show(string $id)
{
    // 业务逻辑
}

Symfony 6+ 会自动注册此类为服务，无需额外配置。

内容的提问来源于stack exchange，提问作者Olga Bondarenko