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 under active development and has not been released. The repositories carry no tagged releases,
no application template is published yet, and APIs may still change. 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. - Scan before run: attributes are collected in an isolated scan before the application starts, backed by Composer package metadata and cached class graphs.
- 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, 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 | 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 | Isolated package-aware PHP attribute collection. |
| Attributes | scan-isolation | Anonymous scan callback isolation. |
| Attributes | tokenizer | PHP class-like declaration tokenizer. |
| Attributes | reflector | Process-local cached native reflection service. |
| Attributes | composer | Composer package metadata and cached class graphs. |
| 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 | Swoole server startup services and console command. |
| 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. |
The components are developed together in one workspace and published here as individual repositories. Each main
branch starts from a snapshot commit of the current component. Where a repository existed before, its earlier
history is kept on the deprecated branch. Repositories without a current component are archived.
Every component is released under the MIT License.
AOP and Mimic also include a NOTICE file with their source attribution.
