getInt('id', 0); * $name = $request->getString('name', ''); * $flag = $request->getBool('flag', false); * $ids = $request->getArray('ids', []); * * Can also extract from specific superglobals: * $request->fromPost()->getString('login'); * $request->fromGet()->getInt('limit', 20); */ class Request { public const SOURCE_REQUEST = 'request'; public const SOURCE_GET = 'get'; public const SOURCE_POST = 'post'; public const SOURCE_BODY = 'body'; /** @var array|null */ private ?array $data = null; /** @var array|null */ private ?array $body = null; /** @var array */ private array $attributes = []; /** @var self::SOURCE_* */ private string $source = self::SOURCE_REQUEST; /** * @param array|null $data Optional explicit data source (e.g. from constructor arg) */ public function __construct(?array $data = null) { $this->data = $data; } /** * Extract from the given superglobal. * * @param self::SOURCE_* $source * @return $this */ public function from(string $source): self { $this->source = $source; return $this; } /** * Extract from $_POST. * @return $this */ public function fromPost(): self { return $this->from(self::SOURCE_POST); } /** * Extract from $_GET. * @return $this */ public function fromGet(): self { return $this->from(self::SOURCE_GET); } /** * Extract from $_REQUEST (default). * @return $this */ public function fromRequest(): self { return $this->from(self::SOURCE_REQUEST); } /** * Extract from the raw request body (php://input). * * Inspects Content-Type to determine parsing strategy: * - application/json / text/json → JSON decode * - application/x-www-form-urlencoded → parse_str (like $_POST) * - anything else / missing → empty array * * If JSON decoding fails, an empty array is returned so downstream * getters fall back to defaults. * * Useful for PATCH/PUT requests where $_POST is not populated. * * @return $this */ public function fromBody(): self { if ($this->body !== null) { return $this; } $raw = file_get_contents('php://input'); if ($raw === '') { $this->body = []; return $this; } // Determine content type, stripping charset etc. $contentType = strtolower(explode(';', $_SERVER['CONTENT_TYPE'] ?? '')[0]); if (in_array($contentType, ['application/json', 'text/json'], true)) { $decoded = json_decode($raw, true); $this->body = is_array($decoded) ? $decoded : []; } elseif ($contentType === 'application/x-www-form-urlencoded') { parse_str($raw, $parsed); $this->body = $parsed; } else { $this->body = []; } return $this->from(self::SOURCE_BODY); } /** * Get a sanitized string value. * * @param string $key * @param string $default * @return string */ public function getString(string $key, string $default = ''): string { $value = $this->getRaw($key); if ($value === null) { return $default; } return trim((string)$value); } /** * Get an integer value. * * @param string $key * @param int $default * @return int */ public function getInt(string $key, int $default = 0): int { $value = $this->getRaw($key); if ($value === null) { return $default; } return (int) $value; } /** * Get a float value. * * @param string $key * @param float $default * @return float */ public function getFloat(string $key, float $default = 0.0): float { $value = $this->getRaw($key); if ($value === null) { return $default; } return (float) $value; } /** * Get a sanitized boolean value. * * Treats the following as true: "1", "true", "t", "on", non-zero integers, * non-empty strings. All other values are treated as false. * * @param string $key * @param bool $default * @return bool */ public function getBool(string $key, bool $default = false): bool { $value = $this->getRaw($key); if ($value === null) { return $default; } return self::_to_bool($value); } /** * Get a sanitized array value. * * If the value is a comma-separated string, it will be split into an array. * Each element is trimmed. * * @param string $key * @param array $default * @return array */ public function getArray(string $key, array $default = []): array { $value = $this->getRaw($key); if ($value === null) { return $default; } if (is_array($value)) { return array_map(static fn($v) => is_string($v) ? trim((string)$v) : $v, $value); } // Handle comma-separated string values $trimmed = trim((string)$value); if ($trimmed === '') { return []; } return array_map('trim', explode(',', $trimmed)); } /** * Get the raw (unsanitized) value. * * @param string $key * @return mixed|null */ public function getRaw(string $key): mixed { return match ($this->source) { self::SOURCE_POST => $_POST[$key] ?? null, self::SOURCE_GET => $_GET[$key] ?? null, self::SOURCE_BODY => $this->body[$key] ?? null, default => $this->data !== null ? ($this->data[$key] ?? null) : ($_REQUEST[$key] ?? null), }; } /** * Check if a key exists in the current source. * * @param string $key * @return bool */ public function has(string $key): bool { return match ($this->source) { self::SOURCE_POST => array_key_exists($key, $_POST), self::SOURCE_GET => array_key_exists($key, $_GET), self::SOURCE_BODY => array_key_exists($key, $this->body), default => $this->data !== null ? array_key_exists($key, $this->data) : array_key_exists($key, $_REQUEST), }; } /** * Get all parameters from the current source. * * @return array */ public function all(): array { return match ($this->source) { self::SOURCE_POST => $_POST, self::SOURCE_GET => $_GET, self::SOURCE_BODY => $this->body ?? [], default => $this->data !== null ? $this->data : $_REQUEST, }; } /** * Get all query parameters (\$_GET). * * @return array */ public function getQueryParams(): array { return $_GET; } /** * Get all server parameters (\$_SERVER). * * @return array */ public function getServerParams(): array { return $_SERVER; } /** * Get all cookie parameters (\$_COOKIE). * * @return array */ public function getCookieParams(): array { return $_COOKIE; } /** * Get a merged body from \$_GET and \$_POST, with \$_POST values * overriding \$_GET on key collision. * * @return array */ public function getParsedBody(): array { return array_merge($_GET, $_POST); } /** * Get an attribute or request parameter by key. * * Looks first in attributes set via withAttribute(), then in the * parsed body (\$_GET + \$_POST merged). * * @param string $key * @param mixed $default * @return mixed */ public function getAttribute(string $key, mixed $default = null): mixed { // Check attributes first if (array_key_exists($key, $this->attributes)) { return $this->attributes[$key]; } // Fall back to parsed body $body = $this->getParsedBody(); return $body[$key] ?? $default; } /** * Return a clone of this request with a new attribute added. * * @param string $key * @param mixed $value * @return self */ public function withAttribute(string $key, mixed $value): self { $clone = clone $this; $clone->attributes[$key] = $value; return $clone; } /** * Get a subset of parameters by key names. * * @param array $keys * @return array */ public function only(array $keys): array { $result = []; foreach ($keys as $key) { $result[$key] = $this->getRaw($key); } return $result; } /** * Convert a value to boolean using the same logic as Handler::_param_to_bool(). * * @param mixed $value * @return bool */ public static function _to_bool(mixed $value): bool { if (is_string($value)) { $value = trim($value); } if (is_bool($value)) { return $value; } if (is_int($value)) { return $value !== 0; } if (is_float($value)) { return $value != 0.0; } if (is_string($value)) { $lower = strtolower($value); return in_array($lower, ['1', 'true', 't', 'on'], true); } return (bool) $value; } }