Bloki pełnego stosu
Baza danych, funkcje serwerowe, cron i CLI w jednym folderze.
db.php
Zdefiniuj schemat, otrzymaj endpointy 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
Niestandardowe funkcje serwera
<?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];
},
];Każda funkcjonalność to plik
Każdy plik dodaje jedną funkcjonalność. Bez konfiguracji i kodu rejestracji.
Blok aplikacji
blockstudio/
└── my-app/
├── block.json Definicja bloku
├── index.php Szablon + Interactivity API
├── style.css Style o ograniczonym zakresie
├── script-inline.js Logika klienta
├── db.php Model danych + CRUD
├── rpc.php Funkcje serwera
├── cron.php Zaplanowane zadania
└── db/default.sqlite
Baza danych
Definiuj schematy i twórz punkty końcowe CRUD.
6 trybów przechowywania
table, sqlite, jsonc, storh, meta, post_type. Wybierz według przenośności i potrzeb związanych z zapytaniami.
Pliki Storh
Jeden plik na rekord w katalogu uploads, indeksy tworzone na podstawie schematu i bezpieczniejsze równoczesne zapisy. wp bs db migrate –to=storh przenosi rekordy JSONC i zachowuje ich identyfikatory.
Tabele i typy wpisów
Przechowywanie w tabeli zarządza tabelą MySQL za pomocą dbDelta i dodaje kolumny dla nowych pól. Przechowywanie w post_type tworzy z każdego rekordu wpis, dzięki czemu WP_Query, wtyczki REST API i narzędzia GraphQL mogą go odczytać.
Wiele schematów
Zwracaj nazwane schematy z jednego db.php. Każdy ma własne miejsce przechowywania, punkty końcowe i kontrolę dostępu.
Dane przypisane do użytkownika
Ustaw userScoped, aby automatycznie izolować rekordy bez ręcznego filtrowania.
Walidacja i hooki
Typy, wymagane wartości, wyliczenia, formaty, długości, funkcje zwrotne i hooki cyklu życia.
RPC
Funkcje serwerowe wywoływane z frontendu.
Warstwa danych klienta
Odczytuj, buforuj i zapisuj rekordy w przeglądarce.
Klient bs.db()
Twórz, wyświetlaj listę, pobieraj, aktualizuj i usuwaj rekordy z JavaScript. list przyjmuje filtry pól, limit i przesunięcie.
bs.query()
Pobieranie z pamięci podręcznej według klucza. Wywołania w toku współdzielą tę samą obietnicę, a staleTime pomija żądanie, gdy dane są aktualne.
bs.mutate()
Optymistyczne tworzenie, aktualizowanie i usuwanie elementów reaktywnej tablicy stanu; w razie niepowodzenia żądania stan jest przywracany z migawki.
bs.cache
Pamięć podręczna w pamięci operacyjnej, która obsługuje bs.query() i bs.mutate(). Odczytuj, ustawiaj, unieważniaj lub bezpośrednio usuwaj wpisy.
Odpytywanie w czasie rzeczywistym
Ustaw realtime w db.php, a klient będzie okresowo porównywać skrót danych i aktualizować magazyn Interactivity API. Odpytywanie wstrzymuje się na ukrytych kartach.
Strony z pamięci podręcznej
bs.fn() i bs.db() pobierają aktualne dane uwierzytelniające z niebuforowanego punktu końcowego przy pierwszym wywołaniu, dzięki czemu wywołania publiczne działają na stronach obsługiwanych z długotrwałej pamięci podręcznej.
Formularze i ekrany aplikacji
Formularze renderowane na podstawie schematu oraz dołączone UI, na których można budować.
Formularze schematów
Przypisz polu klucz komponentu, a bs_db_form() wyrenderuje formularz przy użyciu tych bloków, przekazując każdemu definicję pola.
Formularz w pakiecie
Z ui.enabled, bsui/form block=”…” wysyła pola do punktu końcowego tworzenia tego bloku, wyświetla każdy błąd walidacji pod odpowiednim polem i wywołuje formsuccess lub formerror.
Przykładowe aplikacje
Ustawienie ui rejestruje też przykłady app/*, takie jak app/kitchen-sink i app/chat, zbudowane z tych samych komponentów bsui.
Infrastruktura
Cron, CLI, kod konfiguracji i przenośność.
Zaplanowane zadania
Zadania cron.php rejestrują się w WP-Cron. Instalacje Composer usuwają je poleceniem wp bs teardown.
Baza danych CLI
wp bs db wyświetla listę rekordów z filtrami pól, pobiera je, tworzy, aktualizuje i usuwa, a także drukuje tabele, JSON lub CSV.
Testowanie z terminala
wp bs rpc call uruchamia funkcję z parametrami –key=value, a wp bs cron run uruchamia zadanie od razu, niezależnie od jego harmonogramu.
Pliki inicjalizacyjne
init.php i inne pliki init*.php w katalogu bloku uruchamiają się raz podczas init, na przykład w celu skonfigurowania typu wpisu.
Definicje natywne dla PHP
rpc.php i cron.php mogą zwracać klasę z metodami #[Rpc] i #[Cron] oraz wyliczeniami Access, Method i Schedule. db.php może używać Schema::make() i konstruktorów Field.
Przenośność
SQLite i JSONC są dołączone do kodu: skopiuj jeden folder, aby wdrożyć aplikację.
Oficjalny zestaw rozszerzeń
Wysokiej jakości szablony witryn, systemowe instrukcje AI i prywatna społeczność Discord. Jednorazowy zakup, dożywotnie aktualizacje.
- 500+ szablonów stron
- Instrukcje systemowe AI
- Dożywotnie aktualizacje
- Prywatna społeczność Discord