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

+30
View File
@@ -0,0 +1,30 @@
<?php
declare(strict_types=1);
namespace Camelia\Controllers\Exception;
/**
* A failure with an HTTP status and a stable machine-readable code.
*
* The status and code are public contract: clients branch on them.
*/
abstract class HttpError extends ControllerException
{
abstract public function status(): int;
/** Stable snake_case identifier sent to the client, such as `not_found`. */
abstract public function errorCode(): string;
/** @return array<string, string> */
public function headers(): array
{
return [];
}
/** @return array<string, mixed> */
public function toArray(): array
{
return ['code' => $this->errorCode(), 'message' => $this->getMessage()];
}
}