php/docs/index.md at 87ae36ef220efc6628beed4ad63b4168d02770ad

core/php

Fork 0

Snider 28d004ff61

CI / PHP 8.4 (push) Failing after 1m54s

Details

CI / PHP 8.3 (push) Failing after 1m58s

Details

feat: replace Go CLI with PHP framework

Go CLI commands moved to core/go-php. This repo now contains
the Laravel modular monolith framework (previously php-framework).

- Remove all Go files (now in core/go-php)
- Add PHP framework: event-driven module loading, lifecycle events
- Composer package: core/php
- core/php-framework remains as-is for backward compat

Co-Authored-By: Virgil <virgil@lethean.io>

2026-03-06 08:49:51 +00:00

3.6 KiB

Raw Blame History

layout

hero

features

home

name

text

tagline

actions

Core PHP Framework

Modular Monolith for Laravel

Event-driven architecture with lazy module loading and built-in multi-tenancy

theme	text	link
brand	Get Started	/guide/getting-started

theme	text	link
alt	View on GitHub	https://github.com/host-uk/core-php

icon	title	details
⚡️	Event-Driven Modules	Modules declare interest in lifecycle events and are only loaded when needed, reducing overhead for unused features.

icon	title	details
🔒	Multi-Tenant Isolation	Automatic workspace scoping for Eloquent models with strict mode enforcement prevents data leakage.

icon	title	details
🎯	Actions Pattern	Extract business logic into testable, reusable classes with automatic dependency injection.

icon	title	details
📝	Activity Logging	Built-in audit trails for model changes with minimal setup using Spatie Activity Log.

icon	title	details
🌱	Seeder Auto-Discovery	Automatic seeder ordering via priority and dependency attributes eliminates manual registration.

icon	title	details
🎨	HLCRF Layouts	Data-driven composable layouts with infinite nesting for flexible UI structures.

icon	title	details
🔐	Security First	Bouncer action gates, request whitelisting, and comprehensive input sanitization.

icon	title	details
🚀	Production Ready	Battle-tested in production with comprehensive test coverage and security audits.

Quick Start

# Install via Composer
composer require host-uk/core

# Create a module
php artisan make:mod Commerce

# Register lifecycle events
class Boot
{
    public static array $listens = [
        WebRoutesRegistering::class => 'onWebRoutes',
    ];

    public function onWebRoutes(WebRoutesRegistering $event): void
    {
        $event->routes(fn () => require __DIR__.'/Routes/web.php');
    }
}

Why Core PHP?

Traditional Laravel applications grow into monoliths with tight coupling and unclear boundaries. Microservices add complexity you may not need. Core PHP provides a middle ground: a structured monolith with clear module boundaries, lazy loading, and the ability to extract services later if needed.

Key Benefits

Reduced Complexity - No network overhead, distributed tracing, or service mesh
Clear Boundaries - Modules have explicit dependencies via lifecycle events
Performance - Lazy loading means unused modules aren't loaded
Flexibility - Start monolithic, extract services when it makes sense
Type Safety - Full IDE support with no RPC serialization