Symfony 3.4中如何验证可选URL查询字符串GET参数为整数？

首先得明确：你在路由里配置的requirements只对路由路径中的占位符（比如{course}、{area}）生效，对?后面的查询字符串参数（ownerId、courseId）是不起作用的，这就是为什么那组非法参数的请求能正常进入action的原因。不过有几种优雅的方式来解决这个需求：

方法1：手动验证参数（简单直接） #

在action里直接检查参数的合法性，如果参数存在但不是整数，就抛出错误或者返回错误响应：

public function bookTeeoffAction(Request $request): Response
{
    $ownerId = $request->get('ownerId');
    $courseId = $request->get('courseId');

    // 验证ownerId（仅当参数存在时）
    if ($ownerId !== null && !ctype_digit((string)$ownerId)) {
        throw new \Symfony\Component\HttpKernel\Exception\BadRequestHttpException('ownerId必须是整数');
    }

    // 验证courseId（仅当参数存在时）
    if ($courseId !== null && !ctype_digit((string)$courseId)) {
        throw new \Symfony\Component\HttpKernel\Exception\BadRequestHttpException('courseId必须是整数');
    }

    // 参数合法，继续执行仓库查询等逻辑
    // ...
}

这里用ctype_digit而不是is_int是因为$request->get()返回的是字符串类型，is_int会直接返回false，ctype_digit可以准确判断字符串是否由纯数字组成。

方法2：使用Symfony Validator组件（规范可扩展） #

如果需要更复杂的验证规则（比如正整数、数值范围等），推荐用Validator组件来处理，代码更规范也更容易维护：

use Symfony\Component\Validator\Constraints as Assert;

public function bookTeeoffAction(Request $request, \Symfony\Component\Validator\Validator\ValidatorInterface $validator): Response
{
    // 收集需要验证的查询参数
    $params = [
        'ownerId' => $request->get('ownerId'),
        'courseId' => $request->get('courseId'),
    ];

    // 定义验证约束：可选参数，但如果提供必须是整数（可追加其他规则）
    $constraints = new Assert\Collection([
        'ownerId' => new Assert\Optional([
            new Assert\Type('integer'),
            new Assert\Positive(), // 可选：要求是正整数
        ]),
        'courseId' => new Assert\Optional([
            new Assert\Type('integer'),
            new Assert\Positive(),
        ]),
    ]);

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

    // 处理验证错误
    if (count($violations) > 0) {
        $errorMessages = [];
        foreach ($violations as $violation) {
            $errorMessages[$violation->getPropertyPath()] = $violation->getMessage();
        }

        // 返回JSON格式的错误响应（如果是HTML页面，可以渲染错误模板）
        return new \Symfony\Component\HttpFoundation\JsonResponse(
            ['errors' => $errorMessages],
            \Symfony\Component\HttpFoundation\Response::HTTP_BAD_REQUEST
        );
    }

    // 参数合法，继续后续逻辑
    // ...
}

方法3：利用Request的query参数过滤（快速转换） #

Symfony的Request对象提供了getInt()方法，可以自动尝试将查询参数转换为整数，转换失败时返回你指定的默认值。不过需要额外判断“用户传了参数但转换后为0”的情况（如果你的业务不允许0作为合法值）：

public function bookTeeoffAction(Request $request): Response
{
    // 第二个参数是默认值，这里传null表示没传参数时返回null
    $ownerId = $request->query->getInt('ownerId', null);
    $courseId = $request->query->getInt('courseId', null);

    // 如果用户明确传了ownerId，但转换后是0，说明原参数不是合法整数
    if ($request->query->has('ownerId') && $ownerId === 0) {
        throw new \Symfony\Component\HttpKernel\Exception\BadRequestHttpException('ownerId必须是正整数');
    }

    if ($request->query->has('courseId') && $courseId === 0) {
        throw new \Symfony\Component\HttpKernel\Exception\BadRequestHttpException('courseId必须是正整数');
    }

    // 后续逻辑
    // ...
}

选择建议 #

• 如果只是简单的整数验证，方法1或方法3足够用；
• 如果需要扩展验证规则（比如数值范围、格式校验等），或者有多个参数需要验证，方法2更合适，符合Symfony的最佳实践。

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