# フルスタックブロック

データベース、サーバー関数、cron、CLIを1つのフォルダーに集約。

[ガイドを読む](https://blockstudio.dev/ja/guides/full-stack-blocks/)

## db.php

スキーマを定義して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

カスタムサーバー関数

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

## すべての機能をファイルで管理

ファイルを1つ追加するごとに機能が1つ増えます。設定も登録コードも不要です。

アプリケーションブロック

blockstudio/

└── my-app/

├── block.json ブロック定義

├── index.php テンプレート + Interactivity API

├── style.css スコープ付きスタイル

├── script-inline.js クライアントロジック

├── db.php データモデル + CRUD

├── rpc.php サーバー関数

├── cron.php スケジュール済みタスク

└── db/default.sqlite

## データベース

スキーマを定義してCRUDエンドポイントを作成。

## [6種類の保存方式](https://blockstudio.dev/ja/docs/blocks/block-api/database/#storage-modes)

table, sqlite, jsonc, storh, meta, post_type。移植性とクエリの要件に応じて選択できます。

## [Storhファイル](https://blockstudio.dev/ja/docs/blocks/block-api/database/#storh-files-storage-storh)

uploads内でレコードごとに1ファイルを保存し、スキーマからインデックスを作成して、同時書き込みの安全性を高めます。wp bs db migrate –to=storhでJSONC件のレコードを移行し、IDを保持します。

## [テーブルと投稿タイプ](https://blockstudio.dev/ja/docs/blocks/block-api/database/#custom-table-storage-table)

tableストレージはdbDeltaでMySQLテーブルを管理し、新しいフィールドの列を追加します。post_typeストレージでは各レコードを投稿として保存するため、WP_Query、RESTAPIプラグイン、GraphQLツールから読み取れます。

## [複数のスキーマ](https://blockstudio.dev/ja/docs/blocks/block-api/database/#multiple-schemas)

1つのdb.phpから名前付きスキーマを返します。それぞれに専用のストレージ、エンドポイント、アクセス制御が備わります。

## [ユーザー単位のデータ](https://blockstudio.dev/ja/docs/blocks/block-api/database/#user-scoped-data)

userScopedを設定すると、手動でフィルタリングせずにレコードを自動で分離できます。

## [検証とフック](https://blockstudio.dev/ja/docs/blocks/block-api/database/#validation)

型、必須値、列挙型、形式、長さ、コールバック、ライフサイクルフック。

## RPC

フロントエンドから呼び出せるサーバー関数。

## [bs.fn()クライアント](https://blockstudio.dev/ja/docs/blocks/block-api/rpc/#calling-from-javascript)

JavaScriptから関数を呼び出せます。インラインスクリプトはブロック名を自動検出します。

## [アクセス制御](https://blockstudio.dev/ja/docs/blocks/block-api/rpc/#access-control)

関数ごとに、CSRF付き公開、Webhook向け開放、または権限ベースを選べます。

## [ブロック間の呼び出し](https://blockstudio.dev/ja/docs/blocks/block-api/rpc/#cross-block-calling)

JavaScriptまたはPHPから任意のブロック関数を呼び出し、ロジックを組み合わせられます。

## クライアントデータレイヤー

ブラウザーからレコードを読み取り、キャッシュし、書き込みます。

## [bs.db()クライアント](https://blockstudio.dev/ja/docs/blocks/block-api/database/#javascript-client)

JavaScriptからレコードの作成、一覧表示、取得、更新、削除を行います。listではフィールドによる絞り込み、limit、offsetを指定できます。

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

キー単位で取得結果をキャッシュします。処理中の呼び出しは1つのpromiseを共有し、データが新しければstaleTimeによりリクエストを省略します。

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

リアクティブなstate配列上で作成、更新、削除を楽観的に反映し、リクエスト失敗時はスナップショットに戻します。

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

bs.query()とbs.mutate()を支えるメモリー内キャッシュです。エントリーを直接読み取り、設定、無効化、消去できます。

## [リアルタイムポーリング](https://blockstudio.dev/ja/docs/blocks/block-api/database/#realtime-polling)

db.phpでリアルタイム機能を有効にすると、クライアントは一定間隔でデータハッシュを比較し、Interactivity APIストアを更新します。非表示のタブではポーリングを一時停止します。

## [キャッシュされたページ](https://blockstudio.dev/ja/docs/blocks/block-api/rpc/#cached-pages)

bs.fn()とbs.db()は初回呼び出し時にキャッシュ対象外のエンドポイントから新しい認証情報を取得するため、長期間キャッシュされたページでも公開呼び出しが機能します。

## フォームとアプリ画面

スキーマからレンダリングされるフォームと、開発の基盤となる組み込みのUI。

## [スキーマフォーム](https://blockstudio.dev/ja/docs/blocks/block-api/database/#form-rendering)

フィールドにコンポーネントキーを指定すると、bs_db_form()がそのブロックを通じてフォームをレンダリングし、各ブロックにフィールド定義を渡します。

## [バンドルフォーム](https://blockstudio.dev/ja/guides/ui-app-screen/#step-4-the-template)

ui.enabledを使うと、bsui/form block=”…”は各フィールドをそのブロックのcreateエンドポイントに送信し、各フィールドの下に検証エラーを表示して、formsuccessまたはformerrorを発火します。

## [アプリの例](https://blockstudio.dev/ja/docs/general/settings/#ui)

ui設定では、同じbsuiコンポーネントで構築されたapp/kitchen-sinkやapp/chatなどのapp/*の例も登録されます。

## インフラ

Cron、CLI、セットアップコード、移植性。

## [スケジュール済みタスク](https://blockstudio.dev/ja/docs/blocks/block-api/cron/)

cron.phpジョブはWP-Cronに登録されます。Composerで削除するとwp bs teardownでジョブも削除されます。

## [データベースCLI](https://blockstudio.dev/ja/docs/dev/cli/#database)

wp bs dbはフィールド条件でレコードを一覧表示し、取得、作成、更新、削除を行い、テーブル、JSON、CSVを出力します。

## [ターミナルからテスト](https://blockstudio.dev/ja/docs/dev/cli/#call-a-function)

wp bs rpc callは–key=valueパラメーターで関数を実行し、wp bs cron runはスケジュールに関係なくジョブをすぐに実行します。

## [初期化ファイル](https://blockstudio.dev/ja/docs/blocks/block-api/initialization/)

init.phpなど、ブロックフォルダー内のinit*.phpファイルはinit時に一度実行され、投稿タイプの登録などのセットアップに使えます。

## [PHPネイティブの定義](https://blockstudio.dev/ja/docs/blocks/block-api/rpc/#php-native-definitions)

rpc.phpとcron.phpは、#[Rpc]と#[Cron]メソッド、Access、Method、Schedule列挙型を備えたクラスを返せます。db.phpではSchema::make()とFieldビルダーを使用できます。

## [移植性](https://blockstudio.dev/ja/guides/full-stack-blocks/)

SQLiteとJSONCはコードと一緒に移動できます。フォルダーをコピーするだけでアプリをデプロイできます。

Plus

## 公式拡張キット

プレミアムサイトテンプレート、AIシステム指示、会員限定Discordコミュニティ。買い切りで、アップデートは生涯無料です。

- 500+のサイトテンプレート
- AIシステム向け指示
- 無期限アップデート
- 非公開Discordコミュニティ

[Plusを入手](https://blockstudio.dev/ja/plus/)
