フルスタックブロック
データベース、サーバー関数、cron、CLIを1つのフォルダーに集約。
db.php
スキーマを定義してCRUDエンドポイントを取得
<?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
カスタムサーバー関数
<?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種類の保存方式
table, sqlite, jsonc, storh, meta, post_type。移植性とクエリの要件に応じて選択できます。
Storhファイル
uploads内でレコードごとに1ファイルを保存し、スキーマからインデックスを作成して、同時書き込みの安全性を高めます。wp bs db migrate –to=storhでJSONC件のレコードを移行し、IDを保持します。
テーブルと投稿タイプ
tableストレージはdbDeltaでMySQLテーブルを管理し、新しいフィールドの列を追加します。post_typeストレージでは各レコードを投稿として保存するため、WP_Query、RESTAPIプラグイン、GraphQLツールから読み取れます。
複数のスキーマ
1つのdb.phpから名前付きスキーマを返します。それぞれに専用のストレージ、エンドポイント、アクセス制御が備わります。
ユーザー単位のデータ
userScopedを設定すると、手動でフィルタリングせずにレコードを自動で分離できます。
検証とフック
型、必須値、列挙型、形式、長さ、コールバック、ライフサイクルフック。
RPC
フロントエンドから呼び出せるサーバー関数。
クライアントデータレイヤー
ブラウザーからレコードを読み取り、キャッシュし、書き込みます。
bs.db()クライアント
JavaScriptからレコードの作成、一覧表示、取得、更新、削除を行います。listではフィールドによる絞り込み、limit、offsetを指定できます。
bs.query()
キー単位で取得結果をキャッシュします。処理中の呼び出しは1つのpromiseを共有し、データが新しければstaleTimeによりリクエストを省略します。
bs.mutate()
リアクティブなstate配列上で作成、更新、削除を楽観的に反映し、リクエスト失敗時はスナップショットに戻します。
bs.cache
bs.query()とbs.mutate()を支えるメモリー内キャッシュです。エントリーを直接読み取り、設定、無効化、消去できます。
リアルタイムポーリング
db.phpでリアルタイム機能を有効にすると、クライアントは一定間隔でデータハッシュを比較し、Interactivity APIストアを更新します。非表示のタブではポーリングを一時停止します。
キャッシュされたページ
bs.fn()とbs.db()は初回呼び出し時にキャッシュ対象外のエンドポイントから新しい認証情報を取得するため、長期間キャッシュされたページでも公開呼び出しが機能します。
フォームとアプリ画面
スキーマからレンダリングされるフォームと、開発の基盤となる組み込みのUI。
インフラ
Cron、CLI、セットアップコード、移植性。
スケジュール済みタスク
cron.phpジョブはWP-Cronに登録されます。Composerで削除するとwp bs teardownでジョブも削除されます。
データベースCLI
wp bs dbはフィールド条件でレコードを一覧表示し、取得、作成、更新、削除を行い、テーブル、JSON、CSVを出力します。
ターミナルからテスト
wp bs rpc callは–key=valueパラメーターで関数を実行し、wp bs cron runはスケジュールに関係なくジョブをすぐに実行します。
初期化ファイル
init.phpなど、ブロックフォルダー内のinit*.phpファイルはinit時に一度実行され、投稿タイプの登録などのセットアップに使えます。
PHPネイティブの定義
rpc.phpとcron.phpは、#[Rpc]と#[Cron]メソッド、Access、Method、Schedule列挙型を備えたクラスを返せます。db.phpではSchema::make()とFieldビルダーを使用できます。
移植性
SQLiteとJSONCはコードと一緒に移動できます。フォルダーをコピーするだけでアプリをデプロイできます。
公式拡張キット
プレミアムサイトテンプレート、AIシステム指示、会員限定Discordコミュニティ。買い切りで、アップデートは生涯無料です。
- 500+のサイトテンプレート
- AIシステム向け指示
- 無期限アップデート
- 非公開Discordコミュニティ