# Bloques de pila completa

Base de datos, funciones del servidor, cron y CLI en una carpeta.

[Leer la guía](https://blockstudio.dev/es/guides/full-stack-blocks/)

## db.php

Define un esquema y obtén puntos de conexión 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

Funciones personalizadas del 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 capacidad es un archivo

Cada archivo añade una capacidad. Sin configuración ni código de registro.

Bloque de aplicación

blockstudio/

└── my-app/

├── block.json Definición del bloque

├── index.php Plantilla + Interactividad API

├── style.css Estilos con ámbito

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

├── db.php Modelo de datos + CRUD

├── rpc.php Funciones del servidor

├── cron.php Tareas programadas

└── db/default.sqlite

## Base de datos

Define esquemas y obtén endpoints CRUD.

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

table, sqlite, jsonc, storh, meta, post_type. Elige según la portabilidad y las necesidades de consulta.

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

Un archivo por registro en uploads, con índices creados a partir del esquema y escrituras simultáneas más seguras. wp bs db migrate –to=storh transfiere JSONC registros y conserva sus ID.

## [Tablas y tipos de contenido](https://blockstudio.dev/es/docs/blocks/block-api/database/#custom-table-storage-table)

El almacenamiento en tabla gestiona una tabla MySQL con dbDelta y añade columnas para los campos nuevos. El almacenamiento post_type convierte cada registro en una entrada, para que WP_Query, los plugins REST API y las herramientas GraphQL puedan leerlo.

## [Varios esquemas](https://blockstudio.dev/es/docs/blocks/block-api/database/#multiple-schemas)

Devuelve esquemas con nombre desde un db.php. Cada uno tiene su propio almacenamiento, endpoints y control de acceso.

## [Datos aislados por usuario](https://blockstudio.dev/es/docs/blocks/block-api/database/#user-scoped-data)

Activa userScoped para aislar registros automáticamente, sin filtros manuales.

## [Validación y hooks](https://blockstudio.dev/es/docs/blocks/block-api/database/#validation)

Tipos, valores obligatorios, enumeraciones, formatos, longitudes, funciones de retorno y hooks del ciclo de vida.

## RPC

Funciones del servidor invocables desde el frontend.

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

Invoca funciones desde JavaScript; los scripts en línea detectan automáticamente el nombre del bloque.

## [Control de acceso](https://blockstudio.dev/es/docs/blocks/block-api/rpc/#access-control)

Público con CSRF, abierto para webhooks o basado en capacidades, por función.

## [Llamadas entre bloques](https://blockstudio.dev/es/docs/blocks/block-api/rpc/#cross-block-calling)

Invoca cualquier función de bloque desde JavaScript o PHP y combina la lógica.

## Capa de datos del cliente

Lee, almacena en caché y escribe registros desde el navegador.

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

Crea, enumera, obtiene, actualiza y elimina registros desde JavaScript. list acepta filtros de campo, límite y desplazamiento.

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

Solicitudes fetch almacenadas en caché por clave. Las llamadas en curso comparten una promesa y staleTime omite la solicitud mientras los datos siguen vigentes.

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

Creación, actualización y eliminación optimistas en una matriz de estado reactiva, con reversión a una instantánea si falla la solicitud.

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

La caché en memoria detrás de bs.query() y bs.mutate(). Lee, establece, invalida o borra entradas directamente.

## [Sondeo en tiempo real](https://blockstudio.dev/es/docs/blocks/block-api/database/#realtime-polling)

Activa el tiempo real en db.php y el cliente compara un hash de datos a intervalos, luego actualiza el almacén de Interactivity API. El sondeo se pausa en las pestañas ocultas.

## [Páginas en caché](https://blockstudio.dev/es/docs/blocks/block-api/rpc/#cached-pages)

bs.fn() y bs.db() obtienen credenciales nuevas desde un endpoint sin caché en la primera llamada, para que las llamadas públicas sigan funcionando en páginas servidas desde cachés de larga duración.

## Formularios y pantallas de aplicaciones

Formularios generados a partir del esquema y UI incluidos para construir sobre ellos.

## [Formularios de esquema](https://blockstudio.dev/es/docs/blocks/block-api/database/#form-rendering)

Asigna una clave de componente a un campo y bs_db_form() genera el formulario mediante esos bloques, pasando a cada uno la definición del campo.

## [Formulario incluido](https://blockstudio.dev/es/guides/ui-app-screen/#step-4-the-template)

Con ui.enabled, bsui/form block=”…” envía sus campos al endpoint de creación de ese bloque, muestra cada error de validación debajo del campo correspondiente y activa formsuccess o formerror.

## [Aplicaciones de ejemplo](https://blockstudio.dev/es/docs/general/settings/#ui)

La opción ui también registra los ejemplos app/*, como app/kitchen-sink y app/chat, creados con los mismos componentes bsui.

## Infraestructura

Cron, CLI, código de configuración y portabilidad.

## [Tareas programadas](https://blockstudio.dev/es/docs/blocks/block-api/cron/)

Los trabajos cron.php se registran con WP-Cron. Las instalaciones de Composer los eliminan con wp bs teardown.

## [CLI de base de datos](https://blockstudio.dev/es/docs/dev/cli/#database)

wp bs db enumera registros con filtros de campo y permite obtenerlos, crearlos, actualizarlos y eliminarlos; además, imprime tablas, JSON o CSV.

## [Prueba desde la terminal](https://blockstudio.dev/es/docs/dev/cli/#call-a-function)

wp bs rpc call ejecuta una función con parámetros –key=value, y wp bs cron run ejecuta una tarea ahora, independientemente de su programación.

## [Archivos de inicialización](https://blockstudio.dev/es/docs/blocks/block-api/initialization/)

init.php y otros archivos init*.php de una carpeta de bloque se ejecutan una vez durante init, para tareas de configuración como registrar un tipo de contenido.

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

rpc.php y cron.php pueden devolver una clase con métodos #[Rpc] y #[Cron], y con los enums Access, Method y Schedule. db.php puede usar Schema::make() y constructores Field.

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

SQLite y JSONC viajan con el código: copia una carpeta para desplegar la aplicación.

Plus

## El kit oficial de extensiones

Plantillas de sitio prémium, instrucciones de sistema para IA y una comunidad privada de Discord. Compra única, actualizaciones de por vida.

- Más de 500 plantillas de sitios web
- Instrucciones del sistema de IA
- Actualizaciones de por vida
- Comunidad privada de Discord

[Obtener Plus](https://blockstudio.dev/es/plus/)
