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,50 @@
|
||||
# camelia/controllers
|
||||
|
||||
Framework-agnostic REST controller toolkit: routing, request parsing, validation and JSON responses
|
||||
over any data source. Vanilla PHP, no framework.
|
||||
|
||||
- **Package:** `camelia/controllers` — **Namespace:** `Camelia\Controllers`
|
||||
- **PHP** `>=8.3`, extension `json`
|
||||
|
||||
## What it is
|
||||
|
||||
The HTTP layer of a REST API, and nothing else:
|
||||
|
||||
- **Routing** with parameters (`/articulos/{id}`), plus 404 and 405 responses with an `Allow` header.
|
||||
- **Immutable request and response** objects. Nothing is printed; a `Response` is returned and the
|
||||
adapter emits it.
|
||||
- **Generic CRUD** over a `ResourceGateway` port that the application implements.
|
||||
- **Composable middlewares:** authentication, roles, rate limiting, CORS, logging, content
|
||||
negotiation.
|
||||
|
||||
## What it is not
|
||||
|
||||
Not a framework. No dependency-injection container, no ORM, no templating. The package declares its
|
||||
own ports; if an application uses an ORM, it connects it by composition.
|
||||
|
||||
## Install
|
||||
|
||||
```bash
|
||||
composer require camelia/controllers
|
||||
```
|
||||
|
||||
## Documentation
|
||||
|
||||
The full developer guide, organised by task, is in
|
||||
[`docs/GUIA-PROGRAMADOR.md`](docs/GUIA-PROGRAMADOR.md). The normative contract — public names, JSON
|
||||
shapes and status codes — is [`docs/especificaciones-controllers.md`](docs/especificaciones-controllers.md).
|
||||
|
||||
The documentation index lives in [`docs/README.md`](docs/README.md).
|
||||
|
||||
## Development
|
||||
|
||||
```bash
|
||||
composer install
|
||||
composer check # fmt:check -> lint -> analyze -> phpstan -> test
|
||||
```
|
||||
|
||||
`composer check` must be green before anything is merged, and the steps run in that order.
|
||||
|
||||
## License
|
||||
|
||||
MIT. See [LICENSE](LICENSE).
|
||||
Reference in new issue
Block a user