# كتل متكاملة المكدس

قاعدة البيانات ودوال الخادم وcron وCLI في مجلد واحد.

[اقرأ الدليل](https://blockstudio.dev/ar/guides/full-stack-blocks/)

## db.php

عرّف المخطط واحصل على نقاط نهاية CRUD

db.php

```
<?php
return [
  'storage'    => 'sqlite',
  'userScoped' => true,
  'capability' => [
    'create' => true,
    'read'   => true,
    'update' => true,
    'delete' => true,
  ],
  'fields' => [
    'text' => ['type' => 'string', 'required' => true],
    'done' => ['type' => 'boolean', 'default' => false],
  ],
];
```

## rpc.php

دوال خادم مخصصة

rpc.php

```
<?php
use Blockstudio\Db;

return [
  'toggle' => function (array $params): array {
    $db   = Db::get('my-theme/todo');
    $id   = (int) ($params['id'] ?? 0);
    $todo = $db->get_record($id);
    if ($todo) {
      $db->update($id, ['done' => !$todo['done']]);
    }
    return ['success' => (bool) $todo];
  },
  'clear_done' => function (): array {
    $db = Db::get('my-theme/todo');
    foreach ($db->list(['done' => true], 500) as $todo) {
      $db->delete((int) $todo['id']);
    }
    return ['cleared' => true];
  },
];
```

## كل إمكانية في ملف

يضيف كل ملف إمكانية واحدة. بلا إعدادات أو كود تسجيل.

كتلة تطبيق

blockstudio/

└── my-app/

├── block.json تعريف الكتلة

├── index.php القالب + التفاعلية API

├── style.css أنماط محددة النطاق

├── script-inline.js منطق العميل

├── db.php نموذج البيانات + CRUD

├── rpc.php دوال الخادم

├── cron.php المهام المجدولة

└── db/default.sqlite

## قاعدة البيانات

عرّف المخططات واحصل على نقاط نهاية CRUD.

## [6 أوضاع تخزين](https://blockstudio.dev/ar/docs/blocks/block-api/database/#storage-modes)

table, sqlite, jsonc, storh, meta, post_type. اختر حسب قابلية النقل واحتياجات الاستعلام.

## [ملفات Storh](https://blockstudio.dev/ar/docs/blocks/block-api/database/#storh-files-storage-storh)

ملف واحد لكل سجل ضمن uploads، مع فهارس تُنشأ من المخطط وكتابات متزامنة أكثر أمانًا. ينقل wp bs db migrate –to=storh سجلات JSONC مع الاحتفاظ بمعرّفاتها.

## [الجداول وأنواع المحتوى](https://blockstudio.dev/ar/docs/blocks/block-api/database/#custom-table-storage-table)

تدير آلية التخزين table جدول MySQL باستخدام dbDelta، وتضيف أعمدة للحقول الجديدة. تجعل آلية التخزين post_type كل سجل تدوينة، بحيث تتمكن WP_Query وإضافات REST API وأدوات GraphQL من قراءته.

## [مخططات متعددة](https://blockstudio.dev/ar/docs/blocks/block-api/database/#multiple-schemas)

أعِد مخططات مسماة من db.php واحد. لكل منها تخزينها ونقاط نهايتها وضوابط الوصول الخاصة بها.

## [بيانات خاصة بالمستخدم](https://blockstudio.dev/ar/docs/blocks/block-api/database/#user-scoped-data)

اضبط userScoped لعزل السجلات تلقائيًا، دون تصفية يدوية.

## [التحقق والخطافات](https://blockstudio.dev/ar/docs/blocks/block-api/database/#validation)

الأنواع والقيم المطلوبة والتعدادات والتنسيقات والأطوال وعمليات الاستدعاء وخطافات دورة الحياة.

## RPC

دوال الخادم القابلة للاستدعاء من الواجهة الأمامية.

## [عميل bs.fn()](https://blockstudio.dev/ar/docs/blocks/block-api/rpc/#calling-from-javascript)

استدعِ الدوال من JavaScript؛ وتكتشف البرامج النصية المضمنة اسم الكتلة تلقائيًا.

## [التحكم في الوصول](https://blockstudio.dev/ar/docs/blocks/block-api/rpc/#access-control)

عام مع CSRF، أو مفتوح لخطافات الويب، أو قائم على الصلاحيات، لكل دالة.

## [استدعاءات بين الكتل](https://blockstudio.dev/ar/docs/blocks/block-api/rpc/#cross-block-calling)

استدعِ أي دالة كتلة من JavaScript أو PHP وركّب المنطق.

## طبقة بيانات العميل

اقرأ السجلات وخزّنها مؤقتًا واكتبها من المتصفح.

## [عميل bs.db()](https://blockstudio.dev/ar/docs/blocks/block-api/database/#javascript-client)

أنشئ السجلات واعرضها واحصل عليها وحدّثها واحذفها من JavaScript. تقبل list مرشحات الحقول والحد الأقصى والإزاحة.

## [bs.query()](https://blockstudio.dev/ar/docs/blocks/block-api/database/#query)

عمليات جلب مخزنة مؤقتًا حسب المفتاح. تشترك الاستدعاءات الجارية في وعد واحد، وتتجاوز staleTime الطلب ما دامت البيانات حديثة.

## [bs.mutate()](https://blockstudio.dev/ar/docs/blocks/block-api/database/#mutate)

إنشاء السجلات وتحديثها وحذفها بتفاؤل في مصفوفة حالة تفاعلية، مع التراجع إلى لقطة عند فشل الطلب.

## [bs.cache](https://blockstudio.dev/ar/docs/blocks/block-api/database/#cache)

الذاكرة المؤقتة داخل الذاكرة وراء bs.query() و bs.mutate(). اقرأ الإدخالات أو عيّنها أو أبطِلها أو امسحها مباشرة.

## [استطلاع آني](https://blockstudio.dev/ar/docs/blocks/block-api/database/#realtime-polling)

اضبط realtime في db.php، فيقارن العميل تجزئة البيانات على فترات، ثم يحدّث متجر Interactivity API. يتوقف الاستطلاع مؤقتًا في علامات التبويب المخفية.

## [صفحات مخزنة مؤقتًا](https://blockstudio.dev/ar/docs/blocks/block-api/rpc/#cached-pages)

يجلب bs.fn() و bs.db() بيانات اعتماد حديثة من نقطة نهاية غير مخزنة مؤقتًا عند أول استدعاء، لتظل الاستدعاءات العامة تعمل على الصفحات المقدمة من ذاكرة تخزين مؤقت طويلة الأمد.

## النماذج وشاشات التطبيقات

نماذج معروضة من المخطط، وحزم UI للانطلاق منها.

## [نماذج المخطط](https://blockstudio.dev/ar/docs/blocks/block-api/database/#form-rendering)

امنح الحقل مفتاح مكوّن، وسيعرض bs_db_form() النموذج عبر تلك الكتل، مع تمرير تعريف الحقل إلى كل منها.

## [نموذج مجمّع](https://blockstudio.dev/ar/guides/ui-app-screen/#step-4-the-template)

باستخدام ui.enabled، يرسل bsui/form block=”…” حقوله إلى نقطة إنشاء النهاية الخاصة بتلك الكتلة، ويعرض كل خطأ تحقق أسفل حقله، ثم يطلق form success أو formerror.

## [تطبيقات نموذجية](https://blockstudio.dev/ar/docs/general/settings/#ui)

يسجل إعداد ui أيضًا أمثلة app/*، مثل app/kitchen-sink وapp/chat، المبنية من مكونات bsui نفسها.

## البنية التحتية

Cron وCLI ورمز الإعداد وقابلية النقل.

## [المهام المجدولة](https://blockstudio.dev/ar/docs/blocks/block-api/cron/)

تُسجّل مهام cron.php في WP-Cron. ويزيلها تثبيت Composer باستخدام wp bs teardown.

## [CLI قاعدة البيانات](https://blockstudio.dev/ar/docs/dev/cli/#database)

يعرض wp bs db السجلات بمرشحات الحقول، ويجلبها وينشئها ويحدّثها ويحذفها، ويطبع الجداول أو JSON أو CSV.

## [اختبر من الطرفية](https://blockstudio.dev/ar/docs/dev/cli/#call-a-function)

يشغّل wp bs rpc call دالةً بمعاملات –key=value، ويشغّل wp bs cron run مهمةً فورًا مهما كان جدولها.

## [ملفات التهيئة](https://blockstudio.dev/ar/docs/blocks/block-api/initialization/)

يعمل init.php وغيره من ملفات init*.php في مجلد الكتلة مرة واحدة عند init، لإعداد أمور مثل تسجيل نوع محتوى.

## [تعريفات أصلية لـPHP](https://blockstudio.dev/ar/docs/blocks/block-api/rpc/#php-native-definitions)

يمكن أن يعيد rpc.php وcron.php صنفًا بأساليب #[Rpc] و#[Cron] وتعدادات Access وMethod وSchedule. ويمكن لـdb.php استخدام Schema::make() ومنشئات Field.

## [قابلية النقل](https://blockstudio.dev/ar/guides/full-stack-blocks/)

تنتقل SQLite وJSONC مع الكود: انسخ مجلدًا واحدًا لنشر التطبيق.

Plus

## حزمة الإضافات الرسمية

قوالب مواقع مميزة، وتعليمات نظام للذكاء الاصطناعي، ومجتمع Discord خاص. شراء لمرة واحدة وتحديثات مدى الحياة.

- أكثر من 500+ قالب موقع
- تعليمات نظام الذكاء الاصطناعي
- تحديثات مدى الحياة
- مجتمع Discord خاص

[احصل على Plus](https://blockstudio.dev/ar/plus/)
