PHPackages                             memran/marwa-framework - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. memran/marwa-framework

ActiveLibrary[Framework](/categories/framework)

memran/marwa-framework
======================

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

v1.6.0(3w ago)15371MITPHPPHP ^8.2CI passing

Since Apr 2Pushed 3w agoCompare

[ Source](https://github.com/memran/marwa-framework)[ Packagist](https://packagist.org/packages/memran/marwa-framework)[ RSS](/packages/memran-marwa-framework/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (78)Versions (28)Used By (1)

Marwa Framework
===============

[](#marwa-framework)

[![Packagist](https://camo.githubusercontent.com/c931dc0c947ee0423bb45b17735347437a0286c220215187c468f4e8819dcf6a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5061636b61676973742d6d656d72616e2532466d617277612d2d6672616d65776f726b2d4632384431413f7374796c653d666c61742d737175617265266c6f676f3d7061636b6167697374266c6f676f436f6c6f723d7768697465)](https://packagist.org/packages/memran/marwa-framework)[![Latest Version](https://camo.githubusercontent.com/fca11b6ac44721dd8172804d68ae0216d71e2fa55d9a64bfff98c3ce90adf27a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d656d72616e2f6d617277612d6672616d65776f726b3f7374796c653d666c61742d737175617265266c6f676f3d7061636b6167697374266c6f676f436f6c6f723d7768697465)](https://packagist.org/packages/memran/marwa-framework)[![Total Downloads](https://camo.githubusercontent.com/3347020820bec117fbb2d2be05c910352b17f4884fe3ca130ab345fc64d9bace/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d656d72616e2f6d617277612d6672616d65776f726b3f7374796c653d666c61742d737175617265)](https://packagist.org/packages/memran/marwa-framework)[![CI](https://github.com/memran/marwa-framework/actions/workflows/ci.yml/badge.svg)](https://github.com/memran/marwa-framework/actions/workflows/ci.yml)[![License](https://camo.githubusercontent.com/536139b280246ab43628d64a384503e8de613216f4cd1459864bf684441e5387/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6d656d72616e2f6d617277612d6672616d65776f726b3f7374796c653d666c61742d737175617265)](https://github.com/memran/marwa-framework/blob/main/LICENSE)[![PHP](https://camo.githubusercontent.com/6caa15003495643be73f70c6033009042189b7d38acf492a3d5fd04ffbb45059/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d3737374242343f7374796c653d666c61742d737175617265266c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://www.php.net/)[![PHPStan](https://camo.githubusercontent.com/d1d471527684096093f606c09288a8b38e7cefcc6dbe45a9304d71dc1313f925/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d4c6576656c253230362d627269676874677265656e3f7374796c653d666c61742d737175617265)](https://phpstan.org/)[![PHPUnit](https://camo.githubusercontent.com/22a6fb8313e338420e07f57d55735b2130bf9de712e308085563ed5ebbda665b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f504850556e69742d31312e352d626c75653f7374796c653d666c61742d737175617265)](https://phpunit.de/)

Documentation
-------------

[](#documentation)

📖 Full documentation at: ****

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
----------------

[](#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
-------

[](#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`](https://github.com/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
-----------

[](#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
-------------

[](#documentation-1)

- [Docs Index](docs/README.md)
- [Starter Application: memran/marwa-php](https://github.com/memran/marwa-php)
- [Quick Start](docs/tutorials/quick-start.md)
- [Controllers](docs/tutorials/controllers.md)
- [Validation](docs/tutorials/validation.md)
- [View](docs/tutorials/view.md)
- [Error Pages](docs/tutorials/error-pages.md)
- [Console](docs/tutorials/console.md)
- [Modules](docs/tutorials/modules.md)
- [Seeding](docs/tutorials/seeding.md)
- [DebugBar](docs/tutorials/debugbar.md)
- [Architecture](docs/architecture.md)

Notes
-----

[](#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//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
-----------

[](#development)

```
composer test
composer analyse
composer lint
```

Run `composer lint` after manual PHP edits before opening a PR. PHP CS Fixer output is the source of truth for import order, whitespace, braces, and blank lines.

###  Health Score

48

—

FairBetter than 93% of packages

Maintenance94

Actively maintained with recent releases

Popularity19

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~2 days

Total

26

Last Release

27d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8cf906a31a250a940314fe42f8a18f449647bfe18095457350ff0081cf8dd3c2?d=identicon)[memran](/maintainers/memran)

---

Top Contributors

[![memran](https://avatars.githubusercontent.com/u/7415198?v=4)](https://github.com/memran "memran (393 commits)")

---

Tags

httppsr-7psr-3PSR-11frameworkpsr-16psr-15php frameworkecosystemphp-8MarwaPHP FrameworkmarwaphpMarwa FrameworkOpensource Frameworkmarwa-routermarwa-viewmarwa-eventmarwa-dbmarwa-modulemarwa-entity

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/memran-marwa-framework/health.svg)

```
[![Health](https://phpackages.com/badges/memran-marwa-framework/health.svg)](https://phpackages.com/packages/memran-marwa-framework)
```

###  Alternatives

[laravel/framework

The Laravel Framework.

34.8k543.8M20.1k](/packages/laravel-framework)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M577](/packages/shopware-core)[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k15](/packages/tempest-framework)[open-dxp/opendxp

Content &amp; Product Management Framework (CMS/PIM)

9421.6k61](/packages/open-dxp-opendxp)[pimcore/pimcore

Content &amp; Product Management Framework (CMS/PIM/E-Commerce)

3.8k3.8M508](/packages/pimcore-pimcore)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
