Viso ciklo blokai
Duomenų bazė, serverio funkcijos, cron ir CLI viename aplanke.
db.php
Apibrėžkite schemą, gaukite CRUD galinius taškus
<?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
Tinkintos serverio funkcijos
<?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];
},
];Kiekviena galimybė – atskirame faile
Kiekvienas failas suteikia vieną galimybę. Nereikia konfigūracijos ar registravimo kodo.
Programos blokas
blockstudio/
└── my-app/
├── block.json Bloko apibrėžtis
├── index.php Šablonas + Interactivity API
├── style.css Apriboti stiliai
├── script-inline.js Kliento logika
├── db.php Duomenų modelis + CRUD
├── rpc.php Serverio funkcijos
├── cron.php Suplanuotos užduotys
└── db/default.sqlite
Duomenų bazė
Apibrėžkite schemas ir gaukite CRUD galinius punktus.
6 saugojimo režimų
table, sqlite, jsonc, storh, meta, post_type. Rinkitės pagal perkeliamumą ir užklausų poreikius.
Storh failai
Po vieną failą kiekvienam įrašui uploads kataloge; indeksai kuriami pagal schemą, o vienalaikis įrašymas yra saugesnis. wp bs db migrate –to=storh perkelia JSONC įrašus ir išsaugo jų ID.
Lentelės ir įrašų tipai
table saugykla valdo MySQL lentelę naudodama dbDelta ir prideda naujų laukų stulpelius. post_type saugykla kiekvieną įrašą paverčia įrašu, todėl WP_Query, REST API papildiniai ir GraphQL įrankiai gali jį skaityti.
Kelios schemos
Grąžinkite pavadintas schemas iš vieno db.php. Kiekviena turi atskirą saugyklą, galinius taškus ir prieigos valdymą.
Naudotojo duomenys
Nustatykite userScoped, kad įrašai būtų automatiškai atskirti, be rankinio filtravimo.
Tikrinimas ir kabliai
Tipai, privalomos reikšmės, išvardijimai, formatai, ilgiai, atgalinio iškvietimo funkcijos ir gyvavimo ciklo kabliai.
RPC
Serverio funkcijos, iškviečiamos iš priekinės dalies.
bs.fn() klientas
Iškvieskite funkcijas iš JavaScript; įterptieji scenarijai automatiškai aptinka bloko pavadinimą.
Prieigos valdymas
Viešas su CSRF apsauga, atviras saityno kabliams arba pagrįstas galimybėmis – kiekvienai funkcijai atskirai.
Iškvietimai tarp blokų
Iškvieskite bet kurią bloko funkciją iš JavaScript ar PHP ir komponuokite logiką.
Kliento duomenų sluoksnis
Skaitykite, talpinkite ir įrašykite įrašus naršyklėje.
bs.db() klientas
Kurkite, išvardykite, gaukite, atnaujinkite ir ištrinkite įrašus iš JavaScript. list priima laukų filtrus, limit ir offset.
bs.query()
Talpykloje saugomi pagal raktą atliekami užklausimai. Vienu metu vykdomi iškvietimai dalijasi vienu promise, o staleTime praleidžia užklausą, kol duomenys yra nauji.
bs.mutate()
Optimistiškai kurkite, atnaujinkite ir ištrinkite įrašus reaktyviame būsenos masyve; jei užklausa nepavyksta, grąžinama momentinė kopija.
bs.cache
Atminties talpykla, naudojama bs.query() ir bs.mutate(). Skaitykite, nustatykite, anuliuokite arba tiesiogiai išvalykite įrašus.
Duomenų atnaujinimas realiuoju laiku
Nustatykite realiojo laiko režimą db.php, tada klientas periodiškai palygins duomenų maišą ir atnaujins Interactivity API saugyklą. Paslėptuose skirtukuose periodinis tikrinimas sustabdomas.
Talpykloje saugomi puslapiai
bs.fn() ir bs.db() pirmojo iškvietimo metu gauna naujus kredencialus iš netalpykloje esančio galinio taško, todėl viešosios užklausos veikia ir puslapiuose, pateikiamuose iš ilgai veikiančių talpyklų.
Formos ir programų ekranai
Pagal schemą sugeneruotos formos ir paruošti UI, nuo kurių galima pradėti.
Schemos formos
Priskirkite laukui komponento raktą, ir bs_db_form() pateiks formą per šiuos blokus, kiekvienam perduodama jo lauko aprašą.
Įtrauktas rinkinys
Naudojant ui.enabled, bsui/form block=”…” siunčia laukus to bloko kūrimo galiniam taškui, po kiekvienu lauku rodo jo tikrinimo klaidą ir išsiunčia formsuccess arba formerror.
Programų pavyzdžiai
Nustatymas ui taip pat užregistruoja app/* pavyzdžius, pavyzdžiui, app/kitchen-sink ir app/chat, sukurtus iš tų pačių bsui komponentų.
Infrastruktūra
Cron, CLI, parengimo kodas ir perkeliamumas.
Suplanuotos užduotys
cron.php užduotys registruojamos per WP-Cron. Composer pašalina jas vykdant wp bs teardown.
Duomenų bazės CLI
wp bs db pateikia įrašų sąrašą pagal laukų filtrus, juos gauna, kuria, atnaujina ir ištrina, o lenteles išveda kaip JSON arba CSV.
Tikrinkite terminale
wp bs rpc call paleidžia funkciją su –key=value parametrais, o wp bs cron run vykdo užduotį iškart, nepaisydama jos tvarkaraščio.
Inicijavimo failai
init.php ir kiti init*.php failai bloko aplanke paleidžiami vieną kartą per init, pavyzdžiui, norint užregistruoti įrašo tipą.
PHP savosios apibrėžtys
rpc.php ir cron.php gali grąžinti klasę su #[Rpc] ir #[Cron] metodais bei Access, Method ir Schedule enum tipais. db.php gali naudoti Schema::make() ir Field kūrimo priemones.
Perkeliamumas
SQLite ir JSONC keliauja kartu su kodu: nukopijuokite vieną aplanką, kad įdiegtumėte programą.
Oficialus plėtinių rinkinys
Aukščiausios klasės svetainių šablonai, DI sistemos instrukcijos ir privati Discord bendruomenė. Vienkartinis pirkimas, atnaujinimai visam laikui.
- 500+ svetainių šablonų
- AI sistemos instrukcijos
- Naujiniai visam laikui
- Privati Discord bendruomenė