Перейти к содержимому

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

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

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 режимов хранения

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

Файлы Storh

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

Таблицы и типы записей

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

Несколько схем

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

Данные в области пользователя

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

Проверка и хуки

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

RPC

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

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

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

Клиент bs.db()

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

bs.query()

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

bs.mutate()

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

bs.cache

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

Опрос для обновления данных

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

Кэшированные страницы

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

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

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

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

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

Plus

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

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

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