# Блоки полного стека

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

[Открыть руководство](https://blockstudio.dev/ru/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/ru/docs/blocks/block-api/database/#storage-modes)

table, sqlite, jsonc, storh, meta, post_type. Выбирайте с учетом переносимости и требований к запросам.

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

По одному файлу на запись в uploads, индексы создаются по схеме, а параллельная запись безопаснее. Команда wp bs db migrate –to=storh переносит записи JSONC и сохраняет их идентификаторы.

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

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

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

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

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

Установите userScoped, чтобы автоматически изолировать записи без ручной фильтрации.

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

Типы, обязательные значения, перечисления, форматы, длины, обратные вызовы и хуки жизненного цикла.

## RPC

Серверные функции, доступные из интерфейса.

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

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

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

Для каждой функции: публичный доступ с CSRF, открытый доступ для вебхуков или доступ на основе возможностей.

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

Вызывайте любую функцию блока из JavaScript или PHP и составляйте из них логику.

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

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

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

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

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

Запросы кэша по ключу. Параллельные вызовы используют один промис, а staleTime пропускает запрос, пока данные свежие.

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

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

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

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

## [Опрос для обновления данных](https://blockstudio.dev/ru/docs/blocks/block-api/database/#realtime-polling)

Включите realtime в db.php: клиент периодически сравнивает хеш данных и обновляет хранилище Interactivity API. В скрытых вкладках опрос приостанавливается.

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

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

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

Формы, созданные по схеме, и готовые UI для дальнейшей работы.

## [Формы по схеме](https://blockstudio.dev/ru/docs/blocks/block-api/database/#form-rendering)

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

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

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

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

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

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

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

## [Запланированные задачи](https://blockstudio.dev/ru/docs/blocks/block-api/cron/)

Задания cron.php регистрируются в WP-Cron. При удалении Composer удаляет их командой wp bs teardown.

## [CLI базы данных](https://blockstudio.dev/ru/docs/dev/cli/#database)

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

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

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

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

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

## [Определения в стиле PHP](https://blockstudio.dev/ru/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/ru/guides/full-stack-blocks/)

SQLite и JSONC перемещаются вместе с кодом: скопируйте одну папку, чтобы развернуть приложение.

Plus

## Официальный набор расширений

Премиум-шаблоны сайтов, системные инструкции для ИИ и закрытое сообщество Discord. Разовая покупка, обновления навсегда.

- 500+ шаблонов сайтов
- Системные инструкции для ИИ
- Пожизненные обновления
- Закрытое сообщество Discord

[Получить Plus](https://blockstudio.dev/ru/plus/)
