Блоки полного стека
База данных, серверные функции, cron и CLI в одной папке.
db.php
Задайте схему — получите конечные точки CRUD
<?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
Пользовательские функции сервера
<?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.fn()
Вызывайте функции из JavaScript; встроенные скрипты автоматически определяют имя блока.
Контроль доступа
Для каждой функции: публичный доступ с CSRF, открытый доступ для вебхуков или доступ на основе возможностей.
Вызовы между блоками
Вызывайте любую функцию блока из JavaScript или PHP и составляйте из них логику.
Слой данных клиента
Читайте, кэшируйте и записывайте записи из браузера.
Клиент 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 для дальнейшей работы.
Формы по схеме
Укажите для поля ключ компонента, и bs_db_form() отобразит форму с помощью этих блоков, передав каждому определение поля.
Встроенная форма
С ui.enabled блок bsui/form block=”…” отправляет поля в конечную точку создания этого блока, показывает ошибки проверки под соответствующими полями и отправляет событие formsuccess или formerror.
Примеры приложений
Настройка ui также регистрирует примеры app/*, например app/kitchen-sink и app/chat, созданные на тех же компонентах bsui.
Инфраструктура
Cron, CLI, код настройки и переносимость.
Запланированные задачи
Задания cron.php регистрируются в WP-Cron. При удалении Composer удаляет их командой wp bs teardown.
CLI базы данных
wp bs db выводит список записей с фильтрами по полям, получает, создает, обновляет и удаляет их, а также печатает таблицы, JSON или CSV.
Проверяйте из терминала
Команда wp bs rpc call запускает функцию с параметрами –key=value, а команда wp bs cron run немедленно запускает задачу независимо от ее расписания.
Файлы инициализации
Файл init.php и другие файлы init*.php в папке блока запускаются один раз при init для настройки, например регистрации типа записей.
Определения в стиле PHP
rpc.php и cron.php могут возвращать класс с методами #[Rpc] и #[Cron], а также перечислениями Access, Method и Schedule. В db.php можно использовать Schema::make() и построители Field.
Переносимость
SQLite и JSONC перемещаются вместе с кодом: скопируйте одну папку, чтобы развернуть приложение.
Официальный набор расширений
Премиум-шаблоны сайтов, системные инструкции для ИИ и закрытое сообщество Discord. Разовая покупка, обновления навсегда.
- 500+ шаблонов сайтов
- Системные инструкции для ИИ
- Пожизненные обновления
- Закрытое сообщество Discord