Swoft2 框架精华教程：Controller 组件解析，使用说明

/**
 * 表示路由最基础的前缀，此处为 `/`，RequestMapping 中引入的 @prefix 就是此处的 prefix 值
 * @Controller("/")
 * @Controller(prefix="/")
 * 
 * 可以不用写 `/`， 会自动加上，表示 `/user` 前缀的路由
 * @Controller("user")
 */

/**
 * 此规则表示有一个 en_name 的参数，且此参数必须匹配正则 [A-Za-z0-9\-\_]+ 此调路由才能匹配
 * @RequestMapping(route="{en_name}/", params={"en_name"="[A-Za-z0-9\-\_]+"}, method={"GET"})
 * 此规则表示，为 / 或者 /index.html 或者 /list-12.html 这种形式
 * @RequestMapping(route="/[list-{page}.html|index.html]", params={"page"="[2-9]\d*|1\d+"}, method={"GET"})
 */

// 通过三个方法均可获得用户传递的参数
$request->getParsedBody();
// 获取单个校验过的数据
$page = $request->parsedBody('page');
$size = $request->parsedBody('size');
// 获取 GET 请求中的所有经过校验的参数数据
$query = $request->getParsedQuery();
// 获取路由参数经过校验器的值
$request->getParsedPath();

/**
 * 获取内容，并且校验 query 中的参数值
 * @RequestMapping("list", method="GET")
 * @Validate(validator=PageListDto::class, fields={"page", "size"}, type="query")
 *
 * @param Request $request
 * @param Response $response
 * @return Response
 * @throws ApiException
 */

/**
 * @param array $body
 * @param array $validates
 * @param array $query
 * @param array $path
 *
 * @return array
 * @throws ValidatorException
 */
public function validateRequest(array $body, array $validates, array $query = [], array $path = []): array
{
    // 循环遍历当前控制器方法上注解的校验规则
    foreach ($validates as $name => $validate) {
        $validator = ValidatorRegister::getValidator($name);

        if (empty($validator)) {
            throw new ValidatorException(sprintf('Validator(%s) is not exist!', $name));
        }
		// 获取当前校验器类型，是系统校验器还是自定义校验器
        $type     = $validator['type'];
        $fields   = $validate['fields'] ?? [];
        $unfields = $validate['unfields'] ?? [];
        $params   = $validate['params'] ?? [];
		// 获取当前校验规则的类型（校验get、body、还是path）
        $validateType = $validate['type'];

        // 如果校验器类型指定为get，则只校验匹配的get类型参数
        // Get query params
        if ($validateType === ValidateType::GET) {
            $query = $this->doValidate($query, $type, $name, $params, $validator, $fields, $unfields);
            continue;
        }

        // 如果校验器类型指定为path，则只校验路由的path参数
        // Route path params
        if ($validateType === ValidateType::PATH) {
            $path = $this->doValidate($path, $type, $name, $params, $validator, $fields, $unfields);
            continue;
        }
		// 如果未指定，默认校验body参数
        $body = $this->doValidate($body, $type, $name, $params, $validator, $fields, $unfields);
    }

    return [$body, $query, $path];
}

// 此函数通过校验 validator 单例对象来触发校验
function validate(
    array $data,
    string $validatorName,
    array $fields = [],
    array $userValidators = [],
    array $unfields = []
): array {
    /* @var Validator $validator */
    $validator = BeanFactory::getBean('validator');
    return $validator->validate($data, $validatorName, $fields, $userValidators, $unfields);
}