https://github.com/memran/marwa-php
A fast, lightweight PHP framework for modern web development — modular, MVC-based, and ideal for building scalable APIs and applications.
https://github.com/memran/marwa-php
lightweight marwaphp microframework modular mvc php-framework rest-api web-development
Last synced: 5 days ago
JSON representation
A fast, lightweight PHP framework for modern web development — modular, MVC-based, and ideal for building scalable APIs and applications.
- Host: GitHub
- URL: https://github.com/memran/marwa-php
- Owner: memran
- License: mit
- Created: 2023-04-26T16:41:18.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2025-12-06T15:21:56.000Z (3 months ago)
- Last Synced: 2025-12-14T21:57:09.155Z (3 months ago)
- Topics: lightweight, marwaphp, microframework, modular, mvc, php-framework, rest-api, web-development
- Language: PHP
- Homepage: https://github.com/memran/marwa-php
- Size: 207 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.MD
- Contributing: CONTRIBUTING.MD
- License: LICENSE
Awesome Lists containing this project
README
# 🚀 MarwaPHP Framework
**MarwaPHP** is a fast, lightweight, and modular PHP framework built for modern web development. It simplifies API and application development with expressive routing, powerful CLI tools, and a clean MVC structure — all while staying minimal and extensible.
---
## 📦 Features
- ✅ Lightweight MVC structure
- 🔧 CLI tools for rapid scaffolding
- 🛠 Schema Builder, Migrations, and Seeders
- 🔐 JWT Authentication & Middleware
- 🌐 Built-in CORS support
- 📅 Task Scheduling & Queues
- 🧰 Helper functions & Utilities
- 🐳 Docker-ready for scalable deployment
---
## 📁 Project Structure
```
marwa-php/
├── app/ → Application Code (Controllers, Models, Views)
├── config/ → Configuration files
├── public/ → Web root (index.php)
├── routes/ → Route definitions
├── resources/ → Views & Assets
├── database/ → Migrations, Seeders
├── tests/ → Unit & Feature tests
└── vendor/ → Composer packages
```
---
## 🚀 Getting Started
```bash
# Clone the repo
git clone https://github.com/memran/marwa-php.git
# Enter project directory
cd marwa-php
# Install dependencies
composer install
# Run dev server
php -S localhost:8000 -t public/
```
---
## 📚 Documentation
Visit the [MarwaPHP GitHub Wiki](https://github.com/memran/marwa-php/wiki) to get started and learn all features:
- [Getting Started](https://github.com/memran/marwa-php/wiki/Getting-Started)
- [Routing](https://github.com/memran/marwa-php/wiki/Routing)
- [Controllers](https://github.com/memran/marwa-php/wiki/Controller)
- [Models](https://github.com/memran/marwa-php/wiki/Model)
- [Views (Twig)](https://github.com/memran/marwa-php/wiki/Twig)
- [Authentication](https://github.com/memran/marwa-php/wiki/Authentication)
- [Authorization (Roles & Policies)](https://github.com/memran/marwa-php/wiki/Authorization)
- [Session Management](https://github.com/memran/marwa-php/wiki/Session)
- [Queue System](https://github.com/memran/marwa-php/wiki/Queue)
- [Task Scheduling](https://github.com/memran/marwa-php/wiki/TaskSchedule)
- [Docker Setup](https://github.com/memran/marwa-php/wiki/Docker-Tutorial)
---
## 💻 Examples
- 📦 Build a RESTful API in minutes
- 🔐 Secure routes with policies
- 🧠 Schedule background tasks
- 📊 Queue jobs with Redis
- 🧪 Run PHPUnit tests
---
## 🤝 Contributing
We welcome contributions! Open an issue, submit a PR, or improve documentation.
---
## 📄 License
MIT © [Mohammad Emran](https://github.com/memran)