PHP/Web
PHP/Web
2
0
Fork 0
Code

explicit input methods

Browse Source
This commit is contained in:
Sky Johnson 2025-09-11 08:48:10 -05:00
parent 6184d28dda
commit 568bd621f9
4 changed files with 76 additions and 48 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
Context.php
View File

@ -119,12 +119,7 @@ class Context
*/
public function validateRequest(array $rules, array $messages = []): Validator
{
$data = array_merge(
$this->request->query,
$this->request->body,
$this->request->params
);
$data = $this->request->all();
return $this->validate($data, $rules, $messages);
}
@ -137,7 +132,7 @@ class Context
}
/**
* input returns input value from any source (route, query, post, json)
* input returns a form input value (POST data)
*/
public function input(string $name, mixed $default = null): mixed
{
@ -145,11 +140,27 @@ class Context
}
/**
* param returns a parameter from route params, query params, or post data
* query returns a query parameter value
*/
public function param(string $name): mixed
public function query(string $name, mixed $default = null): mixed
{
return $this->request->param($name);
return $this->request->query($name, $default);
}
/**
* jsonValue returns a value from JSON body
*/
public function jsonValue(string $name, mixed $default = null): mixed
{
return $this->request->jsonValue($name, $default);
}
/**
* param returns a route parameter
*/
public function param(string $name, mixed $default = null): mixed
{
return $this->request->param($name, $default);
}
/**

33
EXAMPLES.md
View File

@ -88,17 +88,28 @@ $result = $router->lookup('GET', '/posts/123');
### Request Helpers
```php
// Get input from any source (route params, query, POST, JSON)
$name = $context->input('name', 'default');
$email = $context->input('email');
// Get input from specific sources - explicit and predictable
$name = $context->input('name', 'default'); // POST data only
$search = $context->query('search', ''); // Query params only
$data = $context->jsonValue('data', []); // JSON body only
$id = $context->param('id', 0); // Route params only
// Get specific parameter types
$id = $context->param('id'); // route/query/post params
$all = $context->all(); // all input data
// Examples with conflicting parameter names
// URL: /users/123?name=query_name
// POST: name=post_name
// JSON: {"name": "json_name"}
$routeId = $context->param('id'); // "123" from route
$queryName = $context->query('name'); // "query_name" from URL
$postName = $context->input('name'); // "post_name" from form
$jsonName = $context->jsonValue('name'); // "json_name" from JSON
// Get all input data merged from all sources (route params override all)
$all = $context->all();
$data = $context->only(['name', 'email']); // specific keys only
$data = $context->except(['password']); // all except specified keys
// Check if input exists
// Check if input exists (checks all sources)
if ($context->has('email')) {
// handle email
}
@ -201,9 +212,11 @@ $request->postData; // parsed POST data
$request->params; // route parameters (set by router)
// Input methods
$value = $request->input('key', 'default'); // from any source
$value = $request->param('key'); // route/query/post only
$all = $request->all(); // all input merged
$value = $request->input('key', 'default'); // POST data only
$value = $request->query('key', 'default'); // Query params only
$value = $request->jsonValue('key', 'default'); // JSON body only
$value = $request->param('key', 'default'); // Route params only
$all = $request->all(); // all input merged
$subset = $request->only(['key1', 'key2']);
$subset = $request->except(['password']);
$exists = $request->has('key');

10
README.md
View File

@ -41,7 +41,7 @@ High-performance tree-based router with dynamic parameter support.
### Context
Central request/response wrapper with helper methods to reduce chaining.
- Request helpers: `input()`, `param()`, `all()`, `only()`, `except()`, `has()`
- Request helpers: `input()` (POST), `query()` (GET), `jsonValue()` (JSON), `param()` (route), `all()`
- Response helpers: `json()`, `text()`, `html()`, `redirect()`, `error()`
- Request info: `ip()`, `userAgent()`, `header()`, `cookie()`, `expectsJson()`
- State management: `set()`, `get()`
@ -49,7 +49,7 @@ Central request/response wrapper with helper methods to reduce chaining.
### Request
Comprehensive HTTP request handling.
- Input parsing from query, POST, JSON, and route parameters
- Explicit input methods: `input()` (POST), `query()` (GET), `jsonValue()` (JSON), `param()` (route)
- Header and cookie access
- Content type detection
- URL and security helpers
@ -112,8 +112,10 @@ run(): void
### Context Class
```php
// Request helpers
input(string $name, mixed $default = null): mixed
param(string $name): mixed
input(string $name, mixed $default = null): mixed // POST data
query(string $name, mixed $default = null): mixed // Query params
jsonValue(string $name, mixed $default = null): mixed // JSON body
param(string $name, mixed $default = null): mixed // Route params
all(): array
only(array $keys): array
except(array $keys): array

50
Request.php
View File

@ -94,42 +94,44 @@ class Request
}
/**
* param returns a parameter from route params, query params, or post data
* param returns a route parameter
*/
public function param(string $name): mixed
public function param(string $name, mixed $default = null): mixed
{
return $this->params[$name] ?? $this->queryParams[$name] ?? $this->postData[$name] ?? null;
return $this->params[$name] ?? $default;
}
/**
* input returns input value from any source (route, query, post, json)
* input returns a form input value (POST data)
*/
public function input(string $name, mixed $default = null): mixed
{
// Check route params first
if (isset($this->params[$name])) {
return $this->params[$name];
return $this->postData[$name] ?? $default;
}
/**
* query returns a query parameter value
*/
public function query(string $name, mixed $default = null): mixed
{
return $this->queryParams[$name] ?? $default;
}
/**
* jsonValue returns a value from JSON body
*/
public function jsonValue(string $name, mixed $default = null): mixed
{
if ($this->contentType() !== 'application/json') {
return $default;
}
// Check query params
if (isset($this->queryParams[$name])) {
return $this->queryParams[$name];
$json = $this->json();
if (!is_array($json)) {
return $default;
}
// Check post data
if (isset($this->postData[$name])) {
return $this->postData[$name];
}
// Check JSON body
if ($this->contentType() === 'application/json') {
$json = $this->json();
if (is_array($json) && isset($json[$name])) {
return $json[$name];
}
}
return $default;
return $json[$name] ?? $default;
}
/**