English | 中文文档
SuperKernel is a component-oriented PHP framework for long-running Swoole applications. Each component is an independent Composer package under super-kernel/*, built on native PHP attributes, a PSR-11 container, and standard PSR interfaces.
Note
SuperKernel is in its release candidate stage and has no stable release yet. The components and SKERNEL are released together under one version number as 1.0.0-rc.N pre-releases. The contracts are frozen; only fixes land before 1.0.0. Each repository's main branch is the current development line.
- Swoole runtime: server startup, main-process supervision, attribute-driven HTTP serving, background processes, and connection pools on
ext-swoole. - Build before run: SKERNEL collects a project's packages, classes, and attributes when it builds the project, and the application restores that metadata at start instead of scanning.
- Dependency injection: a PSR-11 shared-service container with constructor autowiring, typed lazy configuration, and strict typed environment access.
- Aspect-oriented programming: aspect declarations, method weaving, join points, and interceptor dispatch on top of source transformation with hash-validated file proxies.
- PSR interoperability: PSR-3 logging, PSR-7 HTTP messages, PSR-11 containers, PSR-14 events, and PSR-15 request handlers and middleware.
- Console: a Symfony Console application runtime with lazy command registration.
- PHP
>=8.4.27 <8.5 ext-swoole >=6.2.3 <6.3for the Swoole-based components:http-server,pool,process,server,skeleton, andswooleext-redis >=6.3.0 <6.4forredis- Linux; some components also require
ext-pcntl,ext-posix, orext-sockets. Each repository'scomposer.jsonlists its exact requirements.
| Area | Component | Description |
|---|---|---|
| Application | skeleton | Composer project template for new applications. |
| Application | framework | Symfony Console application runtime and PSR-14 dispatcher adaptation. |
| Application | context | Application container and transparent execution-scope context. |
| Application | command | Lazy Symfony Console command registration. |
| Application | event | Application startup event declaration. |
| Application | event-dispatcher | PSR-14 event dispatching with native Attribute listener discovery. |
| Application | exception-dispatcher | Attribute-driven exception handler discovery and dispatch. |
| Container | di | PSR-11 shared-service container with constructor autowiring. |
| Container | config | Typed lazy configuration source registry. |
| Container | environment | Ordered external property sources and strict typed environment access. |
| Container | contract | Shared interface-only application, infrastructure, reflection, and event contracts. |
| Container | support | Dependency-free namespaced helpers for caller-owned short-lived instances. |
| Attributes | attribute | Native PHP Attribute contracts for configuration, DI, events, and third-party integrations. |
| Attributes | annotator | Restoration and lookup of build-generated PHP attribute records. |
| Attributes | reflector | Process-local cached native reflection service. |
| Attributes | metadata | Read-only restoration of build-generated package metadata. |
| Attributes | autoloader | Factory-bootstrapped classmap autoloading and interception. |
| Attributes | composer-source-reference-plugin | Deterministic source references for Composer path packages. |
| AOP | aop | Aspect declarations, method weaving, join points, and interceptor dispatch through Mimic. |
| AOP | mimic | Source preparation with pluggable transformations, source-hash-validated file proxies, and stream fallback. |
| Swoole | server | Creation and startup of the configured Swoole server, events for its creation and callbacks, and user processes. |
| Swoole | swoole | Swoole console commands and main process supervision. |
| Swoole | http-server | Attribute-driven HTTP routing, middleware, and Swoole integration. |
| Swoole | http-message | PSR-7 messages and scoped HTTP message access. |
| Swoole | process | Background process supervision and direct IPC. |
| Swoole | pool | Connection pools with coroutine, process, and thread coordination. |
| Integrations | logger | Monolog-backed PSR-3 logger factories and named stdout logging. |
| Integrations | redis | Redis integration. |
| Integrations | filesystem | Lifecycle-safe readable filesystem resource abstractions. |
SuperKernel's tools live in the super-kernel-tools organization.
| Tool | Description |
|---|---|
| skernel | Command-line project tool for SuperKernel applications: it creates, runs, builds, and packages a project. Published as a standalone binary through GitHub Releases for Linux and macOS; it needs no PHP. |
The developer documentation has a getting-started guide, a guide to building and build metadata, and one page per component with complete examples.
Each component is published here as an individual repository, and each tool in the super-kernel-tools organization. Repositories here without a current component are archived.
Every component and tool is released under the MIT License. AOP and Mimic also include a NOTICE file with their source attribution.