إنشاء واجهات CRUD تلقائيًا

بعد إنشاء الخادم الخاص بك داخل HosteDay يمكنك البدء مباشرة ببناء قواعد البيانات وتوليد REST APIs تلقائيًا.

لن تحتاج إلى:

• كتابة Controllers
• إنشاء Models
• كتابة Routes
• إعداد CRUD يدوي
• إنشاء Validation Rules

كل ذلك يتم تلقائيًا.

الخطوة 1 — اختر الخادم

من لوحة التحكم اختر الخادم الذي تريد العمل عليه.

مثال:

myapi.hosteday.com

ثم افتح تفاصيل المشروع.

الخطوة 2 — الانتقال إلى قسم إنشاء CRUD

داخل صفحة المشروع ستجد قسم:

إنشاء وحدة (CRUD) جديدة مع القواعد

هذا القسم مسؤول عن:

• إنشاء الجداول
• إنشاء الحقول
• إنشاء Validation Rules
• إنشاء الـ API
• إنشاء الـ Endpoints
• إنشاء العلاقات بين الجداول

تلقائيًا.

الخطوة 3 — كتابة اسم الجدول

قم بكتابة اسم الجدول.

مثال:

posts

أو:

products

الخطوة 4 — إضافة الحقول

قم بإضافة الحقول المطلوبة للجدول.

لكل حقل ستحتاج إلى:

1. اسم الحقل

أدخل اسم الحقل الذي سيتم استخدامه داخل قاعدة البيانات.

مثال:

title

أو:

body

2. نوع الحقل

اختر نوع البيانات المناسب للحقل وفقًا للقيمة التي سيتم تخزينها.

أمثلة:

• String
• Integer
• Boolean
• Text
• Date
• JSON

3. إعدادات الحقل

يمكنك تحديد الإعدادات والقيود المناسبة للحقل حسب نوع البيانات المختار.

على سبيل المثال:

• جعل الحقل مطلوبًا (Required).
• السماح بالقيم الفارغة (Nullable).
• تحديد قيمة افتراضية (Default Value).
• جعل القيمة فريدة (Unique).
• تحديد الحد الأقصى للطول.

تختلف الإعدادات المتاحة باختلاف نوع الحقل.

4. إنشاء علاقة

إذا كان الحقل مرتبطًا بجدول آخر، يمكنك إنشاء علاقة مباشرة بينهما لتسهيل ربط البيانات واسترجاعها.

على سبيل المثال، يمكن ربط الحقل:

user_id

بالجدول:

users

مما يسمح بإنشاء علاقات مثل:

• Belongs To
• Has One
• Has Many

ويتم إنشاء مفاتيح الربط اللازمة تلقائيًا وفقًا لنوع العلاقة المختارة.

أمثلة:

الخطوة 5 — إنشاء الـ CRUD

بعد الانتهاء اضغط على زر:

بناء وبرمجة الـ CRUD الآن

ستقوم HosteDay تلقائيًا بـ:

• إنشاء الجدول
• إنشاء قاعدة البيانات
• إنشاء Model
• إنشاء Controller
• إنشاء Validation Rules
• إنشاء Routes
• إنشاء REST API كاملة

بدون كتابة أي كود.

مثال كامل

لنفترض أنك تريد إنشاء جدول لتخزين المقالات.

اسم الجدول:

posts

الحقول:

بعد حفظ الجدول، ستقوم HosteDay تلقائيًا بإنشاء:

• جدول قاعدة البيانات.
• Model.
• Migration.
• CRUD APIs.
• Routes اللازمة.
• قواعد التحقق الأساسية.

وستصبح نقاط الـ API التالية متاحة مباشرة:

GET    /api/posts
POST   /api/posts
GET    /api/posts/{id}
PUT    /api/posts/{id}
DELETE /api/posts/{id}

مثال على إنشاء مقال جديد:

{
    "title": "My First Post",
    "body": "Hello from HosteDay"
}

بعد إرسال الطلب سيتم حفظ البيانات داخل الجدول وإتاحتها من خلال واجهات API الخاصة بالمشروع.

الـ APIs التي يتم إنشاؤها

بعد الإنشاء ستحصل تلقائيًا على مجموعة كاملة من الـ Endpoints.

جلب جميع البيانات

GET /api/posts

جلب عنصر واحد

GET /api/posts/{id}

إنشاء عنصر جديد

POST /api/posts

Request Example:

{
    "title": "First Post",
    "body": "Hello World"
}

تحديث عنصر

PUT /api/posts/{id}

حذف عنصر

DELETE /api/posts/{id}

Validation Rules تلقائية

تقوم HosteDay أيضًا بإنشاء قواعد التحقق تلقائيًا بناءً على أنواع الحقول.

مثال:

{
    "title": "required|string|max:255",
    "body": "required|string|min:10"
}

عرض الـ Endpoints

بعد إنشاء الـ CRUD ستظهر لك جميع روابط الـ API داخل قسم:

إظهار روابط الـ API (Endpoints)

يمكنك:

• مشاهدة جميع المسارات
• معرفة نوع الطلب
• عرض Validation Rules
• نسخ الـ Endpoint
• اختبار الـ API مباشرة

جاهز للاستخدام مباشرة

جميع الـ APIs التي يتم إنشاؤها تكون:

• Production Ready
• HTTPS Enabled
• مرتبطة بقاعدة البيانات
• محمية بالتوكنات
• معزولة داخل بيئة مستقلة

ما التالي؟

بعد إنشاء أول CRUD API يمكنك الانتقال إلى:

• API Testing
• Authentication
• Upload Files
• Dynamic Endpoints
• Token Protection
• Runtime Routing

بناء Backend خلال دقائق

باستخدام HosteDay يمكنك الانتقال من:

فكرة → Database → REST API

خلال دقائق فقط بدون إدارة Infrastructure أو كتابة CRUD يدوي.