'bar', 'page' => '1'];
$request = new Request();
$this->assertEquals(['foo' => 'bar', 'page' => '1'], $request->getQueryParams());
}
public function test_get_query_params_empty(): void
{
$_GET = [];
$request = new Request();
$this->assertEquals([], $request->getQueryParams());
}
// ── getServerParams() ────────────────────────────────────────────────────
public function test_get_server_params_returns_server(): void
{
$_SERVER = ['REQUEST_METHOD' => 'POST', 'SCRIPT_NAME' => '/backend.php'];
$request = new Request();
$this->assertEquals(['REQUEST_METHOD' => 'POST', 'SCRIPT_NAME' => '/backend.php'], $request->getServerParams());
}
// ── getCookieParams() ────────────────────────────────────────────────────
public function test_get_cookie_params_returns_cookies(): void
{
$_COOKIE = ['session' => 'abc123'];
$request = new Request();
$this->assertEquals(['session' => 'abc123'], $request->getCookieParams());
}
// ── getParsedBody() ──────────────────────────────────────────────────────
public function test_get_parsed_body_merges_get_and_post(): void
{
$_GET = ['op' => 'list'];
$_POST = ['limit' => '10'];
$request = new Request();
$body = $request->getParsedBody();
$this->assertEquals('list', $body['op']);
$this->assertEquals('10', $body['limit']);
}
public function test_get_parsed_body_post_overrides_get(): void
{
$_GET = ['op' => 'list'];
$_POST = ['op' => 'getinfo'];
$request = new Request();
$body = $request->getParsedBody();
// array_merge: second array values override first
$this->assertEquals('getinfo', $body['op']);
}
public function test_get_parsed_body_only_get(): void
{
$_GET = ['op' => 'list'];
$_POST = [];
$request = new Request();
$this->assertEquals(['op' => 'list'], $request->getParsedBody());
}
public function test_get_parsed_body_only_post(): void
{
$_GET = [];
$_POST = ['op' => 'perform-login'];
$request = new Request();
$this->assertEquals(['op' => 'perform-login'], $request->getParsedBody());
}
// ── getAttribute() ───────────────────────────────────────────────────────
public function test_get_attribute_returns_value_from_body(): void
{
$_POST = ['op' => 'list'];
$request = new Request();
$this->assertEquals('list', $request->getAttribute('op'));
}
public function test_get_attribute_returns_default_when_missing(): void
{
$_POST = [];
$request = new Request();
$this->assertNull($request->getAttribute('missing'));
}
public function test_get_attribute_returns_custom_default(): void
{
$_POST = [];
$request = new Request();
$this->assertEquals('default_value', $request->getAttribute('missing', 'default_value'));
}
// ── withAttribute() ──────────────────────────────────────────────────────
public function test_with_attribute_returns_clone(): void
{
$_POST = ['op' => 'list'];
$request = new Request();
$newRequest = $request->withAttribute('limit', 10);
$this->assertNotSame($request, $newRequest);
}
public function test_with_attribute_sets_value(): void
{
$_POST = ['op' => 'list'];
$request = new Request();
$newRequest = $request->withAttribute('limit', 10);
$this->assertEquals(10, $newRequest->getAttribute('limit'));
}
public function test_with_attribute_does_not_mutate_original(): void
{
$_POST = ['op' => 'list'];
$request = new Request();
$request->withAttribute('limit', 10);
$this->assertNull($request->getAttribute('limit'));
}
public function test_with_attribute_preserves_existing_attributes(): void
{
$_POST = ['op' => 'list'];
$request = new Request();
$newRequest = $request->withAttribute('limit', 10);
$this->assertEquals('list', $newRequest->getAttribute('op'));
$this->assertEquals(10, $newRequest->getAttribute('limit'));
}
public function test_with_attribute_overwrites_existing(): void
{
$_POST = ['op' => 'list'];
$request = new Request();
$newRequest = $request->withAttribute('op', 'getinfo');
$this->assertEquals('getinfo', $newRequest->getAttribute('op'));
}
// ── __construct() ────────────────────────────────────────────────────────
public function test_construct_with_explicit_data(): void
{
$request = new Request(['op' => 'list', 'limit' => '20']);
$this->assertEquals('list', $request->getString('op'));
$this->assertEquals(20, $request->getInt('limit'));
}
public function test_construct_with_null_data(): void
{
$request = new Request(null);
$this->assertEquals('', $request->getString('missing'));
}
// ── from() / fromPost() / fromGet() / fromRequest() ─────────────────────
public function test_from_set_source_to_post(): void
{
$_GET = ['op' => 'list'];
$_POST = ['op' => 'post-op'];
$request = new Request();
$request->from(Request::SOURCE_POST);
$this->assertEquals('post-op', $request->getString('op'));
}
public function test_from_set_source_to_get(): void
{
$_GET = ['op' => 'get-op'];
$_POST = ['op' => 'post-op'];
$request = new Request();
$request->from(Request::SOURCE_GET);
$this->assertEquals('get-op', $request->getString('op'));
}
public function test_from_set_source_to_request(): void
{
$_REQUEST = ['op' => 'request-op'];
$request = new Request();
$request->from(Request::SOURCE_REQUEST);
$this->assertEquals('request-op', $request->getString('op'));
}
public function test_from_returns_self_for_chaining(): void
{
$request = new Request();
$this->assertSame($request, $request->from(Request::SOURCE_POST));
}
public function test_from_post_returns_self(): void
{
$_POST = ['op' => 'post-op'];
$request = new Request();
$this->assertSame($request, $request->fromPost());
}
public function test_from_get_returns_self(): void
{
$_GET = ['op' => 'get-op'];
$request = new Request();
$this->assertSame($request, $request->fromGet());
}
public function test_from_request_returns_self(): void
{
$_REQUEST = ['op' => 'request-op'];
$request = new Request();
$this->assertSame($request, $request->fromRequest());
}
// ── fromBody() ──────────────────────────────────────────────────────────
public function test_from_body_json_decodes(): void
{
$_SERVER['CONTENT_TYPE'] = 'application/json';
// Use constructor data so getRaw works without php://input
$request = new Request(['name' => 'json-value']);
$request->from(Request::SOURCE_BODY);
// Body is empty since php://input is not available, but
// the method should not throw and returns $this.
$this->assertEquals([], $request->all());
}
public function test_from_body_returns_self(): void
{
$_SERVER['CONTENT_TYPE'] = 'application/json';
$request = new Request();
$this->assertSame($request, $request->fromBody());
}
public function test_from_body_is_idempotent(): void
{
$_SERVER['CONTENT_TYPE'] = 'application/json';
$request = new Request();
$request->fromBody();
$request->fromBody();
// Should not double-read php://input; no exception = success
$this->expectNotToPerformAssertions();
}
// ── getString() ──────────────────────────────────────────────────────────
public function test_get_string_returns_value(): void
{
$_REQUEST = ['name' => 'hello'];
$request = new Request();
$this->assertEquals('hello', $request->getString('name'));
}
public function test_get_string_returns_default_when_missing(): void
{
$_REQUEST = [];
$request = new Request();
$this->assertEquals('default', $request->getString('missing', 'default'));
}
public function test_get_string_sanitizes_input(): void
{
$_REQUEST = ['html' => ''];
$request = new Request();
$this->assertEquals('alert(1)', $request->getString('html'));
}
public function test_get_string_handles_numeric_value(): void
{
$_REQUEST = ['count' => '42'];
$request = new Request();
$this->assertEquals('42', $request->getString('count'));
}
public function test_get_string_with_explicit_data(): void
{
$request = new Request(['name' => 'from-data']);
$this->assertEquals('from-data', $request->getString('name'));
}
// ── getInt() ─────────────────────────────────────────────────────────────
public function test_get_int_returns_value(): void
{
$_REQUEST = ['page' => '3'];
$request = new Request();
$this->assertEquals(3, $request->getInt('page'));
}
public function test_get_int_returns_default_when_missing(): void
{
$_REQUEST = [];
$request = new Request();
$this->assertEquals(10, $request->getInt('page', 10));
}
public function test_get_int_handles_non_numeric_string(): void
{
$_REQUEST = ['page' => 'abc'];
$request = new Request();
$this->assertEquals(0, $request->getInt('page'));
}
public function test_get_int_with_explicit_data(): void
{
$request = new Request(['count' => '7']);
$this->assertEquals(7, $request->getInt('count'));
}
// ── getFloat() ───────────────────────────────────────────────────────────
public function test_get_float_returns_value(): void
{
$_REQUEST = ['price' => '19.99'];
$request = new Request();
$this->assertEquals(19.99, $request->getFloat('price'));
}
public function test_get_float_returns_default_when_missing(): void
{
$_REQUEST = [];
$request = new Request();
$this->assertEquals(0.5, $request->getFloat('price', 0.5));
}
public function test_get_float_handles_non_numeric_string(): void
{
$_REQUEST = ['price' => 'free'];
$request = new Request();
$this->assertEquals(0.0, $request->getFloat('price'));
}
public function test_get_float_with_explicit_data(): void
{
$request = new Request(['weight' => '3.14']);
$this->assertEquals(3.14, $request->getFloat('weight'));
}
// ── getBool() ────────────────────────────────────────────────────────────
public function test_get_bool_true_from_string_one(): void
{
$_REQUEST = ['flag' => '1'];
$request = new Request();
$this->assertTrue($request->getBool('flag'));
}
public function test_get_bool_true_from_string_true(): void
{
$_REQUEST = ['flag' => 'true'];
$request = new Request();
$this->assertTrue($request->getBool('flag'));
}
public function test_get_bool_true_from_string_t(): void
{
$_REQUEST = ['flag' => 't'];
$request = new Request();
$this->assertTrue($request->getBool('flag'));
}
public function test_get_bool_true_from_string_on(): void
{
$_REQUEST = ['flag' => 'on'];
$request = new Request();
$this->assertTrue($request->getBool('flag'));
}
public function test_get_bool_false_from_non_matching_string(): void
{
$_REQUEST = ['flag' => '42'];
$request = new Request();
// '42' is a string, not in the truthy string list ['1','true','t','on']
$this->assertFalse($request->getBool('flag'));
}
public function test_get_bool_false_from_string_zero(): void
{
$_REQUEST = ['flag' => '0'];
$request = new Request();
$this->assertFalse($request->getBool('flag'));
}
public function test_get_bool_false_from_string_false(): void
{
$_REQUEST = ['flag' => 'false'];
$request = new Request();
$this->assertFalse($request->getBool('flag'));
}
public function test_get_bool_false_from_empty_string(): void
{
$_REQUEST = ['flag' => ''];
$request = new Request();
$this->assertFalse($request->getBool('flag'));
}
public function test_get_bool_returns_default_when_missing(): void
{
$_REQUEST = [];
$request = new Request();
$this->assertTrue($request->getBool('flag', true));
$this->assertFalse($request->getBool('flag', false));
}
public function test_get_bool_with_explicit_data(): void
{
$request = new Request(['active' => '1']);
$this->assertTrue($request->getBool('active'));
}
// ── getArray() ───────────────────────────────────────────────────────────
public function test_get_array_returns_array_value(): void
{
$_REQUEST = ['ids' => [1, 2, 3]];
$request = new Request();
$result = $request->getArray('ids');
$this->assertCount(3, $result);
$this->assertEquals(1, $result[0]);
$this->assertEquals(2, $result[1]);
$this->assertEquals(3, $result[2]);
}
public function test_get_array_returns_default_when_missing(): void
{
$_GET = [];
$request = new Request();
$this->assertEquals(['x', 'y'], $request->getArray('ids', ['x', 'y']));
}
public function test_get_array_splits_comma_separated_string(): void
{
$_REQUEST = ['ids' => '1,2,3'];
$request = new Request();
$this->assertEquals(['1', '2', '3'], $request->getArray('ids'));
}
public function test_get_array_trims_comma_separated_values(): void
{
$_REQUEST = ['ids' => '1, 2 , 3'];
$request = new Request();
$this->assertEquals(['1', '2', '3'], $request->getArray('ids'));
}
public function test_get_array_handles_empty_string(): void
{
$_GET = ['ids' => ''];
$request = new Request();
$this->assertEquals([], $request->getArray('ids'));
}
public function test_get_array_with_explicit_data(): void
{
$request = new Request(['tags' => ['a', 'b']]);
$this->assertEquals(['a', 'b'], $request->getArray('tags'));
}
// ── getRaw() ─────────────────────────────────────────────────────────────
public function test_get_raw_from_post(): void
{
$_POST = ['op' => 'login'];
$request = new Request();
$request->fromPost();
$this->assertEquals('login', $request->getRaw('op'));
}
public function test_get_raw_from_get(): void
{
$_GET = ['id' => '42'];
$request = new Request();
$request->fromGet();
$this->assertEquals('42', $request->getRaw('id'));
}
public function test_get_raw_from_request(): void
{
$_REQUEST = ['name' => 'alice'];
$request = new Request();
$this->assertEquals('alice', $request->getRaw('name'));
}
public function test_get_raw_from_explicit_data(): void
{
$request = new Request(['key' => 'val']);
$this->assertEquals('val', $request->getRaw('key'));
}
public function test_get_raw_returns_null_when_missing(): void
{
$_GET = [];
$request = new Request();
$this->assertNull($request->getRaw('missing'));
}
// ── has() ────────────────────────────────────────────────────────────────
public function test_has_returns_true_for_existing_key_in_request(): void
{
$_REQUEST = ['op' => 'list'];
$request = new Request();
$this->assertTrue($request->has('op'));
}
public function test_has_returns_false_for_missing_key(): void
{
$_REQUEST = ['op' => 'list'];
$request = new Request();
$this->assertFalse($request->has('missing'));
}
public function test_has_from_post(): void
{
$_POST = ['username' => 'admin'];
$request = new Request();
$request->fromPost();
$this->assertTrue($request->has('username'));
$this->assertFalse($request->has('password'));
}
public function test_has_from_get(): void
{
$_GET = ['page' => '1'];
$request = new Request();
$request->fromGet();
$this->assertTrue($request->has('page'));
}
public function test_has_with_explicit_data(): void
{
$request = new Request(['key' => 'val']);
$this->assertTrue($request->has('key'));
$this->assertFalse($request->has('other'));
}
// ── all() ────────────────────────────────────────────────────────────────
public function test_all_returns_all_request_params(): void
{
$_REQUEST = ['op' => 'list', 'page' => '2'];
$request = new Request();
$this->assertEquals(['op' => 'list', 'page' => '2'], $request->all());
}
public function test_all_from_post(): void
{
$_POST = ['user' => 'admin', 'pass' => 'secret'];
$request = new Request();
$request->fromPost();
$this->assertEquals(['user' => 'admin', 'pass' => 'secret'], $request->all());
}
public function test_all_from_get(): void
{
$_GET = ['q' => 'search'];
$request = new Request();
$request->fromGet();
$this->assertEquals(['q' => 'search'], $request->all());
}
public function test_all_from_body_returns_empty_when_not_called(): void
{
$request = new Request();
$request->from(Request::SOURCE_BODY);
$this->assertEquals([], $request->all());
}
public function test_all_with_explicit_data(): void
{
$request = new Request(['a' => 1, 'b' => 2]);
$this->assertEquals(['a' => 1, 'b' => 2], $request->all());
}
// ── only() ───────────────────────────────────────────────────────────────
public function test_only_returns_subset(): void
{
$_REQUEST = ['op' => 'list', 'page' => '1', 'limit' => '20'];
$request = new Request();
$result = $request->only(['op', 'limit']);
$this->assertCount(2, $result);
$this->assertEquals('list', $result['op']);
$this->assertEquals('20', $result['limit']);
}
public function test_only_includes_null_for_missing_keys(): void
{
$_REQUEST = ['op' => 'list'];
$request = new Request();
$result = $request->only(['op', 'missing']);
$this->assertEquals(['op' => 'list', 'missing' => null], $result);
}
public function test_only_with_explicit_data(): void
{
$request = new Request(['a' => 1, 'b' => 2, 'c' => 3]);
$result = $request->only(['a', 'c']);
$this->assertEquals(['a' => 1, 'c' => 3], $result);
}
// ── _to_bool() static ────────────────────────────────────────────────────
public function test_to_bool_true_values(): void
{
$this->assertTrue(Request::_to_bool(true));
$this->assertTrue(Request::_to_bool(1));
$this->assertTrue(Request::_to_bool(1.0));
$this->assertTrue(Request::_to_bool('1'));
$this->assertTrue(Request::_to_bool('true'));
$this->assertTrue(Request::_to_bool('t'));
$this->assertTrue(Request::_to_bool('on'));
$this->assertTrue(Request::_to_bool(42));
$this->assertTrue(Request::_to_bool(3.14));
}
public function test_to_bool_false_values(): void
{
$this->assertFalse(Request::_to_bool(false));
$this->assertFalse(Request::_to_bool(0));
$this->assertFalse(Request::_to_bool(0.0));
$this->assertFalse(Request::_to_bool('0'));
$this->assertFalse(Request::_to_bool('false'));
$this->assertFalse(Request::_to_bool(''));
$this->assertFalse(Request::_to_bool(null));
}
public function test_to_bool_handles_sanitization(): void
{
// clean() strips tags; '' → '1' → true
$this->assertTrue(Request::_to_bool(''));
}
public function test_to_bool_case_insensitive(): void
{
$this->assertTrue(Request::_to_bool('TRUE'));
$this->assertTrue(Request::_to_bool('True'));
$this->assertTrue(Request::_to_bool('ON'));
$this->assertTrue(Request::_to_bool('On'));
}
public function test_to_bool_with_array_fallback(): void
{
// Non-string, non-int, non-float, non-bool: falls through to (bool)
$this->assertTrue(Request::_to_bool(['anything']));
$this->assertFalse(Request::_to_bool([]));
}
}