# Blok full-stack

Basis data, fungsi server, cron, dan CLI dalam satu folder.

[Baca panduan](https://blockstudio.dev/id/guides/full-stack-blocks/)

## db.php

Tentukan skema, dapatkan 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

Fungsi server kustom

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

## Setiap kapabilitas berupa berkas

Setiap berkas menambahkan satu kapabilitas. Tanpa konfigurasi dan kode registrasi.

Blok aplikasi

blockstudio/

└── my-app/

├── block.json Definisi blok

├── index.php Template + Interactivity API

├── style.css Gaya tercakup

├── script-inline.js Logika klien

├── db.php Model data + CRUD

├── rpc.php Fungsi server

├── cron.php Tugas terjadwal

└── db/default.sqlite

## Basis Data

Tentukan skema, dapatkan endpoint CRUD.

## [6 mode penyimpanan](https://blockstudio.dev/id/docs/blocks/block-api/database/#storage-modes)

table, sqlite, jsonc, storh, meta, post_type. Pilih berdasarkan portabilitas dan kebutuhan kueri.

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

Satu file untuk tiap rekaman di bawah uploads, dengan indeks yang dibuat dari skema dan penulisan serentak yang lebih aman. wp bs db migrate –to=storh memindahkan rekaman JSONC dan mempertahankan ID-nya.

## [Tabel dan tipe pos](https://blockstudio.dev/id/docs/blocks/block-api/database/#custom-table-storage-table)

Penyimpanan table mengelola tabel MySQL dengan dbDelta dan menambahkan kolom untuk bidang baru. Penyimpanan post_type menjadikan setiap rekaman sebagai pos, sehingga WP_Query, plugin REST API, dan alat GraphQL dapat membacanya.

## [Beberapa skema](https://blockstudio.dev/id/docs/blocks/block-api/database/#multiple-schemas)

Kembalikan skema bernama dari satu db.php. Masing-masing mendapat penyimpanan, endpoint, dan kontrol akses sendiri.

## [Data dengan cakupan pengguna](https://blockstudio.dev/id/docs/blocks/block-api/database/#user-scoped-data)

Atur userScoped untuk mengisolasi catatan secara otomatis, tanpa pemfilteran manual.

## [Validasi dan hook](https://blockstudio.dev/id/docs/blocks/block-api/database/#validation)

Tipe, nilai wajib, enum, format, panjang, callback, dan hook siklus hidup.

## RPC

Fungsi server yang dapat dipanggil dari frontend.

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

Panggil fungsi dari JavaScript; skrip inline mendeteksi nama blok secara otomatis.

## [Kontrol akses](https://blockstudio.dev/id/docs/blocks/block-api/rpc/#access-control)

Publik dengan CSRF, terbuka untuk webhook, atau berbasis kapabilitas untuk tiap fungsi.

## [Pemanggilan lintas blok](https://blockstudio.dev/id/docs/blocks/block-api/rpc/#cross-block-calling)

Panggil fungsi blok apa pun dari JavaScript atau PHP, lalu susun logikanya.

## Lapisan data klien

Baca, simpan dalam cache, dan tulis rekaman dari browser.

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

Buat, tampilkan daftar, ambil, perbarui, dan hapus rekaman dari JavaScript. list menerima filter bidang, limit, dan offset.

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

Pengambilan yang di-cache berdasarkan kunci. Panggilan yang sedang berlangsung berbagi satu promise, dan staleTime melewati permintaan selama data masih segar.

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

Pembuatan, pembaruan, dan penghapusan optimistis pada array status reaktif, yang dikembalikan ke snapshot jika permintaan gagal.

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

Cache dalam memori di balik bs.query() dan bs.mutate(). Baca, tetapkan, invalidasi, atau hapus entri secara langsung.

## [Polling waktu nyata](https://blockstudio.dev/id/docs/blocks/block-api/database/#realtime-polling)

Atur realtime di db.php, lalu klien membandingkan hash data secara berkala dan memperbarui store Interactivity API. Polling dijeda di tab tersembunyi.

## [Halaman yang di-cache](https://blockstudio.dev/id/docs/blocks/block-api/rpc/#cached-pages)

bs.fn() dan bs.db() mengambil kredensial baru dari endpoint yang tidak di-cache pada panggilan pertama, sehingga panggilan publik tetap berfungsi pada halaman yang disajikan dari cache berumur panjang.

## Formulir dan layar aplikasi

Formulir yang dirender dari skema, serta UI siap pakai untuk dikembangkan.

## [Formulir skema](https://blockstudio.dev/id/docs/blocks/block-api/database/#form-rendering)

Beri bidang kunci komponen, lalu bs_db_form() merender formulir melalui blok-blok tersebut dan meneruskan definisi bidang kepada masing-masing blok.

## [Formulir yang dibundel](https://blockstudio.dev/id/guides/ui-app-screen/#step-4-the-template)

Dengan ui.enabled, bsui/form block=”…” mengirim bidangnya ke endpoint create blok tersebut, menampilkan setiap kesalahan validasi di bawah bidangnya, serta memicu formsuccess atau formerror.

## [Contoh aplikasi](https://blockstudio.dev/id/docs/general/settings/#ui)

Pengaturan ui juga mendaftarkan contoh app/*, seperti app/kitchen-sink dan app/chat, yang dibuat dari komponen bsui yang sama.

## Infrastruktur

Cron, CLI, kode penyiapan, dan portabilitas.

## [Tugas terjadwal](https://blockstudio.dev/id/docs/blocks/block-api/cron/)

Tugas cron.php didaftarkan ke WP-Cron. Penghapusan instalasi Composer menghapusnya dengan wp bs teardown.

## [CLI basis data](https://blockstudio.dev/id/docs/dev/cli/#database)

wp bs db menampilkan daftar rekaman dengan filter bidang, mengambil, membuat, memperbarui, dan menghapusnya, serta mencetak tabel, JSON, atau CSV.

## [Uji dari terminal](https://blockstudio.dev/id/docs/dev/cli/#call-a-function)

wp bs rpc call menjalankan fungsi dengan parameter –key=value, dan wp bs cron run langsung menjalankan tugas, apa pun jadwalnya.

## [File init](https://blockstudio.dev/id/docs/blocks/block-api/initialization/)

init.php dan file init*.php lainnya di folder blok dijalankan sekali saat init, untuk penyiapan seperti mendaftarkan tipe pos.

## [Definisi bawaan PHP](https://blockstudio.dev/id/docs/blocks/block-api/rpc/#php-native-definitions)

rpc.php dan cron.php dapat mengembalikan kelas dengan metode #[Rpc] dan #[Cron], serta enum Access, Method, dan Schedule. db.php dapat menggunakan Schema::make() dan pembuat Field.

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

SQLite dan JSONC ikut berpindah bersama kode: salin satu folder untuk menerapkan aplikasi.

Plus

## Kit ekstensi resmi

Template situs premium, instruksi sistem AI, dan komunitas Discord privat. Pembelian satu kali, pembaruan seumur hidup.

- 500+ templat situs
- Instruksi sistem AI
- Pembaruan seumur hidup
- Komunitas privat Discord

[Dapatkan Plus](https://blockstudio.dev/id/plus/)
