Download the PHP package kinetis/framework without Composer

The non-blocking PHP framework for API-first applications
Runs on persistent-worker runtimes, with AI agents as first-class API clients

This is the Kinetis framework itself, developed in the kinetis-dev/kinetis monorepo — every satellite package below is split out of that same monorepo into its own repository.

Kinetis targets the same class of application a modern API is expected to be: typed request and response contracts, OpenAPI described automatically rather than hand-maintained, non-blocking under concurrent load, and native support for AI agents as first-class API clients.

Attribute-driven routing and validation replace config files to keep in sync with the code:

Request-scope isolation is an enforced guarantee rather than a convention. Speed comes from two places: Fiber-based concurrency over a Revolt event loop, and ahead-of-time compilation (kinetis build) so a request in production pays reflection's cost once rather than on every request it serves.

Kinetis is designed around FrankenPHP's worker mode — a PHP process that boots once and serves thousands of requests — as its primary target, though the same application code also runs correctly under classic PHP-FPM, RoadRunner, and AWS Lambda (via Bref): the runtime is an adapter Kinetis talks to, not an assumption baked into the framework itself.

Highlights

• Runtime-adapter architecture — the same public/index.php runs unmodified under FrankenPHP, PHP-FPM, RoadRunner, or AWS Lambda; RuntimeDetector picks the right adapter with zero configuration.
• A two-tier container (AppScope + RequestScope) that makes request-scope isolation an enforced guarantee, not a convention — backed by a PHPStan rule that bans stray static state.
• Attribute-based routing, validation, and OpenAPI — typed DTOs validated before your controller ever runs, with a zero-config Swagger UI at /openapi. A route's where map decides which text a placeholder admits: where: ['page' => '.*'] lets {page} capture a path tail. See Route constraints.
• Fiber-based concurrency (Kinetis\Async\concurrently()) over Revolt, plus Revolt-native MySQL and Postgres drivers, and a Redis transport (kinetis/redis) that never replays a command it could not confirm.
• A native MCP server (kinetis/mcp) — stdio and Streamable HTTP transports, so an AI agent can call your application's own tools and resources the same way it calls anything else. Installing the package is the whole setup.
• A PSR-14 event dispatcher — attribute-driven listener registration, with ShouldQueue for deferring a listener onto a queue instead of running it inline. Core dispatches Kinetis\Console\Events\CommandFailed when a vendor/bin/kinetis command throws; see kinetis.dev/docs/events.html for the full list across every package.
• Production AOT caching — routes, validation plans, commands, and event listeners compiled once (bin/kinetis build). A boot-and-die runtime skips re-registering everything from scratch on every request; even a persistent worker skips the per-dispatch reflection cost that otherwise recurs on every single request regardless.

Installation

Requires PHP 8.4 or later. See the Tutorial for a complete walkthrough, including running under FrankenPHP.

Configuration

Core reads from the environment (or a .env file at the project root) via Kinetis\Config:

Running under FrankenPHP or PHP-FPM requires enable_post_data_reading=0 in the SAPI's php.ini. Kinetis reads and bounds the request body itself; left on, PHP parses form bodies before any Kinetis code runs, truncating them at its own limits and leaving php://input empty. The bridge refuses to serve a request without it rather than running on a body PHP already consumed — see Runtime Adapters.

Two more keys follow the *_DISCOVERY_PATHS convention without core reading either: MCP_DISCOVERY_PATHS (kinetis/mcp) and BROADCAST_CHANNEL_DISCOVERY_PATHS (kinetis/broadcasting).

Each package documents its own keys (DB_*, REDIS_*, QUEUE_*, ...) in its own README; the full reference across every package is at kinetis.dev/docs/config.html.

Packages

Kinetis core ships as kinetis/framework. The project's other libraries and runtime adapters are listed below. Each has its own dependencies, repository, and README:

Documentation

The full documentation is hosted at kinetis.dev/docs — start with the Tutorial or Core Concepts.

Development

Kinetis is built and tested through Docker; php and composer are never run on the host:

License

Kinetis is open-sourced under the MIT license.