README

A lightweight, modular PHP micro-framework built for speed, scalability, and simplicity. It adheres to PSR standards and offers rich features like routing, ORM, CLI tools, authentication, mailing, and more — making it ideal for rapid API or web application development.

🚀 Features

PSR-4 Autoloading & PSR-7 HTTP Message support
Expressive Routing System
MVC Pattern
ORM with Relationships
Authentication & Authorization
Middleware Support
Queue Job Handling
Notification System (Email/SMS)
Session & Cookie Management
Templating with Smarty
Built-in CLI (marwa)

📦 Requirements

PHP >= 8.2
Composer
MySQL or supported database
Optional: Redis (for cache/session/queue)

📥 Installation

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

Create .env file:

cp .env.example .env

Update your environment variables for DB, mail, etc.

🔧 Running the App

Use PHP's built-in web server:

php -S localhost:8000 -t public

🧭 Example Route

// routes/web.php

use Marwa\Framework\Facades\Route;

Route::get('/', function () {
    return 'Hello from Marwa!';
})->register();

🎮 Using the CLI

The marwa CLI allows code generation and system operations:

php marwa make:controller HomeController
php marwa make:model Product
php marwa migrate

📜 License

Licensed under the MIT License

🤝 Contributing

We welcome contributions. Feel free to fork, make a pull request, or suggest features via GitHub issues.

👤 Author

Mohammad Emran
GitHub | LinkedIn

memran / marwa-framework

Maintainers

Details