# Blocs full-stack

Base de données, fonctions serveur, cron et CLI dans un seul dossier.

[Lire le guide](https://blockstudio.dev/fr/guides/full-stack-blocks/)

## db.php

Définissez un schéma, obtenez des points de terminaison 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

Fonctions serveur personnalisées

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

## Chaque fonctionnalité est un fichier

Chaque fichier ajoute une fonctionnalité. Aucune configuration ni code d’enregistrement.

Bloc d’application

blockstudio/

└── my-app/

├── block.json Définition du bloc

├── index.php Modèle + interactivité API

├── style.css Styles délimités

├── script-inline.js Logique côté client

├── db.php Modèle de données + CRUD

├── rpc.php Fonctions serveur

├── cron.php Tâches planifiées

└── db/default.sqlite

## Base de données

Définissez des schémas, obtenez des points de terminaison CRUD.

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

table, sqlite, jsonc, storh, meta, post_type. Choisissez selon les besoins de portabilité et de requêtes.

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

Un fichier par enregistrement dans uploads, avec des index générés à partir du schéma et des écritures simultanées plus sûres. wp bs db migrate –to=storh transfère JSONC enregistrements et conserve leurs identifiants.

## [Tables et types de publication](https://blockstudio.dev/fr/docs/blocks/block-api/database/#custom-table-storage-table)

Le stockage en table gère une table MySQL avec dbDelta et ajoute des colonnes pour les nouveaux champs. Le stockage en post_type crée un article pour chaque enregistrement, que WP_Query, les extensions REST API et les outils GraphQL peuvent lire.

## [Schémas multiples](https://blockstudio.dev/fr/docs/blocks/block-api/database/#multiple-schemas)

Renvoyez des schémas nommés depuis un seul db.php. Chacun dispose de son propre stockage, de ses points de terminaison et de son contrôle d’accès.

## [Données associées à l’utilisateur](https://blockstudio.dev/fr/docs/blocks/block-api/database/#user-scoped-data)

Définissez userScoped pour isoler automatiquement les enregistrements, sans filtrage manuel.

## [Validation et hooks](https://blockstudio.dev/fr/docs/blocks/block-api/database/#validation)

Types, valeurs requises, énumérations, formats, longueurs, fonctions de rappel et hooks de cycle de vie.

## RPC

Fonctions serveur appelables depuis l’interface frontend.

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

Appelez les fonctions depuis JavaScript ; les scripts intégrés détectent automatiquement le nom du bloc.

## [Contrôle d’accès](https://blockstudio.dev/fr/docs/blocks/block-api/rpc/#access-control)

Public avec CSRF, ouvert aux webhooks ou fondé sur les capacités, selon la fonction.

## [Appels entre blocs](https://blockstudio.dev/fr/docs/blocks/block-api/rpc/#cross-block-calling)

Appelez toute fonction de bloc depuis JavaScript ou PHP et composez votre logique.

## Couche de données client

Lire, mettre en cache et écrire des enregistrements depuis le navigateur.

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

Créer, lister, récupérer, mettre à jour et supprimer des enregistrements depuis JavaScript. list accepte des filtres de champs, une limite et un décalage.

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

Récupérations mises en cache par clé. Les appels en cours partagent une promesse, et staleTime évite la requête tant que les données sont à jour.

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

Création, mise à jour et suppression optimistes dans un tableau d’état réactif, avec retour à un instantané en cas d’échec de la requête.

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

Le cache en mémoire derrière bs.query() et bs.mutate(). Lisez, définissez, invalidez ou effacez directement ses entrées.

## [Interrogation périodique en temps réel](https://blockstudio.dev/fr/docs/blocks/block-api/database/#realtime-polling)

Activez le mode temps réel dans db.php : le client compare un hachage des données à intervalle régulier, puis met à jour le magasin Interactivity API. L’interrogation périodique s’interrompt dans les onglets masqués.

## [Pages mises en cache](https://blockstudio.dev/fr/docs/blocks/block-api/rpc/#cached-pages)

bs.fn() et bs.db() récupèrent des identifiants à jour auprès d’un point de terminaison non mis en cache lors du premier appel. Ainsi, les appels publics continuent de fonctionner sur les pages servies depuis des caches de longue durée.

## Formulaires et écrans d’application

Des formulaires générés à partir du schéma et des éléments UI intégrés pour démarrer.

## [Formulaires de schéma](https://blockstudio.dev/fr/docs/blocks/block-api/database/#form-rendering)

Attribuez une clé de composant à un champ et bs_db_form() génère le formulaire à l’aide de ces blocs, en transmettant à chacun la définition de son champ.

## [Formulaire groupé](https://blockstudio.dev/fr/guides/ui-app-screen/#step-4-the-template)

Avec ui.enabled, bsui/form block=”…” envoie ses champs au point de terminaison de création de ce bloc, affiche chaque erreur de validation sous le champ concerné et déclenche formssuccess ou formerror.

## [Applications d’exemple](https://blockstudio.dev/fr/docs/general/settings/#ui)

Le paramètre ui enregistre aussi les exemples app/*, comme app/kitchen-sink et app/chat, construits à partir des mêmes composants bsui.

## Infrastructure

Cron, CLI, code de configuration et portabilité.

## [Tâches planifiées](https://blockstudio.dev/fr/docs/blocks/block-api/cron/)

Les tâches cron.php sont enregistrées auprès de WP-Cron. Les installations de Composer les suppriment avec wp bs teardown.

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

wp bs db liste les enregistrements avec des filtres de champs, les récupère, les crée, les met à jour et les supprime, puis affiche des tableaux, JSON ou CSV.

## [Tester depuis le terminal](https://blockstudio.dev/fr/docs/dev/cli/#call-a-function)

wp bs rpc call exécute une fonction avec des paramètres –key=value, et wp bs cron run lance immédiatement une tâche, quel que soit son calendrier.

## [Fichiers d’initialisation](https://blockstudio.dev/fr/docs/blocks/block-api/initialization/)

init.php et les autres fichiers init*.php d’un dossier de bloc s’exécutent une fois lors de init, pour des opérations de configuration comme l’enregistrement d’un type de publication.

## [Définitions natives PHP](https://blockstudio.dev/fr/docs/blocks/block-api/rpc/#php-native-definitions)

rpc.php et cron.php peuvent renvoyer une classe avec des méthodes #[Rpc] et #[Cron], ainsi que les énumérations Access, Method et Schedule. db.php peut utiliser Schema::make() et des constructeurs de champs.

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

SQLite et JSONC accompagnent le code : copiez un dossier pour déployer l’application.

Plus

## Le kit d’extension officiel

Modèles de site premium, instructions système pour l’IA et communauté privée Discord. Achat unique, mises à jour à vie.

- 500+ modèles de sites
- Instructions système de l’IA
- Mises à jour à vie
- Communauté privée Discord

[Obtenir Plus](https://blockstudio.dev/fr/plus/)
