# Täyden pinon lohkot

Tietokanta, palvelinfunktiot, cron ja CLI yhdessä kansiossa.

[Lue opas](https://blockstudio.dev/fi/guides/full-stack-blocks/)

## db.php

Määritä skeema, saat CRUD-päätepisteet

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

Mukautetut palvelintoiminnot

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

## Jokainen ominaisuus on tiedosto

Jokainen tiedosto lisää yhden ominaisuuden. Ei asetuksia eikä rekisteröintikoodia.

Sovelluslohko

blockstudio/

└── my-app/

├── block.json Lohkon määritys

├── index.php Malli + Interactivity API

├── style.css Rajatut tyylit

├── script-inline.js Asiakaspuolen logiikka

├── db.php Tietomalli + CRUD

├── rpc.php Palvelintoiminnot

├── cron.php Ajoitetut tehtävät

└── db/default.sqlite

## Tietokanta

Määritä skeemat, saat CRUD-rajapinnat.

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

table, sqlite, jsonc, storh, meta, post_type. Valitse siirrettävyyden ja kyselytarpeiden mukaan.

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

Yksi tiedosto tietuetta kohti uploads-kansiossa, skeeman perusteella luodut indeksit ja turvallisemmat samanaikaiset kirjoitukset. wp bs db migrate –to=storh siirtää JSONC tietuetta ja säilyttää niiden tunnukset.

## [Taulut ja sisältötyypit](https://blockstudio.dev/fi/docs/blocks/block-api/database/#custom-table-storage-table)

Taulutallennus hallinnoi MySQL-taulua dbDeltalla ja lisää sarakkeet uusille kentille. post_type-tallennus tekee kustakin tietueesta artikkelin, joten WP_Query, REST API -lisäosat ja GraphQL -työkalut voivat lukea sitä.

## [Useita skeemoja](https://blockstudio.dev/fi/docs/blocks/block-api/database/#multiple-schemas)

Palauta nimetyt skeemat yhdestä db.php-kohteesta. Jokaisella on oma tallennustila, päätepisteet ja käyttöoikeuksien hallinta.

## [Käyttäjäkohtainen data](https://blockstudio.dev/fi/docs/blocks/block-api/database/#user-scoped-data)

Aseta userScoped eristämään tietueet automaattisesti ilman manuaalista suodatusta.

## [Validointi ja koukut](https://blockstudio.dev/fi/docs/blocks/block-api/database/#validation)

Tyypit, pakolliset arvot, luetellut arvot, muodot, pituudet, takaisinkutsut ja elinkaarikoukut.

## RPC

Palvelinfunktiot, joita voi kutsua käyttöliittymästä.

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

Kutsu funktioita JavaScript-ratkaisusta; rivinsisäiset skriptit tunnistavat lohkon nimen automaattisesti.

## [Käyttöoikeuksien hallinta](https://blockstudio.dev/fi/docs/blocks/block-api/rpc/#access-control)

Julkinen CSRF-suojauksella, avoin webhookeille tai funktiokohtainen kyvykkyyspohjainen käyttöoikeus.

## [Lohkojen väliset kutsut](https://blockstudio.dev/fi/docs/blocks/block-api/rpc/#cross-block-calling)

Kutsu mitä tahansa lohkofunktiota JavaScript- tai PHP-ratkaisusta ja yhdistele logiikkaa.

## Asiakkaan datakerros

Lue, tallenna välimuistiin ja kirjoita tietueita selaimesta.

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

Luo, luettele, hae, päivitä ja poista tietueita kohteesta JavaScript. list hyväksyy kenttäsuodattimet, rajan ja siirtymän.

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

Välimuistiin tallennetut haut avaimen perusteella. Käynnissä olevat kutsut jakavat saman lupauksen, ja staleTime ohittaa pyynnön, kun data on ajan tasalla.

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

Luo, päivitä ja poista tietueita optimistisesti reaktiivisessa tilataulukossa; epäonnistunut pyyntö palauttaa tilanteen tilannekuvan mukaiseksi.

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

Kohteiden bs.query() ja bs.mutate() taustalla oleva muistivälimuisti. Lue, aseta, mitätöi tai tyhjennä merkintöjä suoraan.

## [Reaaliaikainen kysely](https://blockstudio.dev/fi/docs/blocks/block-api/database/#realtime-polling)

Aseta reaaliaikaisuus kohteessa db.php. Asiakas vertaa datatiivistettä aikavälein ja päivittää sitten Interactivity API -tilan. Kysely keskeytyy piilotetuilla välilehdillä.

## [Välimuistiin tallennetut sivut](https://blockstudio.dev/fi/docs/blocks/block-api/rpc/#cached-pages)

bs.fn() ja bs.db() hakevat tuoreet tunnistetiedot välimuistittamattomasta päätepisteestä ensimmäisellä kutsulla, joten julkiset kutsut toimivat edelleen sivuilla, joita tarjotaan pitkään voimassa olevista välimuisteista.

## Lomakkeet ja sovellusnäkymät

Skeemasta muodostetut lomakkeet ja sovelluksen rakentamiseen tarkoitetut valmiit UI-komponentit.

## [Skeemalomakkeet](https://blockstudio.dev/fi/docs/blocks/block-api/database/#form-rendering)

Anna kentälle komponenttiavain, niin bs_db_form() muodostaa lomakkeen näiden lohkojen avulla ja välittää kullekin sen kenttämäärittelyn.

## [Sisäänrakennettu lomake](https://blockstudio.dev/fi/guides/ui-app-screen/#step-4-the-template)

Kun käytössä on ui.enabled, bsui/form block=”…” lähettää kenttänsä kyseisen lohkon luontipäätepisteeseen, näyttää kunkin validointivirheen kentän alla ja käynnistää tapahtuman formsuccess tai formerror.

## [Esimerkkisovellukset](https://blockstudio.dev/fi/docs/general/settings/#ui)

ui-asetus rekisteröi myös app/*-esimerkit, kuten app/kitchen-sink ja app/chat, jotka on rakennettu samoista bsui-komponenteista.

## Infrastruktuuri

Cron, CLI, asetuskoodi ja siirrettävyys.

## [Ajoitetut tehtävät](https://blockstudio.dev/fi/docs/blocks/block-api/cron/)

cron.php-työt rekisteröidään WP-Cron-ratkaisuun. Composer-asennusten poistaminen poistaa ne komennolla wp bs teardown.

## [Tietokannan CLI](https://blockstudio.dev/fi/docs/dev/cli/#database)

wp bs db luettelee tietueet kenttäsuodattimien avulla, hakee niitä sekä luo, päivittää ja poistaa niitä. Se tulostaa tauluja, JSON tai CSV.

## [Testaa päätteessä](https://blockstudio.dev/fi/docs/dev/cli/#call-a-function)

wp bs rpc call suorittaa funktion –key=value-parametreilla, ja wp bs cron run käynnistää työn heti sen aikataulusta riippumatta.

## [Alustustiedostot](https://blockstudio.dev/fi/docs/blocks/block-api/initialization/)

init.php ja muut lohkokansion init*.php-tiedostot suoritetaan kerran init-vaiheessa esimerkiksi sisältötyypin rekisteröintiä varten.

## [PHP-natiivimäärittelyt](https://blockstudio.dev/fi/docs/blocks/block-api/rpc/#php-native-definitions)

rpc.php ja cron.php voivat palauttaa luokan, jossa on #[Rpc]- ja #[Cron]-metodit sekä Access-, Method- ja Schedule-enumit. db.php voi käyttää Schema::make()- ja Field-rakentajia.

## [Siirrettävyys](https://blockstudio.dev/fi/guides/full-stack-blocks/)

SQLite ja JSONC kulkevat koodin mukana: kopioi yksi kansio ottaaksesi sovelluksen käyttöön.

Plus

## Virallinen laajennuspaketti

Premium-sivupohjia, tekoälyn järjestelmäohjeita ja yksityinen Discord-yhteisö. Kertamaksu, elinikäiset päivitykset.

- 500+ sivustomallia
- Tekoälyn järjestelmäohjeet
- Elinikäiset päivitykset
- Yksityinen Discord-yhteisö

[Hanki Plus](https://blockstudio.dev/fi/plus/)
