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,103 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace Camelia\Controllers\Tests\Unit\Security;
|
||||
|
||||
use Camelia\Controllers\JsonRequest;
|
||||
use Camelia\Controllers\Request;
|
||||
use Camelia\Controllers\Response;
|
||||
use Camelia\Controllers\Security\RequireRole;
|
||||
use PHPUnit\Framework\TestCase;
|
||||
|
||||
final class RequireRoleTest extends TestCase
|
||||
{
|
||||
private static function passThrough(Request $request): Response
|
||||
{
|
||||
return new Response(['ok' => true]);
|
||||
}
|
||||
|
||||
private static function withUser(mixed $user): Request
|
||||
{
|
||||
return (new JsonRequest())->withAttribute('user', $user);
|
||||
}
|
||||
|
||||
public function testNoIdentityIs401(): void
|
||||
{
|
||||
$response = (new RequireRole(['admin']))->process(
|
||||
new JsonRequest(),
|
||||
self::passThrough(...),
|
||||
);
|
||||
|
||||
self::assertSame(401, $response->status());
|
||||
self::assertStringContainsString(
|
||||
'Authentication is required',
|
||||
$response->body()['message'],
|
||||
);
|
||||
}
|
||||
|
||||
public function testMissingRoleIs401(): void
|
||||
{
|
||||
$middleware = new RequireRole(['admin']);
|
||||
|
||||
$response = $middleware->process(
|
||||
self::withUser(['id' => 1, 'roles' => ['vendedor']]),
|
||||
self::passThrough(...),
|
||||
);
|
||||
|
||||
self::assertSame(401, $response->status());
|
||||
self::assertStringContainsString('admin', $response->body()['message']);
|
||||
}
|
||||
|
||||
public function testGrantedRolePasses(): void
|
||||
{
|
||||
$middleware = new RequireRole(['admin', 'gerente']);
|
||||
|
||||
$response = $middleware->process(
|
||||
self::withUser(['id' => 1, 'roles' => ['gerente']]),
|
||||
self::passThrough(...),
|
||||
);
|
||||
|
||||
self::assertSame(200, $response->status());
|
||||
}
|
||||
|
||||
public function testSingleRoleStringIsAccepted(): void
|
||||
{
|
||||
$middleware = new RequireRole(['admin']);
|
||||
|
||||
$response = $middleware->process(
|
||||
self::withUser(['role' => 'admin']),
|
||||
self::passThrough(...),
|
||||
);
|
||||
|
||||
self::assertSame(200, $response->status());
|
||||
}
|
||||
|
||||
public function testMalformedRolesFailClosed(): void
|
||||
{
|
||||
$middleware = new RequireRole(['admin']);
|
||||
|
||||
$response = $middleware->process(
|
||||
self::withUser(['roles' => 'admin']),
|
||||
self::passThrough(...),
|
||||
);
|
||||
|
||||
// A string is a valid single role; the point is that no exception escapes.
|
||||
self::assertSame(200, $response->status());
|
||||
|
||||
$broken = $middleware->process(
|
||||
self::withUser(['roles' => [42, null]]),
|
||||
self::passThrough(...),
|
||||
);
|
||||
self::assertSame(401, $broken->status());
|
||||
}
|
||||
|
||||
public function testIdentityMustBeArray(): void
|
||||
{
|
||||
$middleware = new RequireRole(['admin']);
|
||||
|
||||
$response = $middleware->process(self::withUser('admin'), self::passThrough(...));
|
||||
|
||||
self::assertSame(401, $response->status());
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user