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