# Viso ciklo blokai

Duomenų bazė, serverio funkcijos, cron ir CLI viename aplanke.

[Skaityti vadovą](https://blockstudio.dev/lt/guides/full-stack-blocks/)

## db.php

Apibrėžkite schemą, gaukite CRUD galinius taškus

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

Tinkintos serverio funkcijos

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];
  },
];
```

## 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ų](https://blockstudio.dev/lt/docs/blocks/block-api/database/#storage-modes)

table, sqlite, jsonc, storh, meta, post_type. Rinkitės pagal perkeliamumą ir užklausų poreikius.

## [Storh failai](https://blockstudio.dev/lt/docs/blocks/block-api/database/#storh-files-storage-storh)

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](https://blockstudio.dev/lt/docs/blocks/block-api/database/#custom-table-storage-table)

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](https://blockstudio.dev/lt/docs/blocks/block-api/database/#multiple-schemas)

Grąžinkite pavadintas schemas iš vieno db.php. Kiekviena turi atskirą saugyklą, galinius taškus ir prieigos valdymą.

## [Naudotojo duomenys](https://blockstudio.dev/lt/docs/blocks/block-api/database/#user-scoped-data)

Nustatykite userScoped, kad įrašai būtų automatiškai atskirti, be rankinio filtravimo.

## [Tikrinimas ir kabliai](https://blockstudio.dev/lt/docs/blocks/block-api/database/#validation)

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](https://blockstudio.dev/lt/docs/blocks/block-api/rpc/#calling-from-javascript)

Iškvieskite funkcijas iš JavaScript; įterptieji scenarijai automatiškai aptinka bloko pavadinimą.

## [Prieigos valdymas](https://blockstudio.dev/lt/docs/blocks/block-api/rpc/#access-control)

Viešas su CSRF apsauga, atviras saityno kabliams arba pagrįstas galimybėmis – kiekvienai funkcijai atskirai.

## [Iškvietimai tarp blokų](https://blockstudio.dev/lt/docs/blocks/block-api/rpc/#cross-block-calling)

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](https://blockstudio.dev/lt/docs/blocks/block-api/database/#javascript-client)

Kurkite, išvardykite, gaukite, atnaujinkite ir ištrinkite įrašus iš JavaScript. list priima laukų filtrus, limit ir offset.

## [bs.query()](https://blockstudio.dev/lt/docs/blocks/block-api/database/#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()](https://blockstudio.dev/lt/docs/blocks/block-api/database/#mutate)

Optimistiškai kurkite, atnaujinkite ir ištrinkite įrašus reaktyviame būsenos masyve; jei užklausa nepavyksta, grąžinama momentinė kopija.

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

Atminties talpykla, naudojama bs.query() ir bs.mutate(). Skaitykite, nustatykite, anuliuokite arba tiesiogiai išvalykite įrašus.

## [Duomenų atnaujinimas realiuoju laiku](https://blockstudio.dev/lt/docs/blocks/block-api/database/#realtime-polling)

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](https://blockstudio.dev/lt/docs/blocks/block-api/rpc/#cached-pages)

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](https://blockstudio.dev/lt/docs/blocks/block-api/database/#form-rendering)

Priskirkite laukui komponento raktą, ir bs_db_form() pateiks formą per šiuos blokus, kiekvienam perduodama jo lauko aprašą.

## [Įtrauktas rinkinys](https://blockstudio.dev/lt/guides/ui-app-screen/#step-4-the-template)

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](https://blockstudio.dev/lt/docs/general/settings/#ui)

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](https://blockstudio.dev/lt/docs/blocks/block-api/cron/)

cron.php užduotys registruojamos per WP-Cron. Composer pašalina jas vykdant wp bs teardown.

## [Duomenų bazės CLI](https://blockstudio.dev/lt/docs/dev/cli/#database)

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](https://blockstudio.dev/lt/docs/dev/cli/#call-a-function)

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](https://blockstudio.dev/lt/docs/blocks/block-api/initialization/)

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](https://blockstudio.dev/lt/docs/blocks/block-api/rpc/#php-native-definitions)

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](https://blockstudio.dev/lt/guides/full-stack-blocks/)

SQLite ir JSONC keliauja kartu su kodu: nukopijuokite vieną aplanką, kad įdiegtumėte programą.

Plus

## 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ė

[Gaukite Plus](https://blockstudio.dev/lt/plus/)
