Kinetis#

Persistent Workers, Non-Blocking I/O.

Optimized for long-running processes, but equally snappy on PHP-FPM and serverless environments. One codebase — any runtime.

  • Typed requests and responses.

  • OpenAPI generated from your code rather than maintained beside it.

  • Request-level concurrency over non-blocking I/O.

  • Native Model Context Protocol (MCP) server, one install away.

  • Orbitron, a development harness that equips the AI coding agent you already use.

How Kinetis works#

Discovered, not registered

Controllers, console commands, event listeners, global middleware, and MCP tools are found by their attributes anywhere under your own namespace. There is no provider class, route file, or listener map to keep in step with the code.

Compiled for production

Development discovers from source on every boot. kinetis build compiles the result into one .kinetis-cache/compiled.php artifact in the deploy step, so a production boot reads a file instead of scanning code. See Caching & AOT Compilation.

Safe in a long-running process

Application services come from the container, application-scoped or created fresh for each request. Configuration is typed and read once at boot. Three bundled PHPStan rules flag the mistakes that break a persistent worker: a static property (Appendix: Container Lifecycle), a call that blocks the event loop (Concurrency), and a reach into superglobals or the SAPI (Process and SAPI globals).

A small core, opt-in packages

The framework holds the runtime-neutral core. Databases, queues, auth, storage, search, and runtime adapters are separate packages you install when you need them, and the framework depends on none of them.

What you get#

Write an endpoint, get the rest

  • Routes, request binding, and validation declared with native PHP attributes — no YAML, no XML, no config file to keep in step with the code.

  • Typed DTOs in and out. A malformed request is an RFC 9457 422 carrying every violation at once, before your controller runs.

  • OpenAPI 3.1 and a Swagger UI generated from the same attributes. Nothing to write, nothing to update.

True request-level concurrency

  • Real concurrency on PHP Fibers: run four queries, an HTTP call, and a cache read side by side and wait once.

  • Native MySQL, MariaDB, and Postgres drivers that suspend instead of blocking, with connection pooling and TLS.

  • A Revolt-native HTTP client, Redis (cluster) client, and filesystem layer, so nothing in the request path quietly blocks the others.

More functionality in separate packages

  • Data — a fluent query builder with pagination, database migrations, and request-scoped transaction safety.

  • Background work — queues on Redis, SQL, Amazon SQS, or RabbitMQ, with retries, delays, priorities, graceful shutdown, and failed jobs kept for retry.

  • Auth — bearer tokens or JWT, refresh tokens, and per-token revocation.

  • Web essentials — sessions with CSRF protection, rate limiting, CORS, security headers, and a body-size cap, all opt-in middleware.

  • Infrastructure — file storage on local disk or S3, mail, OpenSearch, AWS request signing, and OpenTelemetry tracing that spans your queue workers too.

Built for agents, not adapted for them

  • A native Model Context Protocol server (kinetis/mcp), over stdio or HTTP — installing the package is the whole setup.

  • Tools and resources declared with attributes and validated exactly like HTTP routes — one definition, two audiences.

  • Orbitron (kinetis/orbitron), the development-only harness that hands your own coding agent this project’s Kinetis context, its installed package inventory, a layout verification and one previewable scaffold — from a shell or, over MCP, also the exact source of any package this project has installed. See Orbitron.

  • These docs as MCP resources, whole, as bounded line windows or through a literal search of one page, so an agent reads the framework’s documentation instead of recalling it. Orbitron serves them on its own connection, and kinetis/mcp-docs — which owns the catalogue and the fetch — installs on its own for documentation without the harness. See MCP Documentation Server.

Long-running or classic, same code#

Kinetis targets FrankenPHP’s worker mode first: one warm process serving request after request. The same application code runs unchanged under classic nginx and PHP-FPM — on RoadRunner, and on AWS Lambda via Bref — because the runtime is an adapter Kinetis talks to, not an assumption baked into the framework. Deploy the way you deploy today, and move to a worker when it suits you.

Built to a standard you can check#

Every change runs through GitHub Actions before it merges: PHPUnit, PHPStan, Psalm with taint analysis, mutation testing via Infection, and integration tests against real MySQL, MariaDB, Postgres, Redis, RabbitMQ, and LocalStack rather than mocks. SonarQube Cloud rates the project A for security, reliability, and maintainability, with test coverage above 90%. The benchmarks are public and reproducible, infrastructure included.

Start here#

Tutorial

Start here. Install Kinetis, write a controller, then build a real-time application on it — a database, a queue, a scheduled command, live updates over a WebSocket, and a tool an AI agent can call.

Tutorial
Core Concepts

The runtime-agnostic Kernel, the request lifecycle, and why persistent workers change the rules.

Core Concepts
Routing & Validation

Attribute-based routes, typed DTOs, constraint validation, and zero-config OpenAPI.

Routing & Validation
Concurrency

Run a database query, an HTTP call, and a cache read side by side inside one request, instead of one after another.

Concurrency
Build it with an AI agent

Kinetis does not force every application through a generic dashboard or prebuilt scaffold. Orbitron instead equips the MCP-capable coding agent you already use with Kinetis context, project inspection, verification, controlled scaffolding and this documentation — one server to register, so it builds against the packages and versions actually installed. Orbitron contains no model — you bring the agent.

Orbitron