dgarcia afcb2e8449
Tests / PHP 8.4 (push) Failing after 2m38s
build: replace .githooks with husky
2026-11-15 11:15:46 -03:00
2026-11-15 10:58:17 -03:00
2026-11-15 11:15:46 -03:00
2026-11-15 10:58:17 -03:00
2026-11-15 10:23:43 -03:00
2026-11-15 10:58:17 -03:00
2026-11-15 10:58:17 -03:00
2026-11-15 10:58:17 -03:00
2026-11-15 10:58:17 -03:00

camelia/controllers

Latest Stable Version Total Downloads License Tests

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, 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

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.

S
Description
No description provided
Readme MIT
157 KiB
0 Stars 1 Watchers 0 Forks
Languages
PHP 100%