feat: initial commit of camelia/controllers

Framework-agnostic REST controller toolkit in vanilla PHP.

- Router with path parameters, 404 and 405 with an Allow header.
- Immutable Request, JsonRequest and Response; nothing is printed.
- CrudController over a ResourceGateway port the application implements.
- Composable Middleware/Pipeline chain.
- Security middlewares: BearerAuth, RequireRole, RateLimit, Cors.
- Transport middlewares: Logging, ContentNegotiation.
- Nine typed HTTP exceptions with snake_case JSON bodies.
- Declares PHP >=8.3 and no dependency on an ORM: ports are local.
- MIT license.
This commit is contained in:
dgarcia committed 2026-11-15 10:14:27 -03:00
commit 341d1bdc2c
52 files changed
+7552

No files matched your search

@@ -0,0 +1,113 @@
<?php
declare(strict_types=1);
namespace Camelia\Controllers\Tests\Unit\Middleware;
use Camelia\Controllers\JsonRequest;
use Camelia\Controllers\Middleware\ContentNegotiation;
use Camelia\Controllers\Request;
use Camelia\Controllers\Response;
use PHPUnit\Framework\TestCase;
final class ContentNegotiationTest extends TestCase
{
private static function ok(Request $request): Response
{
return new Response(['ok' => true]);
}
public function testAddsContentType(): void
{
$response = (new ContentNegotiation())->process(new JsonRequest(), self::ok(...));
self::assertSame(200, $response->status());
self::assertSame('application/json; charset=utf-8', $response->headers()['Content-Type']);
}
public function testMissingAcceptHeaderIsAccepted(): void
{
$response = (new ContentNegotiation())->process(new JsonRequest(), self::ok(...));
self::assertSame(200, $response->status());
}
public function testJsonAcceptIsAccepted(): void
{
$response = (new ContentNegotiation())->process(
new JsonRequest(headers: ['accept' => 'application/json']),
self::ok(...),
);
self::assertSame(200, $response->status());
}
public function testBrowserAcceptIsAccepted(): void
{
$accept = 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8';
$response = (new ContentNegotiation())->process(
new JsonRequest(headers: ['accept' => $accept]),
self::ok(...),
);
self::assertSame(200, $response->status());
}
public function testIncompatibleAcceptIs406(): void
{
$response = (new ContentNegotiation())->process(
new JsonRequest(headers: ['accept' => 'application/xml']),
static function (): Response {
self::fail('The handler must not run when the client rejects JSON.');
},
);
self::assertSame(406, $response->status());
self::assertSame('not_acceptable', $response->body()['code']);
}
public function testZeroQualityIsRejected(): void
{
$response = (new ContentNegotiation())->process(
new JsonRequest(headers: ['accept' => 'application/json;q=0']),
static function (): Response {
self::fail('A q=0 entry means not acceptable.');
},
);
self::assertSame(406, $response->status());
}
public function testNonZeroQualityIsAccepted(): void
{
$response = (new ContentNegotiation())->process(
new JsonRequest(headers: ['accept' => 'application/json;q=0.5']),
self::ok(...),
);
self::assertSame(200, $response->status());
}
public function testExistingContentTypeIsPreserved(): void
{
$response = (new ContentNegotiation())->process(
new JsonRequest(),
static fn(): Response => new Response(['ok' => true], 200, [
'Content-Type' => 'application/problem+json',
]),
);
self::assertSame('application/problem+json', $response->headers()['Content-Type']);
}
public function testContentTypeCanBeDisabled(): void
{
$response = (new ContentNegotiation(addContentType: false))->process(
new JsonRequest(),
self::ok(...),
);
self::assertFalse($response->hasHeader('Content-Type'));
}
}