trueadmin/kernel

TrueAdmin reusable backend kernel package.

v0.1.12 2026-05-12 16:05 UTC

Requires

• php: >=8.1
• hyperf/command: ~3.1.0
• hyperf/config: ~3.1.0
• hyperf/constants: ~3.1.0
• hyperf/context: ~3.1.0
• hyperf/contract: ~3.1.0
• hyperf/database: ~3.1.0
• hyperf/db-connection: ~3.1.0
• hyperf/di: ~3.1.0
• hyperf/event: ~3.1.0
• hyperf/exception-handler: ~3.1.0
• hyperf/framework: ~3.1.0
• hyperf/http-server: ~3.1.0
• hyperf/logger: ~3.1.0
• hyperf/support: ~3.1.0
• hyperf/validation: ~3.1.0

MIT

Published on Packagist.org on 2026-05-12 16:06 UTC

README

Reusable backend kernel package for TrueAdmin.

This package contains backend primitives that are stable across projects: error codes, HTTP attributes, actor context, data-permission value objects, operation-log attributes, pagination/API envelope primitives, CRUD query protocol classes, and Hyperf runtime services that do not depend on host business tables.

Application-specific controllers, repositories, request classes, database resources, business services, and module/plugin facts stay in the template application or in each plugin.

The kernel is shared by Admin, Client, and Open entrypoints. End-specific authentication, permission policy, request validation, routing, menu resources, and database-backed implementations stay in the application or plugin that owns them.

CRUD Query Protocol

TrueAdmin\Kernel\Crud provides the standard backend representation of the list-query protocol:

• CrudQuery
• CrudFilterCondition
• CrudSortRule
• CrudOperator
• CrudSortOrder
• CrudQueryRequest

CrudQueryRequest parses the standard bracket query protocol into CrudQuery. It validates protocol shape only; resource-level field and operator allow-lists still belong to the application repository or query applier.

HTTP Primitives

The package also provides:

• TrueAdmin\Kernel\Http\Request\FormRequest
• TrueAdmin\Kernel\Http\ApiResponse
• TrueAdmin\Kernel\Pagination\PageResult

Projects can extend these classes or replace application-level bindings without modifying package source.

Hyperf Runtime Services

The package provides reusable runtime services for a TrueAdmin backend:

• Attribute route registration
• Interface metadata scanning and OpenAPI document generation
• Module/plugin migration and seeder path registration
• Backend plugin runtime config reading
• Module and plugin translation loading
• SSE / #[Streamable] response runtime

These services may depend on Hyperf, but they must not depend on Module/System tables or any application-specific business process.