# Blocuri full-stack

Baza de date, funcțiile de server, cron și CLI într-un singur folder.

[Citiți ghidul](https://blockstudio.dev/ro/guides/full-stack-blocks/)

## db.php

Definiți schema, obțineți endpointuri 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

Funcții personalizate pentru server

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

## Fiecare funcționalitate este un fișier

Fiecare fișier adaugă o funcționalitate. Fără configurare și fără cod de înregistrare.

Bloc de aplicație

blockstudio/

└── my-app/

├── block.json Definiția blocului

├── index.php Șablon + Interactivity API

├── style.css Stiluri delimitate

├── script-inline.js Logică pe client

├── db.php Model de date + CRUD

├── rpc.php Funcții pentru server

├── cron.php Sarcini programate

└── db/default.sqlite

## Bază de date

Definiți scheme și obțineți puncte finale CRUD.

## [6 moduri de stocare](https://blockstudio.dev/ro/docs/blocks/block-api/database/#storage-modes)

table, sqlite, jsonc, storh, meta, post_type. Alegeți în funcție de portabilitate și nevoile de interogare.

## [Fișiere Storh](https://blockstudio.dev/ro/docs/blocks/block-api/database/#storh-files-storage-storh)

Un fișier pentru fiecare înregistrare în uploads, cu indexuri construite din schemă și scrieri concurente mai sigure. wp bs db migrate –to=storh mută JSONC înregistrări și le păstrează ID-urile.

## [Tabele și tipuri de articole](https://blockstudio.dev/ro/docs/blocks/block-api/database/#custom-table-storage-table)

Stocarea în tabele gestionează un tabel MySQL cu dbDelta și adaugă coloane pentru câmpurile noi. Stocarea post_type transformă fiecare înregistrare într-un articol, astfel încât WP_Query, pluginurile REST API și instrumentele GraphQL să o poată citi.

## [Mai multe scheme](https://blockstudio.dev/ro/docs/blocks/block-api/database/#multiple-schemas)

Returnați scheme denumite dintr-un singur db.php. Fiecare are propria stocare, propriile endpointuri și propriul control al accesului.

## [Date asociate utilizatorului](https://blockstudio.dev/ro/docs/blocks/block-api/database/#user-scoped-data)

Setați userScoped pentru a izola automat înregistrările, fără filtrare manuală.

## [Validare și hook-uri](https://blockstudio.dev/ro/docs/blocks/block-api/database/#validation)

Tipuri, valori obligatorii, enumerări, formate, lungimi, funcții callback și hook-uri pentru ciclul de viață.

## RPC

Funcții de server apelabile din interfața frontend.

## [Client bs.fn()](https://blockstudio.dev/ro/docs/blocks/block-api/rpc/#calling-from-javascript)

Apelați funcții din JavaScript; scripturile inline detectează automat numele blocului.

## [Controlul accesului](https://blockstudio.dev/ro/docs/blocks/block-api/rpc/#access-control)

Public cu CSRF, deschis pentru webhook-uri sau bazat pe capabilități, pentru fiecare funcție.

## [Apeluri între blocuri](https://blockstudio.dev/ro/docs/blocks/block-api/rpc/#cross-block-calling)

Apelați orice funcție de bloc din JavaScript sau PHP și compuneți logica.

## Stratul de date pentru client

Citiți, memorați în cache și scrieți înregistrări din browser.

## [clientul bs.db()](https://blockstudio.dev/ro/docs/blocks/block-api/database/#javascript-client)

Creați, listați, obțineți, actualizați și ștergeți înregistrări din JavaScript. list acceptă filtre pentru câmpuri, limită și offset.

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

Preluări memorate în cache după cheie. Apelurile în curs partajează aceeași promisiune, iar staleTime omite cererea cât timp datele sunt actualizate.

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

Creare, actualizare și ștergere optimiste într-o matrice de stare reactivă, revenind la un instantaneu dacă cererea eșuează.

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

Cache-ul din memorie din spatele bs.query() și bs.mutate(). Citiți, setați, invalidați sau ștergeți direct intrările.

## [Interogare periodică în timp real](https://blockstudio.dev/ro/docs/blocks/block-api/database/#realtime-polling)

Activați timpul real în db.php, iar clientul compară periodic un hash al datelor, apoi actualizează stocarea Interactivity API. Interogarea periodică se oprește în filele ascunse.

## [Pagini memorate în cache](https://blockstudio.dev/ro/docs/blocks/block-api/rpc/#cached-pages)

bs.fn() și bs.db() preiau acreditări actualizate de la un endpoint care nu este memorat în cache la primul apel, astfel încât apelurile publice să funcționeze în continuare pe paginile servite din cache-uri cu durată lungă.

## Formulare și ecrane de aplicație

Formulare randate din schemă și UI incluse pentru a construi aplicații.

## [Formulare bazate pe schemă](https://blockstudio.dev/ro/docs/blocks/block-api/database/#form-rendering)

Atribuiți unui câmp o cheie de componentă, iar bs_db_form() randează formularul prin acele blocuri, transmițând fiecăruia definiția câmpului.

## [Formular inclus](https://blockstudio.dev/ro/guides/ui-app-screen/#step-4-the-template)

Cu ui.enabled, bsui/form block=”…” trimite câmpurile la endpointul de creare al blocului, afișează fiecare eroare de validare sub câmpul corespunzător și declanșează formsuccess sau formerror.

## [Aplicații exemplu](https://blockstudio.dev/ro/docs/general/settings/#ui)

Setarea ui înregistrează și exemplele app/*, precum app/kitchen-sink și app/chat, construite cu aceleași componente bsui.

## Infrastructură

Cron, CLI, cod de configurare și portabilitate.

## [Sarcini programate](https://blockstudio.dev/ro/docs/blocks/block-api/cron/)

Sarcinile cron.php se înregistrează în WP-Cron. Dezinstalările Composer le elimină cu wp bs teardown.

## [CLI pentru baza de date](https://blockstudio.dev/ro/docs/dev/cli/#database)

wp bs db listează înregistrări cu filtre pentru câmpuri, le obține, creează, actualizează și șterge, apoi afișează tabele, JSON sau CSV.

## [Testați din terminal](https://blockstudio.dev/ro/docs/dev/cli/#call-a-function)

wp bs rpc call rulează o funcție cu parametri –key=value, iar wp bs cron run execută imediat o sarcină, indiferent de programarea ei.

## [Fișiere de inițializare](https://blockstudio.dev/ro/docs/blocks/block-api/initialization/)

init.php și alte fișiere init*.php dintr-un dosar de bloc rulează o dată la init, pentru configurări precum înregistrarea unui tip de articol.

## [Definiții native pentru PHP](https://blockstudio.dev/ro/docs/blocks/block-api/rpc/#php-native-definitions)

rpc.php și cron.php pot returna o clasă cu metode #[Rpc] și #[Cron] și enumerările Access, Method și Schedule. db.php poate folosi Schema::make() și constructori Field.

## [Portabilitate](https://blockstudio.dev/ro/guides/full-stack-blocks/)

SQLite și JSONC călătoresc împreună cu codul: copiați un folder pentru a implementa aplicația.

Plus

## Kitul oficial de extensii

Șabloane premium de site, instrucțiuni de sistem pentru AI și o comunitate privată Discord. Achiziție unică, actualizări pe viață.

- 500+ șabloane de site
- Instrucțiuni de sistem pentru IA
- Actualizări pe viață
- Comunitate privată Discord

[Obțineți Plus](https://blockstudio.dev/ro/plus/)
