풀스택 블록
데이터베이스, 서버 함수, cron 및 CLI이 하나의 폴더에 들어 있습니다.
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];
},
];모든 기능은 파일 하나로 제공됩니다
파일마다 기능 하나를 추가합니다. 구성이나 등록 코드는 필요하지 않습니다.
애플리케이션 블록
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 아래에 레코드마다 파일 하나를 저장하고, 스키마에서 인덱스를 생성하며, 동시 쓰기를 더 안전하게 처리합니다. wp bs db migrate –to=storh 명령은 JSONC개 레코드를 옮기고 ID를 유지합니다.
테이블 및 글 유형
table 저장소는 dbDelta로 MySQL 테이블을 관리하고 새 필드의 열을 추가합니다. post_type 저장소는 각 레코드를 글로 저장하므로 WP_Query, REST API 플러그인, GraphQL 도구에서 읽을 수 있습니다.
여러 스키마
하나의 db.php에서 이름이 지정된 스키마를 반환합니다. 각 스키마는 자체 저장소, 엔드포인트, 접근 제어를 갖습니다.
사용자 범위 데이터
userScoped를 설정하면 수동 필터링 없이 레코드를 자동으로 분리합니다.
유효성 검사 및 훅
유형, 필수 값, 열거형, 형식, 길이, 콜백 및 수명 주기 훅.
RPC
프런트엔드에서 호출할 수 있는 서버 함수.
클라이언트 데이터 계층
브라우저에서 레코드를 읽고, 캐시하고, 씁니다.
bs.db() 클라이언트
JavaScript에서 레코드를 생성, 목록 조회, 가져오기, 업데이트, 삭제합니다. list는 필드 필터, limit, offset을 받습니다.
bs.query()
키별로 가져온 데이터를 캐시합니다. 진행 중인 호출은 하나의 promise를 공유하며, 데이터가 최신이면 staleTime 동안 요청을 건너뜁니다.
bs.mutate()
반응형 상태 배열에서 생성, 업데이트, 삭제를 낙관적으로 처리하고, 요청이 실패하면 스냅샷으로 되돌립니다.
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 커뮤니티