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 alpha stage and has no stable release yet. The components and SKERNEL are released together under one version number as 1.0.0-alpha.N pre-releases, and APIs may still change from one alpha to the next. 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. |
| 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 and tool is published here as an individual repository. Repositories without a current component or tool are archived.
Every component and tool is released under the MIT License. AOP and Mimic also include a NOTICE file with their source attribution.
