memran/marwa-framework

MarwaPHP - A future‑proof, PSR‑compliant PHP framework core.Minimal, modular, and fast — with developer‑friendly APIs.

v1.4.5 2026-04-18 00:07 UTC

Requires

• php: ^8.2
• guzzlehttp/guzzle: ^7.9
• league/container: ^5.1
• league/flysystem: ^3.29
• league/flysystem-local: ^3.29
• matthiasmullie/scrapbook: ^1.5
• memran/marwa-db: ^1.2
• memran/marwa-debugbar: ^1.0
• memran/marwa-entity: ^1.1.0
• memran/marwa-error-handler: ^1.1
• memran/marwa-event: ^0.2
• memran/marwa-logger: ^1.0
• memran/marwa-module: ^1.0.1
• memran/marwa-router: ^1.3
• memran/marwa-support: ^1.3.1
• memran/marwa-view: ^1.0
• nesbot/carbon: ^3.10
• psr/event-dispatcher: ^1.0
• relay/relay: ^3.0
• symfony/console: ^7.3
• symfony/dotenv: ^7.3

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.89
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^11.5

Suggests

• memran/marwa-db: Optional database toolkit integration; console commands auto-register when available.
• memran/marwa-entity: Optional entity builder and validation layer for domain models.
• memran/marwa-kafka: Optional Kafka publisher/consumer for notification fan-out and async message processing.
• memran/marwa-module: Optional module management for modular application structure.
• memran/marwa-support: Optional support helpers and utility primitives for consuming apps.
• psy/psysh: Optional interactive console shell for tinker-style debugging.
• swiftmailer/swiftmailer: Optional SwiftMailer-compatible transport for the Mailer service.

MIT

• Mohammad Emran

• framework
• http
• psr-3
• php framework
• ecosystem
• psr-7
• PSR-11
• psr-16
• psr-15
• php 8
• MarwaPHP Framework
• marwaphp
• Marwa Framework
• Opensource Framework
• marwa-router
• marwa-view
• marwa-event
• marwa-db
• marwa-module
• marwa-entity

README

Documentation

📖 Full documentation at: https://memran.github.io/marwa-framework/

Marwa Framework is a lightweight, PSR-aligned PHP 8.2+ framework core for modular web apps, console tools, and reusable runtime services.

What It Includes

• HTTP kernel, middleware pipeline, router integration, and lifecycle events
• Twig-based views with themes, modules, and base controller helpers
• Framework-level menu registry for app and module-driven navigation
• Console application, scaffolding commands, scheduler, queue, and bootstrap cache
• Sessions, validation, security, cache, storage, mail, notifications, Kafka publish/consume, HTTP client, and error handling
• marwa-db and marwa-module integration for app-level runtime features

Install

composer require memran/marwa-framework

If you want a ready-to-run application skeleton instead of wiring the framework into a project manually, start with memran/marwa-php. It is the recommended starter application for this framework and shows the expected app structure, bootstrap files, routes, config, and developer workflow.

For local development:

git clone https://github.com/memran/marwa-framework.git
cd marwa-framework
composer install
cp .env.example .env

Quick Start

use Marwa\Framework\Application;

$app = new Application(__DIR__);
$app->boot();
$response = $app->http()->handle($request);

# Console Commands
php marwa make:controller Admin/PostController --resource
php marwa make:seeder UserSeeder
php marwa make:model Billing/Invoice --migration
php marwa make:module Blog
php marwa make:theme dark --parent=default
php marwa shell
php marwa security:report --since-hours=24 --prune-days=30
php marwa db:seed --class=DatabaseSeeder
php marwa schedule:run --for=60 --sleep=1

# Database Management (DBForge)
php marwa db:create myapp
php marwa db:drop myapp
php marwa db:list
php marwa db:list --tables
php marwa db:backup
php marwa db:restore backup.sql
php marwa db:optimize
php marwa db:analyze

Documentation

• Docs Index
• Starter Application: memran/marwa-php
• Quick Start
• Controllers
• Validation
• View
• Error Pages
• Console
• Modules
• Seeding
• DebugBar
• Architecture

Notes

• Generated controllers extend Marwa\Framework\Controllers\Controller.
• Validation failures flash _old_input and errors into the session.
• Theme manifests live in resources/views/themes/<theme>/manifest.php by default.
• APP_KEY is required for encrypted sessions.
• Modules can contribute navigation through Marwa\Framework\Navigation\MenuRegistry and the menu() helper.

Development

composer test
composer analyse
composer lint