# Blocos full-stack

Banco de dados, funções de servidor, cron e CLI em uma pasta.

[Leia o guia](https://blockstudio.dev/pt/guides/full-stack-blocks/)

## db.php

Defina o esquema e obtenha endpoints 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

Funções personalizadas no servidor

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

## Cada recurso é um arquivo

Cada arquivo adiciona um recurso. Sem configuração nem código de registro.

Bloco de aplicativo

blockstudio/

└── my-app/

├── block.json Definição do bloco

├── index.php Modelo + Interactivity API

├── style.css Estilos com escopo definido

├── script-inline.js Lógica do cliente

├── db.php Modelo de dados + CRUD

├── rpc.php Funções do servidor

├── cron.php Tarefas agendadas

└── db/default.sqlite

## Banco de dados

Defina esquemas e obtenha endpoints CRUD.

## [6 modos de armazenamento](https://blockstudio.dev/pt/docs/blocks/block-api/database/#storage-modes)

table, sqlite, jsonc, storh, meta, post_type. Escolha conforme a portabilidade e as necessidades de consulta.

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

Um arquivo por registro em uploads, com índices criados a partir do esquema e gravações simultâneas mais seguras. wp bs db migrate –to=storh migra registros de JSONC e mantém seus IDs.

## [Tabelas e tipos de post](https://blockstudio.dev/pt/docs/blocks/block-api/database/#custom-table-storage-table)

O armazenamento em tabela gerencia uma tabela MySQL com dbDelta e adiciona colunas para novos campos. O armazenamento post_type transforma cada registro em um post, que WP_Query, plugins REST API e ferramentas GraphQL podem ler.

## [Vários esquemas](https://blockstudio.dev/pt/docs/blocks/block-api/database/#multiple-schemas)

Retorne esquemas nomeados de um único db.php. Cada um tem seu próprio armazenamento, endpoints e controle de acesso.

## [Dados vinculados ao usuário](https://blockstudio.dev/pt/docs/blocks/block-api/database/#user-scoped-data)

Defina userScoped para isolar registros automaticamente, sem filtragem manual.

## [Validação e hooks](https://blockstudio.dev/pt/docs/blocks/block-api/database/#validation)

Tipos, valores obrigatórios, enums, formatos, comprimentos, callbacks e hooks de ciclo de vida.

## RPC

Funções de servidor que podem ser chamadas pelo frontend.

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

Chame funções de JavaScript; scripts inline detectam automaticamente o nome do bloco.

## [Controle de acesso](https://blockstudio.dev/pt/docs/blocks/block-api/rpc/#access-control)

Público com CSRF, aberto para webhooks ou baseado em permissões, por função.

## [Chamadas entre blocos](https://blockstudio.dev/pt/docs/blocks/block-api/rpc/#cross-block-calling)

Chame qualquer função de bloco de JavaScript ou PHP e combine a lógica.

## Camada de dados do cliente

Leia, armazene em cache e grave registros pelo navegador.

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

Crie, liste, obtenha, atualize e exclua registros de JavaScript. list aceita filtros por campo, limite e deslocamento.

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

Buscas em cache por chave. Chamadas em andamento compartilham uma promessa, e staleTime ignora a solicitação enquanto os dados estiverem atualizados.

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

Criação, atualização e exclusão otimistas em um array de estado reativo, restaurado para um instantâneo quando a solicitação falha.

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

O cache em memória por trás de bs.query() e bs.mutate(). Leia, defina, invalide ou limpe entradas diretamente.

## [Consulta periódica em tempo real](https://blockstudio.dev/pt/docs/blocks/block-api/database/#realtime-polling)

Ative o modo em tempo real em db.php; o cliente compara um hash dos dados em intervalos e, em seguida, atualiza o armazenamento de Interactivity API. A consulta é pausada em abas ocultas.

## [Páginas em cache](https://blockstudio.dev/pt/docs/blocks/block-api/rpc/#cached-pages)

bs.fn() e bs.db() buscam credenciais atualizadas em um endpoint sem cache na primeira chamada, para que chamadas públicas continuem funcionando em páginas servidas por caches de longa duração.

## Formulários e telas do app

Formulários renderizados a partir do esquema e UI integrados para servir de base.

## [Formulários do esquema](https://blockstudio.dev/pt/docs/blocks/block-api/database/#form-rendering)

Defina uma chave de componente para um campo e bs_db_form() renderizará o formulário por meio desses blocos, passando a definição do campo para cada um.

## [Formulário incluído](https://blockstudio.dev/pt/guides/ui-app-screen/#step-4-the-template)

Com ui.enabled, bsui/form block=”…” envia os campos para o endpoint de criação desse bloco, mostra cada erro de validação abaixo do campo correspondente e dispara formSuccess ou formError.

## [Apps de exemplo](https://blockstudio.dev/pt/docs/general/settings/#ui)

A configuração ui também registra os exemplos app/*, como app/kitchen-sink e app/chat, criados com os mesmos componentes bsui.

## Infraestrutura

Cron, CLI, código de configuração e portabilidade.

## [Tarefas agendadas](https://blockstudio.dev/pt/docs/blocks/block-api/cron/)

Tarefas cron.php são registradas com WP-Cron. As instalações de Composer as removem com wp bs teardown.

## [CLI de banco de dados](https://blockstudio.dev/pt/docs/dev/cli/#database)

wp bs db lista registros com filtros por campo, permite obtê-los, criá-los, atualizá-los e excluí-los, e exibe tabelas, JSON ou CSV.

## [Teste pelo terminal](https://blockstudio.dev/pt/docs/dev/cli/#call-a-function)

wp bs rpc call executa uma função com parâmetros –key=value, e wp bs cron run executa um trabalho agora, independentemente da programação.

## [Arquivos de inicialização](https://blockstudio.dev/pt/docs/blocks/block-api/initialization/)

init.php e outros arquivos init*.php em uma pasta de bloco são executados uma vez em init, para tarefas de configuração, como registrar um tipo de post.

## [Definições nativas de PHP](https://blockstudio.dev/pt/docs/blocks/block-api/rpc/#php-native-definitions)

rpc.php e cron.php podem retornar uma classe com métodos #[Rpc] e #[Cron], além dos enums Access, Method e Schedule. db.php pode usar Schema::make() e construtores Field.

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

SQLite e JSONC acompanham o código: copie uma pasta para implantar o aplicativo.

Plus

## O kit oficial de extensões

Modelos premium de site, instruções de sistema para IA e uma comunidade privada Discord. Compra única, atualizações vitalícias.

- 500+ modelos de sites
- Instruções de sistema para IA
- Atualizações vitalícias
- Comunidade privada de Discord

[Obter Plus](https://blockstudio.dev/pt/plus/)
