# Повнофункціональні блоки

База даних, серверні функції, cron і CLI в одній папці.

[Читати посібник](https://blockstudio.dev/uk/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/uk/docs/blocks/block-api/database/#storage-modes)

table, sqlite, jsonc, storh, meta, post_type. Вибирайте з огляду на портативність і потреби в запитах.

## [Файли Storh](https://blockstudio.dev/uk/docs/blocks/block-api/database/#storh-files-storage-storh)

Один файл на запис у uploads, індекси створюються за схемою, а паралельний запис стає безпечнішим. wp bs db migrate –to=storh переносить записи JSONC і зберігає їхні ID.

## [Таблиці та типи записів](https://blockstudio.dev/uk/docs/blocks/block-api/database/#custom-table-storage-table)

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

## [Кілька схем](https://blockstudio.dev/uk/docs/blocks/block-api/database/#multiple-schemas)

Повертайте іменовані схеми з одного db.php. Для кожної створюються власні сховище, кінцеві точки та керування доступом.

## [Дані з прив’язкою до користувача](https://blockstudio.dev/uk/docs/blocks/block-api/database/#user-scoped-data)

Установіть userScoped, щоб автоматично ізолювати записи без ручної фільтрації.

## [Перевірка даних і хуки](https://blockstudio.dev/uk/docs/blocks/block-api/database/#validation)

Типи, обов’язкові значення, переліки, формати, довжини, зворотні виклики й хуки життєвого циклу.

## RPC

Серверні функції, які можна викликати з інтерфейсу.

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

Викликайте функції з JavaScript; вбудовані скрипти автоматично визначають назву блоку.

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

Публічний доступ із CSRF, відкритий доступ для вебхуків або доступ на основі можливостей — окремо для кожної функції.

## [Виклики між блоками](https://blockstudio.dev/uk/docs/blocks/block-api/rpc/#cross-block-calling)

Викликайте будь-яку функцію блоку з JavaScript або PHP і комбінуйте логіку.

## Рівень даних клієнта

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

## [Клієнт bs.db()](https://blockstudio.dev/uk/docs/blocks/block-api/database/#javascript-client)

Створюйте, переглядайте список, отримуйте, оновлюйте й видаляйте записи з JavaScript. list приймає фільтри полів, limit і offset.

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

Отримання даних із кешу за ключем. Паралельні виклики використовують один проміс, а staleTime пропускає запит, поки дані актуальні.

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

Оптимістичне створення, оновлення й видалення записів у реактивному масиві стану з відновленням знімка, якщо запит завершується помилкою.

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

Кеш у пам’яті для bs.query() і bs.mutate(). Читайте, задавайте, інвалідуйте або очищайте записи безпосередньо.

## [Опитування в реальному часі](https://blockstudio.dev/uk/docs/blocks/block-api/database/#realtime-polling)

Увімкніть режим реального часу в db.php, і клієнт періодично порівнюватиме хеш даних, а потім оновлюватиме сховище Interactivity API. У прихованих вкладках опитування призупиняється.

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

bs.fn() і bs.db() отримують актуальні облікові дані з ендпоінта без кешування під час першого виклику, тож публічні виклики працюють і на сторінках із тривалим кешуванням.

## Форми та екрани застосунків

Форми, створені за схемою, і готові UI для розробки на їхній основі.

## [Форми за схемою](https://blockstudio.dev/uk/docs/blocks/block-api/database/#form-rendering)

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

## [Форма в комплекті](https://blockstudio.dev/uk/guides/ui-app-screen/#step-4-the-template)

З ui.enabled блок bsui/form block=”…” надсилає свої поля до ендпоінта створення цього блока, показує помилку валідації під відповідним полем і викликає formsuccess або formerror.

## [Приклади застосунків](https://blockstudio.dev/uk/docs/general/settings/#ui)

Налаштування ui також реєструє приклади app/*, як-от app/kitchen-sink та app/chat, створені на тих самих компонентах bsui.

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

Cron, CLI, код налаштування та портативність.

## [Заплановані завдання](https://blockstudio.dev/uk/docs/blocks/block-api/cron/)

Завдання cron.php реєструються в WP-Cron. Під час видалення Composer прибирає їх за допомогою wp bs teardown.

## [База даних CLI](https://blockstudio.dev/uk/docs/dev/cli/#database)

wp bs db показує список записів із фільтрами полів, отримує, створює, оновлює й видаляє їх, а також виводить таблиці, JSON або CSV.

## [Тестування з термінала](https://blockstudio.dev/uk/docs/dev/cli/#call-a-function)

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

## [Файли ініціалізації](https://blockstudio.dev/uk/docs/blocks/block-api/initialization/)

init.php та інші файли init*.php у папці блока виконуються один раз під час init для налаштування, наприклад реєстрації типу запису.

## [Визначення на основі PHP](https://blockstudio.dev/uk/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/uk/guides/full-stack-blocks/)

SQLite і JSONC зберігаються разом із кодом: скопіюйте одну папку, щоб розгорнути застосунок.

Plus

## Офіційний набір розширень

Преміумшаблони сайтів, системні інструкції для ШІ та приватна спільнота Discord. Одноразова покупка, довічні оновлення.

- Понад 500 шаблонів сайтів
- Системні інструкції для ШІ
- Оновлення назавжди
- Приватна спільнота Discord

[Отримати Plus](https://blockstudio.dev/uk/plus/)
