README

 __    __     __     ______   __  __     ______     __     __        
/\ "-./  \   /\ \   /\__  _\ /\ \_\ \   /\  == \   /\ \   /\ \       
\ \ \-./\ \  \ \ \  \/_/\ \/ \ \  __ \  \ \  __<   \ \ \  \ \ \____  
 \ \_\ \ \_\  \ \_\    \ \_\  \ \_\ \_\  \ \_\ \_\  \ \_\  \ \_____\ 
  \/_/  \/_/   \/_/     \/_/   \/_/\/_/   \/_/ /_/   \/_/   \/_____/ PHP

MithrilPHP

MithrilPHP is a lightweight and resilient PHP engine designed to silently protect applications.
Invisible by design, it provides a solid runtime foundation without imposing architectural decisions.

🎯 Purpose

MithrilPHP exists to be the engine behind frameworks, not the framework itself.

It provides the essential building blocks required to execute applications reliably, while remaining lightweight, explicit, and opinion-free.

🛡️ Design Philosophy

Inspired by the Mithril worn by Frodo, MithrilPHP follows a simple principle:

You should not feel it — until it saves you.

The core protects execution, not business logic
The domain remains sovereign
The engine absorbs impact without dictating structure

⚙️ What MithrilPHP Is

A core runtime engine
A foundation for frameworks
A silent execution layer
A console and HTTP backbone

❌ What MithrilPHP Is Not

A full framework
A project skeleton
An MVC solution
A DDD or Clean Architecture implementation

Those responsibilities belong to frameworks built on top of MithrilPHP.

🔧 Core Responsibilities

HTTP Kernel and routing execution
Console Kernel and command execution
Dependency Injection container
Environment variable access
Configuration loading
Low-level abstractions required by frameworks

🪓 Ecosystem

MithrilPHP is designed to power opinionated frameworks.

The first official implementation is:

Durin’s Forge — a framework that forges real applications on top of MithrilPHP

📦 Installation

composer require ereborcodeforge/mithrilphp

---

![Forge CLI Preview](docs/images/image.png)

*Forged by EreborCodeForgee*

ereborcodeforge / mithrilphp

Maintainers

Details