PHPackages                             mahdyaralipor/crudforge - 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. [Utility & Helpers](/categories/utility)
4. /
5. mahdyaralipor/crudforge

ActiveLibrary[Utility & Helpers](/categories/utility)

mahdyaralipor/crudforge
=======================

Zero-Dependency PHP CRUD Generator

v1.0.0(4mo ago)40MITPHPPHP ^8.1

Since Feb 21Pushed 4mo agoCompare

[ Source](https://github.com/Mahdyaralipor/crudforge)[ Packagist](https://packagist.org/packages/mahdyaralipor/crudforge)[ RSS](/packages/mahdyaralipor-crudforge/feed)WikiDiscussions main Synced today

READMEChangelog (1)DependenciesVersions (2)Used By (0)

🔨 CrudForge
===========

[](#-crudforge)

**Zero-dependency PHP CRUD Generator — CLI-powered, fast, and clean.**

[![PHP](https://camo.githubusercontent.com/6a089f172bb166c9ba9411eca11182c3a931c533f1ce3e5fa6d69ad83d31d963/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e302b2d3737374242343f7374796c653d666c61742d737175617265266c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://www.php.net)[![License](https://camo.githubusercontent.com/422db9fd40f5831c765cf6530b6750c081b696bd18d904cf89554df98c676277/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e3f7374796c653d666c61742d737175617265)](LICENSE)[![Zero Dependencies](https://camo.githubusercontent.com/bc5b8d0b24a7192785b6cc5da00b125a502e34eee01ad4e8135f8165601c48a9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646570656e64656e636965732d7a65726f2d627269676874677265656e3f7374796c653d666c61742d737175617265)](composer.json)

[English](#english) · [فارسی](#%D9%81%D8%A7%D8%B1%D8%B3%DB%8C)

---

🇬🇧 English
----------

[](#-english)

### What is CrudForge?

[](#what-is-crudforge)

CrudForge is a lightweight, zero-dependency command-line tool that **automatically generates pure PHP CRUD files** for your entities. No frameworks, no bloat — just clean, ready-to-use PHP code, generated in seconds.

### ✨ Features

[](#-features)

- ⚡ Zero external dependencies
- 🖥️ Simple and intuitive CLI interface
- 📁 Generates clean, pure PHP CRUD files
- 🗂️ Organized output in the `generated/` directory
- 🔧 Easy to extend and customize

### 📋 Requirements

[](#-requirements)

- PHP **8.0** or higher
- Composer (for autoloading)

### 🚀 Installation

[](#-installation)

**Clone the repository:**

```
git clone https://github.com/Mahdyaralipor/crudforge.git
cd crudforge
```

**Install dependencies (autoloader only):**

```
composer install
```

### 💻 Usage

[](#-usage)

Run the CLI tool from the project root:

```
php bin/crudforge
```

**Example:**

```
php bin/crudforge User
php bin/crudforge Product
php bin/crudforge BlogPost
```

After running the command, your generated files will be placed inside the `generated/` directory.

### 📁 Project Structure

[](#-project-structure)

```
crudforge/
├── bin/
│   └── crudforge          # CLI entry point
├── src/
│   └── ...                # Core generator logic
├── generated/             # Output directory for generated files
├── vendor/                # Composer autoloader
├── composer.json
└── README.md

```

### 📄 Generated Output

[](#-generated-output)

For each entity, CrudForge generates pure PHP files covering:

- **Create** — insert new records
- **Read** — fetch and list records
- **Update** — modify existing records
- **Delete** — remove records

### 🤝 Contributing

[](#-contributing)

Contributions are welcome! Feel free to open issues or submit pull requests.

1. Fork the project
2. Create your feature branch: `git checkout -b feature/amazing-feature`
3. Commit your changes: `git commit -m 'Add amazing feature'`
4. Push to the branch: `git push origin feature/amazing-feature`
5. Open a Pull Request

### 📝 License

[](#-license)

This project is licensed under the **MIT License**.

---

🇮🇷 فارسی
--------

[](#-فارسی)

### CrudForge چیست؟

[](#crudforge-چیست)

CrudForge یک ابزار خط فرمان (CLI) سبک و **بدون نیاز به وابستگی خارجی** است که به صورت خودکار **فایل‌های PHP خالص CRUD** را برای موجودیت‌های شما تولید می‌کند. بدون فریم‌ورک، بدون پیچیدگی اضافه — فقط کد PHP تمیز و آماده استفاده، در چند ثانیه.

### ✨ ویژگی‌ها

[](#-ویژگی‌ها)

- ⚡ بدون هیچ وابستگی خارجی
- 🖥️ رابط خط فرمان ساده و کاربردی
- 📁 تولید فایل‌های PHP خالص و تمیز
- 🗂️ خروجی سازمان‌یافته در پوشه `generated/`
- 🔧 قابل توسعه و شخصی‌سازی آسان

### 📋 پیش‌نیازها

[](#-پیش‌نیازها)

- PHP نسخه **8.0** یا بالاتر
- Composer (برای autoloading)

### 🚀 نصب

[](#-نصب)

**کلون کردن پروژه:**

```
git clone https://github.com/Mahdyaralipor/crudforge.git
cd crudforge
```

**نصب وابستگی‌ها (فقط autoloader):**

```
composer install
```

### 💻 نحوه استفاده

[](#-نحوه-استفاده)

ابزار CLI را از ریشه پروژه اجرا کنید:

```
php bin/crudforge
```

**مثال:**

```
php bin/crudforge User
php bin/crudforge Product
php bin/crudforge BlogPost
```

پس از اجرای دستور، فایل‌های تولیدشده در پوشه `generated/` قرار می‌گیرند.

### 📁 ساختار پروژه

[](#-ساختار-پروژه)

```
crudforge/
├── bin/
│   └── crudforge          # نقطه ورودی CLI
├── src/
│   └── ...                # منطق اصلی generator
├── generated/             # پوشه خروجی فایل‌های تولیدشده
├── vendor/                # Composer autoloader
├── composer.json
└── README.md

```

### 📄 خروجی تولیدشده

[](#-خروجی-تولیدشده)

برای هر موجودیت، CrudForge فایل‌های PHP خالص را برای عملیات زیر تولید می‌کند:

- **ایجاد (Create)** — درج رکورد جدید
- **خواندن (Read)** — دریافت و نمایش رکوردها
- **ویرایش (Update)** — تغییر رکوردهای موجود
- **حذف (Delete)** — پاک کردن رکوردها

### 🤝 مشارکت در پروژه

[](#-مشارکت-در-پروژه)

از مشارکت شما استقبال می‌کنیم! می‌توانید Issue باز کنید یا Pull Request ارسال کنید.

1. پروژه را Fork کنید
2. برنچ خود را بسازید: `git checkout -b feature/ویژگی-جدید`
3. تغییرات را Commit کنید: `git commit -m 'افزودن ویژگی جدید'`
4. به برنچ Push کنید: `git push origin feature/ویژگی-جدید`
5. یک Pull Request باز کنید

### 📝 لایسنس

[](#-لایسنس)

این پروژه تحت **لایسنس MIT** منتشر شده است.

---

 Made with ❤️ by [Mahdyaralipor](https://github.com/Mahdyaralipor)

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance75

Regular maintenance activity

Popularity4

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 50% 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

Unknown

Total

1

Last Release

134d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/7316fbf66cdbdfa2eea2079578cf5edca69c6d050bec1e3384471bdb09288702?d=identicon)[Mahdyaralipor](/maintainers/Mahdyaralipor)

---

Top Contributors

[![mahdyaralipor](https://avatars.githubusercontent.com/u/142358745?v=4)](https://github.com/mahdyaralipor "mahdyaralipor (7 commits)")[![Mahdyaralipor](https://avatars.githubusercontent.com/u/142358745?v=4)](https://github.com/Mahdyaralipor "Mahdyaralipor (7 commits)")

### Embed Badge

![Health badge](/badges/mahdyaralipor-crudforge/health.svg)

```
[![Health](https://phpackages.com/badges/mahdyaralipor-crudforge/health.svg)](https://phpackages.com/packages/mahdyaralipor-crudforge)
```

###  Alternatives

[fluidtypo3/schemaker

The schemaker package from FluidTYPO3

171.4k](/packages/fluidtypo3-schemaker)

PHPackages © 2026

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