# Blocchi full stack

Database, funzioni server, cron e CLI in un’unica cartella.

[Leggi la guida](https://blockstudio.dev/it/guides/full-stack-blocks/)

## db.php

Definisci lo schema, ottieni endpoint 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

Funzioni server personalizzate

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

## Ogni funzionalità è un file

Ogni file aggiunge una funzionalità. Nessuna configurazione né codice di registrazione.

Blocco applicativo

blockstudio/

└── my-app/

├── block.json Definizione del blocco

├── index.php Template + Interactivity API

├── style.css Stili con ambito limitato

├── script-inline.js Logica lato client

├── db.php Modello dati + CRUD

├── rpc.php Funzioni server

├── cron.php Attività pianificate

└── db/default.sqlite

## Database

Definisci schemi e ottieni endpoint CRUD.

## [6 modalità di archiviazione](https://blockstudio.dev/it/docs/blocks/block-api/database/#storage-modes)

table, sqlite, jsonc, storh, meta, post_type. Scegli in base alla portabilità e alle esigenze di query.

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

Un file per record in uploads, con indici creati dallo schema e scritture simultanee più sicure. wp bs db migrate –to=storh trasferisce i record JSONC e ne mantiene gli ID.

## [Tabelle e tipi di contenuto](https://blockstudio.dev/it/docs/blocks/block-api/database/#custom-table-storage-table)

L’archiviazione in tabella gestisce una tabella MySQL con dbDelta e aggiunge colonne per i nuovi campi. L’archiviazione post_type crea un post per ogni record, così WP_Query, i plugin REST API e gli strumenti GraphQL possono leggerlo.

## [Più schemi](https://blockstudio.dev/it/docs/blocks/block-api/database/#multiple-schemas)

Restituisci schemi con nome da un unico db.php. Ognuno ha archiviazione, endpoint e controlli di accesso propri.

## [Dati associati all’utente](https://blockstudio.dev/it/docs/blocks/block-api/database/#user-scoped-data)

Imposta userScoped per isolare automaticamente i record, senza filtrarli manualmente.

## [Validazione e hook](https://blockstudio.dev/it/docs/blocks/block-api/database/#validation)

Tipi, valori obbligatori, enumerazioni, formati, lunghezze, callback e hook del ciclo di vita.

## RPC

Funzioni server richiamabili dal frontend.

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

Richiama funzioni da JavaScript; gli script inline rilevano automaticamente il nome del blocco.

## [Controllo degli accessi](https://blockstudio.dev/it/docs/blocks/block-api/rpc/#access-control)

Pubblico con CSRF, aperto per webhook o basato su capability, per ogni funzione.

## [Chiamate tra blocchi](https://blockstudio.dev/it/docs/blocks/block-api/rpc/#cross-block-calling)

Richiama qualsiasi funzione di blocco da JavaScript o PHP e componi la logica.

## Livello dati lato client

Leggi, memorizza nella cache e scrivi record dal browser.

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

Crea, elenca, recupera, aggiorna ed elimina record da JavaScript. list accetta filtri per campo, limite e offset.

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

Richieste fetch memorizzate nella cache per chiave. Le chiamate in corso condividono una promise e staleTime evita la richiesta finché i dati sono aggiornati.

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

Creazione, aggiornamento ed eliminazione ottimistici in un array di stato reattivo, ripristinato a uno snapshot se la richiesta non riesce.

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

La cache in memoria dietro bs.query() e bs.mutate(). Leggi, imposta, invalida o svuota direttamente le voci.

## [Polling in tempo reale](https://blockstudio.dev/it/docs/blocks/block-api/database/#realtime-polling)

Imposta il tempo reale in db.php: il client confronta periodicamente un hash dei dati e aggiorna lo store Interactivity API. Il polling si interrompe nelle schede nascoste.

## [Pagine memorizzate nella cache](https://blockstudio.dev/it/docs/blocks/block-api/rpc/#cached-pages)

bs.fn() e bs.db() recuperano credenziali aggiornate da un endpoint non memorizzato nella cache alla prima chiamata, così le chiamate pubbliche continuano a funzionare sulle pagine servite da cache di lunga durata.

## Moduli e schermate dell’app

Moduli generati dallo schema e UI integrati da cui partire.

## [Moduli basati sullo schema](https://blockstudio.dev/it/docs/blocks/block-api/database/#form-rendering)

Assegna a un campo una chiave componente e bs_db_form() genera il modulo tramite quei blocchi, passando a ciascuno la definizione del campo.

## [Modulo incluso](https://blockstudio.dev/it/guides/ui-app-screen/#step-4-the-template)

Con ui.enabled, bsui/form block=”…” invia i campi all’endpoint di creazione di quel blocco, mostra ogni errore di convalida sotto il relativo campo e attiva formsuccess o formerror.

## [App di esempio](https://blockstudio.dev/it/docs/general/settings/#ui)

Anche l’impostazione ui registra gli esempi app/*, come app/kitchen-sink e app/chat, realizzati con gli stessi componenti bsui.

## Infrastruttura

Cron, CLI, codice di configurazione e portabilità.

## [Attività pianificate](https://blockstudio.dev/it/docs/blocks/block-api/cron/)

I processi cron.php si registrano con WP-Cron. Le installazioni Composer li rimuovono con wp bs teardown.

## [CLI del database](https://blockstudio.dev/it/docs/dev/cli/#database)

wp bs db elenca i record con filtri per campo, li recupera, crea, aggiorna ed elimina e stampa tabelle, JSON o CSV.

## [Esegui i test dal terminale](https://blockstudio.dev/it/docs/dev/cli/#call-a-function)

wp bs rpc call esegue una funzione con parametri –key=value e wp bs cron run avvia subito un’attività, indipendentemente dalla sua pianificazione.

## [File di inizializzazione](https://blockstudio.dev/it/docs/blocks/block-api/initialization/)

init.php e gli altri file init*.php in una cartella di blocco vengono eseguiti una volta durante init, per attività di configurazione come la registrazione di un tipo di contenuto.

## [Definizioni native di PHP](https://blockstudio.dev/it/docs/blocks/block-api/rpc/#php-native-definitions)

rpc.php e cron.php possono restituire una classe con metodi #[Rpc] e #[Cron] e gli enum Access, Method e Schedule. db.php può usare Schema::make() e i builder Field.

## [Portabilità](https://blockstudio.dev/it/guides/full-stack-blocks/)

SQLite e JSONC viaggiano con il codice: basta copiare una cartella per distribuire l’app.

Plus

## Il kit ufficiale di estensioni

Template di siti premium, istruzioni di sistema per l’AI e una community privata Discord. Acquisto una tantum, aggiornamenti a vita.

- Oltre 500 modelli di siti
- Istruzioni di sistema per l’AI
- Aggiornamenti a vita
- Community privata di Discord

[Passa a Plus](https://blockstudio.dev/it/plus/)
