# Bloki pełnego stosu

Baza danych, funkcje serwerowe, cron i CLI w jednym folderze.

[Przeczytaj poradnik](https://blockstudio.dev/pl/guides/full-stack-blocks/)

## db.php

Zdefiniuj schemat, otrzymaj endpointy 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

Niestandardowe funkcje serwera

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

## Każda funkcjonalność to plik

Każdy plik dodaje jedną funkcjonalność. Bez konfiguracji i kodu rejestracji.

Blok aplikacji

blockstudio/

└── my-app/

├── block.json Definicja bloku

├── index.php Szablon + Interactivity API

├── style.css Style o ograniczonym zakresie

├── script-inline.js Logika klienta

├── db.php Model danych + CRUD

├── rpc.php Funkcje serwera

├── cron.php Zaplanowane zadania

└── db/default.sqlite

## Baza danych

Definiuj schematy i twórz punkty końcowe CRUD.

## [6 trybów przechowywania](https://blockstudio.dev/pl/docs/blocks/block-api/database/#storage-modes)

table, sqlite, jsonc, storh, meta, post_type. Wybierz według przenośności i potrzeb związanych z zapytaniami.

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

Jeden plik na rekord w katalogu uploads, indeksy tworzone na podstawie schematu i bezpieczniejsze równoczesne zapisy. wp bs db migrate –to=storh przenosi rekordy JSONC i zachowuje ich identyfikatory.

## [Tabele i typy wpisów](https://blockstudio.dev/pl/docs/blocks/block-api/database/#custom-table-storage-table)

Przechowywanie w tabeli zarządza tabelą MySQL za pomocą dbDelta i dodaje kolumny dla nowych pól. Przechowywanie w post_type tworzy z każdego rekordu wpis, dzięki czemu WP_Query, wtyczki REST API i narzędzia GraphQL mogą go odczytać.

## [Wiele schematów](https://blockstudio.dev/pl/docs/blocks/block-api/database/#multiple-schemas)

Zwracaj nazwane schematy z jednego db.php. Każdy ma własne miejsce przechowywania, punkty końcowe i kontrolę dostępu.

## [Dane przypisane do użytkownika](https://blockstudio.dev/pl/docs/blocks/block-api/database/#user-scoped-data)

Ustaw userScoped, aby automatycznie izolować rekordy bez ręcznego filtrowania.

## [Walidacja i hooki](https://blockstudio.dev/pl/docs/blocks/block-api/database/#validation)

Typy, wymagane wartości, wyliczenia, formaty, długości, funkcje zwrotne i hooki cyklu życia.

## RPC

Funkcje serwerowe wywoływane z frontendu.

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

Wywołuj funkcje z JavaScript; skrypty inline automatycznie wykrywają nazwę bloku.

## [Kontrola dostępu](https://blockstudio.dev/pl/docs/blocks/block-api/rpc/#access-control)

Publiczny z CSRF, otwarty dla webhooków lub oparty na uprawnieniach — osobno dla każdej funkcji.

## [Wywołania między blokami](https://blockstudio.dev/pl/docs/blocks/block-api/rpc/#cross-block-calling)

Wywołuj dowolną funkcję bloku z JavaScript lub PHP i łącz logikę.

## Warstwa danych klienta

Odczytuj, buforuj i zapisuj rekordy w przeglądarce.

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

Twórz, wyświetlaj listę, pobieraj, aktualizuj i usuwaj rekordy z JavaScript. list przyjmuje filtry pól, limit i przesunięcie.

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

Pobieranie z pamięci podręcznej według klucza. Wywołania w toku współdzielą tę samą obietnicę, a staleTime pomija żądanie, gdy dane są aktualne.

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

Optymistyczne tworzenie, aktualizowanie i usuwanie elementów reaktywnej tablicy stanu; w razie niepowodzenia żądania stan jest przywracany z migawki.

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

Pamięć podręczna w pamięci operacyjnej, która obsługuje bs.query() i bs.mutate(). Odczytuj, ustawiaj, unieważniaj lub bezpośrednio usuwaj wpisy.

## [Odpytywanie w czasie rzeczywistym](https://blockstudio.dev/pl/docs/blocks/block-api/database/#realtime-polling)

Ustaw realtime w db.php, a klient będzie okresowo porównywać skrót danych i aktualizować magazyn Interactivity API. Odpytywanie wstrzymuje się na ukrytych kartach.

## [Strony z pamięci podręcznej](https://blockstudio.dev/pl/docs/blocks/block-api/rpc/#cached-pages)

bs.fn() i bs.db() pobierają aktualne dane uwierzytelniające z niebuforowanego punktu końcowego przy pierwszym wywołaniu, dzięki czemu wywołania publiczne działają na stronach obsługiwanych z długotrwałej pamięci podręcznej.

## Formularze i ekrany aplikacji

Formularze renderowane na podstawie schematu oraz dołączone UI, na których można budować.

## [Formularze schematów](https://blockstudio.dev/pl/docs/blocks/block-api/database/#form-rendering)

Przypisz polu klucz komponentu, a bs_db_form() wyrenderuje formularz przy użyciu tych bloków, przekazując każdemu definicję pola.

## [Formularz w pakiecie](https://blockstudio.dev/pl/guides/ui-app-screen/#step-4-the-template)

Z ui.enabled, bsui/form block=”…” wysyła pola do punktu końcowego tworzenia tego bloku, wyświetla każdy błąd walidacji pod odpowiednim polem i wywołuje formsuccess lub formerror.

## [Przykładowe aplikacje](https://blockstudio.dev/pl/docs/general/settings/#ui)

Ustawienie ui rejestruje też przykłady app/*, takie jak app/kitchen-sink i app/chat, zbudowane z tych samych komponentów bsui.

## Infrastruktura

Cron, CLI, kod konfiguracji i przenośność.

## [Zaplanowane zadania](https://blockstudio.dev/pl/docs/blocks/block-api/cron/)

Zadania cron.php rejestrują się w WP-Cron. Instalacje Composer usuwają je poleceniem wp bs teardown.

## [Baza danych CLI](https://blockstudio.dev/pl/docs/dev/cli/#database)

wp bs db wyświetla listę rekordów z filtrami pól, pobiera je, tworzy, aktualizuje i usuwa, a także drukuje tabele, JSON lub CSV.

## [Testowanie z terminala](https://blockstudio.dev/pl/docs/dev/cli/#call-a-function)

wp bs rpc call uruchamia funkcję z parametrami –key=value, a wp bs cron run uruchamia zadanie od razu, niezależnie od jego harmonogramu.

## [Pliki inicjalizacyjne](https://blockstudio.dev/pl/docs/blocks/block-api/initialization/)

init.php i inne pliki init*.php w katalogu bloku uruchamiają się raz podczas init, na przykład w celu skonfigurowania typu wpisu.

## [Definicje natywne dla PHP](https://blockstudio.dev/pl/docs/blocks/block-api/rpc/#php-native-definitions)

rpc.php i cron.php mogą zwracać klasę z metodami #[Rpc] i #[Cron] oraz wyliczeniami Access, Method i Schedule. db.php może używać Schema::make() i konstruktorów Field.

## [Przenośność](https://blockstudio.dev/pl/guides/full-stack-blocks/)

SQLite i JSONC są dołączone do kodu: skopiuj jeden folder, aby wdrożyć aplikację.

Plus

## Oficjalny zestaw rozszerzeń

Wysokiej jakości szablony witryn, systemowe instrukcje AI i prywatna społeczność Discord. Jednorazowy zakup, dożywotnie aktualizacje.

- 500+ szablonów stron
- Instrukcje systemowe AI
- Dożywotnie aktualizacje
- Prywatna społeczność Discord

[Uzyskaj Plus](https://blockstudio.dev/pl/plus/)
