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:
commit
341d1bdc2c
52 files changed
+7552
No files matched your search
@@ -0,0 +1,99 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace Camelia\Controllers\Tests\Unit;
|
||||
|
||||
use Camelia\Controllers\JsonRequest;
|
||||
use Camelia\Controllers\Middleware;
|
||||
use Camelia\Controllers\Pipeline;
|
||||
use Camelia\Controllers\Request;
|
||||
use Camelia\Controllers\Response;
|
||||
use PHPUnit\Framework\TestCase;
|
||||
|
||||
final class PipelineTest extends TestCase
|
||||
{
|
||||
public function testRunsHandlerWhenEmpty(): void
|
||||
{
|
||||
$pipeline = new Pipeline();
|
||||
|
||||
$response = $pipeline->process(
|
||||
new JsonRequest(),
|
||||
static fn(): Response => new Response(['ok' => true]),
|
||||
);
|
||||
|
||||
self::assertSame(['ok' => true], $response->body());
|
||||
self::assertTrue($pipeline->isEmpty());
|
||||
}
|
||||
|
||||
public function testRunsMiddlewaresOutsideIn(): void
|
||||
{
|
||||
$order = [];
|
||||
$first = new Recorder('first', $order);
|
||||
$second = new Recorder('second', $order);
|
||||
|
||||
$pipeline = new Pipeline([$first, $second]);
|
||||
$pipeline->process(new JsonRequest(), static function (Request $request) use (
|
||||
&$order,
|
||||
): Response {
|
||||
$order[] = 'handler';
|
||||
|
||||
return new Response(null);
|
||||
});
|
||||
|
||||
self::assertSame(
|
||||
['first:before', 'second:before', 'handler', 'second:after', 'first:after'],
|
||||
$order,
|
||||
);
|
||||
}
|
||||
|
||||
public function testMiddlewareCanShortCircuit(): void
|
||||
{
|
||||
$blocked = new class implements Middleware {
|
||||
public function process(Request $request, callable $next): Response
|
||||
{
|
||||
return new Response(['blocked' => true], 403);
|
||||
}
|
||||
};
|
||||
|
||||
$pipeline = new Pipeline([$blocked]);
|
||||
$response = $pipeline->process(new JsonRequest(), static function (): Response {
|
||||
self::fail('The handler must not run when a middleware short-circuits.');
|
||||
});
|
||||
|
||||
self::assertSame(403, $response->status());
|
||||
}
|
||||
|
||||
public function testWithReturnsCopy(): void
|
||||
{
|
||||
$order = [];
|
||||
$base = new Pipeline();
|
||||
$withOne = $base->with(new Recorder('x', $order));
|
||||
|
||||
self::assertTrue($base->isEmpty());
|
||||
self::assertCount(1, $withOne->middlewares());
|
||||
}
|
||||
}
|
||||
|
||||
final class Recorder implements Middleware
|
||||
{
|
||||
/**
|
||||
* The array is shared by reference with the test, so appending to it is the only operation.
|
||||
*
|
||||
* @param list<string> $order Passed by reference so the test observes the shared log.
|
||||
*/
|
||||
public function __construct(
|
||||
private readonly string $name,
|
||||
/** @phpstan-ignore property.onlyWritten */
|
||||
private array &$order,
|
||||
) {}
|
||||
|
||||
public function process(Request $request, callable $next): Response
|
||||
{
|
||||
$this->order[] = $this->name . ':before';
|
||||
$response = $next($request);
|
||||
$this->order[] = $this->name . ':after';
|
||||
|
||||
return $response;
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user