# Блокове с цялостен стек

База данни, сървърни функции, cron и CLI в една папка.

[Прочетете ръководството](https://blockstudio.dev/bg/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 Шаблон + Interactivity API

├── style.css Изолирани стилове

├── script-inline.js Клиентска логика

├── db.php Модел на данните + CRUD

├── rpc.php Сървърни функции

├── cron.php Планирани задачи

└── db/default.sqlite

## База данни

Дефинирайте схеми и получете крайни точки за CRUD операции.

## [6 режима на съхранение](https://blockstudio.dev/bg/docs/blocks/block-api/database/#storage-modes)

table, sqlite, jsonc, storh, meta, post_type. Изберете според нуждите си за преносимост и заявки.

## [Storh файлове](https://blockstudio.dev/bg/docs/blocks/block-api/database/#storh-files-storage-storh)

По един файл за запис в uploads, с индекси, създадени по схемата, и по-безопасни едновременни записи. wp bs db migrate –to=storh премества JSONC записа и запазва техните ID.

## [Таблици и типове публикации](https://blockstudio.dev/bg/docs/blocks/block-api/database/#custom-table-storage-table)

Съхранението в table управлява таблица MySQL с dbDelta и добавя колони за нови полета. Съхранението в post_type създава публикация за всеки запис, така че WP_Query, плъгините REST API и инструментите GraphQL да могат да го четат.

## [Няколко схеми](https://blockstudio.dev/bg/docs/blocks/block-api/database/#multiple-schemas)

Върнете именувани схеми от един db.php. Всяка има собствено съхранение, крайни точки и контрол на достъпа.

## [Данни с обхват на потребител](https://blockstudio.dev/bg/docs/blocks/block-api/database/#user-scoped-data)

Задайте userScoped, за да изолирате записите автоматично, без ръчно филтриране.

## [Валидиране и куки](https://blockstudio.dev/bg/docs/blocks/block-api/database/#validation)

Типове, задължителни стойности, изброими стойности, формати, дължини, обратни извиквания и куки за жизнения цикъл.

## RPC

Сървърни функции, извиквани от фронтенда.

## [Клиент bs.fn()](https://blockstudio.dev/bg/docs/blocks/block-api/rpc/#calling-from-javascript)

Извиквайте функции от JavaScript; вградените скриптове откриват автоматично името на блока.

## [Контрол на достъпа](https://blockstudio.dev/bg/docs/blocks/block-api/rpc/#access-control)

Публичен достъп със CSRF защита, отворен достъп за уебхукове или достъп според правата за всяка функция.

## [Извиквания между блокове](https://blockstudio.dev/bg/docs/blocks/block-api/rpc/#cross-block-calling)

Извиквайте всяка функция на блок от JavaScript или PHP и комбинирайте логиката.

## Слой за данни на клиента

Четете, кеширайте и записвайте записи от браузъра.

## [Клиентът bs.db()](https://blockstudio.dev/bg/docs/blocks/block-api/database/#javascript-client)

Създавайте, изброявайте, извличайте, актуализирайте и изтривайте записи от JavaScript. list приема филтри по полета, лимит и отместване.

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

Кеширани извличания по ключ. Извикванията в ход споделят един и същ promise, а staleTime пропуска заявката, докато данните са актуални.

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

Оптимистично създаване, актуализиране и изтриване в реактивен масив със състояние; при неуспешна заявка се възстановява моментна снимка.

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

Кешът в паметта зад bs.query() и bs.mutate(). Четете, задавайте, обезсилвайте или изчиствайте записи директно.

## [Периодично извличане в реално време](https://blockstudio.dev/bg/docs/blocks/block-api/database/#realtime-polling)

Задайте realtime в db.php и клиентът сравнява хеш на данните през определен интервал, след което актуализира хранилището Interactivity API. Периодичното извличане спира в скрити раздели.

## [Кеширани страници](https://blockstudio.dev/bg/docs/blocks/block-api/rpc/#cached-pages)

bs.fn() и bs.db() извличат актуални идентификационни данни от некеширана крайна точка при първото извикване, така че публичните извиквания продължават да работят на страници, обслужвани от дълготрайни кешове.

## Формуляри и екрани на приложения

Формуляри, визуализирани от схемата, и пакетирани UI, върху които да надграждате.

## [Формуляри по схема](https://blockstudio.dev/bg/docs/blocks/block-api/database/#form-rendering)

Задайте на поле ключ на компонент и bs_db_form() визуализира формуляра чрез тези блокове, като подава на всеки от тях дефиницията на полето.

## [Вградена форма](https://blockstudio.dev/bg/guides/ui-app-screen/#step-4-the-template)

С ui.enabled, bsui/form block=”…” изпраща полетата си до крайната точка за създаване на този блок, показва всяка грешка при валидиране под съответното поле и извиква formsuccess или formerror.

## [Примерни приложения](https://blockstudio.dev/bg/docs/general/settings/#ui)

Настройката ui регистрира и примерите app/*, като app/kitchen-sink и app/chat, създадени от същите компоненти bsui.

## Инфраструктура

Cron, CLI, код за настройка и преносимост.

## [Планирани задачи](https://blockstudio.dev/bg/docs/blocks/block-api/cron/)

Задачите cron.php се регистрират в WP-Cron. Инсталациите Composer ги премахват с wp bs teardown.

## [CLI на базата данни](https://blockstudio.dev/bg/docs/dev/cli/#database)

wp bs db изброява записи с филтри по полета, извлича, създава, актуализира и изтрива записи и извежда таблици, JSON или CSV.

## [Тествайте от терминала](https://blockstudio.dev/bg/docs/dev/cli/#call-a-function)

wp bs rpc call изпълнява функция с параметри –key=value, а wp bs cron run изпълнява задача веднага, независимо от графика ѝ.

## [Файлове за инициализация](https://blockstudio.dev/bg/docs/blocks/block-api/initialization/)

init.php и другите файлове init*.php в папка на блок се изпълняват веднъж при init за задачи по настройка, например регистриране на тип публикация.

## [Дефиниции, базирани на PHP](https://blockstudio.dev/bg/docs/blocks/block-api/rpc/#php-native-definitions)

rpc.php и cron.php могат да връщат клас с методи #[Rpc] и #[Cron], както и enum типовете Access, Method и Schedule. db.php може да използва Schema::make() и създатели на Field.

## [Преносимост](https://blockstudio.dev/bg/guides/full-stack-blocks/)

SQLite и JSONC вървят заедно с кода: копирайте една папка, за да разположите приложението.

Plus

## Официалният комплект за разширения

Премиум шаблони за сайтове, системни инструкции за AI и частна общност в Discord. Еднократна покупка, актуализации за цял живот.

- 500+ шаблона за сайтове
- Системни инструкции за AI
- Актуализации за целия период
- Частна общност на Discord

[Вземете Plus](https://blockstudio.dev/bg/plus/)
