the-firehub-project / kernel

dev-master 2026-10-13 10:27 UTC

Requires

• php: ^8.5

Requires (Dev)

• phpstan/phpstan: ^2.0
• the-firehub-project/phpstan-rules: dev-develop
• the-firehub-project/testing: dev-develop

Apache-2.0

• Danijel Galić

• framework
• php
• bootstrap
• dependency-injection
• kernel
• lifecycle
• firehub

Published on Packagist.org on 2026-10-13 11:01 UTC

README

The application kernel for the FireHub Framework, providing application bootstrapping, lifecycle management, and service orchestration. Designed as a shared, edition-agnostic runtime component for Standard, Professional, and Enterprise applications.

About FireHub

FireHub is a modular PHP framework built around:

• Clean Architecture
• Domain-Driven Design (DDD)
• Explicit boundaries between Core, Adapters, and Modules
• Long-term maintainability and scalability

FireHub is designed for building enterprise-grade PHP applications without sacrificing clarity or developer experience.

Repository Purpose

FireHub Kernel provides the application-level orchestration required to initialize, operate, and shut down FireHub applications consistently. It implements stable contracts defined by Core Standard and remains independent of edition-specific features.

Its responsibilities include:

• Application lifecycle — managing initialization, readiness, failure, and shutdown.
• Bootstrap orchestration — executing initialization steps in a controlled order.
• Service integration — coordinating service registration and initialization through explicit contracts.
• Configuration initialization — making application configuration available during startup.
• Module integration — coordinating optional modules and capabilities without hard-coded edition checks.
• Application context — providing the environment and state needed for application initialization.

The Kernel does not implement HTTP routing, console commands, business logic, or individual capability features. Those responsibilities belong to adapters, applications, and dedicated capability packages.

The same Kernel is used with all three FireHub editions. Core Standard is the minimum required edition; Professional and Enterprise extend the ecosystem through their own contracts and components, not separate Kernel implementations.

Security

For security reporting and guidelines, please refer to our SECURITY.md file.

Community

• Be sure to review the Code of Conduct.
• Read a Contributing file to see how you can contribute to this project.
• Read our Security policy file to see how you can report a vulnerability.
• Review the project Governance model, including roles, decision-making, RFC process, and releases.

Support

For help with FireHub products, please refer to the following resources:

• General questions & discussions: GitHub Discussions
• Bug reports & issues: Support
• Documentation & guides: FireHub Docs
• Commercial support (Pro/Enterprise): contact your account manager

Authors and Contributors

• Project authors can be found here.
• The full list of individual contributors can be found here.

Brand & Trademark

Please refer to TRADEMARK.md and BRAND.md for guidelines on FireHub branding.

Architecture guidelines, design principles, and ecosystem documentation are available within the FireHub Project organization.

License

This software is licensed under the Apache-2.0 License.

For more details, read the full license here.