_gets = $gets; } /** * @param mixed $posts */ public function setPosts(mixed $posts): void { $this->_posts = $posts; } /** * @param array|null $files */ public function setFiles(?array $files): void { $this->_files = $files; } /** * @param mixed|string $rawContent */ public function setRawContent(mixed $rawContent, string $context_type): void { if (str_contains($context_type, 'json')) { $this->_rawContent = json_decode($rawContent, true); } else if (str_contains($context_type, 'xml')) { $this->_rawContent = Xml::toArray($rawContent); } else { $this->_rawContent = $rawContent; } } /** * @return mixed * @throws Exception */ public function getRawContent(): mixed { return $this->_rawContent; } /** * @return int */ public function offset(): int { return ($this->page() - 1) * $this->size(); } /** * @return array|null */ public function getBody(): ?array { return $this->_posts; } /** * @return int */ private function page(): int { return (int)$this->query('page', 1); } /** * @param $name * @param null $default * @return mixed */ public function query($name = null, $default = null): mixed { if (!empty($name)) { return $this->_gets[$name] ?? $default; } return $this->_gets; } /** * @return int */ public function size(): int { return (int)$this->query('size', 20); } /** * @param $name * @param null $defaultValue * @return mixed */ public function post($name, $defaultValue = null): mixed { return $this->_posts[$name] ?? $defaultValue; } /** * @param $name * @return bool|string * @throws Exception */ public function json($name): bool|string { $data = $this->array($name); if (empty($data)) { return Json::encode([]); } else if (!is_array($data)) { return Json::encode([]); } return Json::encode($data); } /** * @return array */ public function gets(): array { return $this->_gets; } /** * @return array */ public function params(): array { return array_merge($this->_gets, $this->_posts); } /** * @return array */ public function load(): array { return array_merge($this->_files, $this->_gets, $this->_posts); } /** * @param $name * @param array $defaultValue * @return mixed */ public function array($name, array $defaultValue = []): mixed { return $this->_posts[$name] = $defaultValue; } /** * @param $name * @return File|null * @throws ReflectionException * @throws NotFindClassException */ public function file($name): File|null { $param = $this->_files[$name] ?? null; if (!empty($param)) { $param['class'] = File::class; return Kiri::createObject($param); } return null; } /** * @param string $name * @param bool $isNeed * @return mixed * @throws RequestException */ private function required(string $name, bool $isNeed = false): mixed { $int = $this->_posts[$name] ?? null; if (is_null($int) && $isNeed === true) { throw new RequestException("You need to add request parameter $name"); } return $int; } /** * @param string $name * @param bool $isNeed * @param array|int|null $min * @param int|null $max * @return int|null * @throws RequestException */ public function int(string $name, bool $isNeed = FALSE, array|int|null $min = NULL, int|null $max = NULL): ?int { return (int)$this->required($name, $isNeed); } /** * @param string $name * @param bool $isNeed * @param int $round * @return float|null * @throws RequestException */ public function float(string $name, bool $isNeed = FALSE, int $round = 0): ?float { return (float)$this->required($name, $isNeed); } /** * @param string $name * @param bool $isNeed * @param int|array|null $length * * @return string|null * @throws RequestException */ public function string(string $name, bool $isNeed = FALSE, int|array|null $length = NULL): ?string { return (string)$this->required($name, $isNeed); } /** * @param string $name * @param bool $isNeed * * @return string|null * @throws RequestException */ public function email(string $name, bool $isNeed = FALSE): ?string { $email = $this->required($name, $isNeed); if ($email === null) { return null; } if (!preg_match('/^\w+([.-_]\w+)+@\w+(\.\w+)+$/', $email)) { throw new RequestException("Request parameter $name is in the wrong format", 4001); } return $email; } /** * @param string $name * @param bool $isNeed * * @return bool * @throws RequestException */ public function bool(string $name, bool $isNeed = FALSE): bool { return (boolean)$this->required($name, $isNeed); } /** * @param string $name * @param int|null $default * * @return int|string|null * @throws RequestException */ public function timestamp(string $name, int|null $default = NULL): null|int|string { $value = $this->required($name, false); if ($value === null) { return $default; } if (!is_numeric($value)) { throw new RequestException('The request param :attribute not is a timestamp value'); } if (strlen((string)$value) != 10) { throw new RequestException('The request param :attribute not is a timestamp value'); } if (!date('YmdHis', $value)) { throw new RequestException('The request param :attribute format error', 4001); } return $value; } /** * @param string $name * @param string|null $default * * @return string|null * @throws RequestException */ public function datetime(string $name, string $default = NULL): string|null { $value = $this->required($name, false); if ($value === null) { return $default; } $match = '/^\d{4}.*?([1-12]).*([1-31]).*?[0-23].*?[0-59].*?[0-59].*?$/'; $match = preg_match($match, $value, $result); if (!$match || $result[0] != $value) { throw new RequestException('The request param :attribute format error', 4001); } return $value; } /** * @param string $name * @param string|null $default * * @return string|null * @throws RequestException */ public function date(string $name, string $default = NULL): string|null { $value = $this->required($name, false); if ($value === null) { return $default; } $match = '/^\d{4}.*?([1-12]).*([1-31])$/'; $match = preg_match($match, $value, $result); if (!$match || $result[0] != $value) { throw new RequestException('The request param :attribute format error', 4001); } return $value; } /** * @param string $name * @param string|null $default * @return string|null * @throws RequestException */ public function ip(string $name, string $default = NULL): string|null { $value = $this->required($name, false); if ($value == NULL) { return $default; } $match = preg_match('/^\d{1,3}(\.\d{1,3}){3}$/', $value, $result); if (!$match || $result[0] != $value) { throw new RequestException('The request param :attribute format error', 4001); } return $value; } }