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.4, extensionjson
What it is
The HTTP layer of a REST API, and nothing else:
- Routing with parameters (
/articulos/{id}), plus 404 and 405 responses with anAllowheader. - Immutable request and response objects. Nothing is printed; a
Responseis returned and the adapter emits it. - Generic CRUD over a
ResourceGatewayport 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
composer require camelia/controllers
Documentation
The full developer guide, organised by task, is in
docs/GUIA-PROGRAMADOR.md. The normative contract — public names, JSON
shapes and status codes — is docs/especificaciones-controllers.md.
The documentation index lives in docs/README.md.
Development
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.
The same gate runs on every commit once the hook is enabled per clone:
git config core.hooksPath .githooks
Use git commit --no-verify to bypass it for a single commit.
License
MIT. See LICENSE.