# 풀스택 블록

데이터베이스, 서버 함수, cron 및 CLI이 하나의 폴더에 들어 있습니다.

[가이드 읽기](https://blockstudio.dev/ko/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];
  },
];
```

## 모든 기능은 파일 하나로 제공됩니다

파일마다 기능 하나를 추가합니다. 구성이나 등록 코드는 필요하지 않습니다.

애플리케이션 블록

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/ko/docs/blocks/block-api/database/#storage-modes)

table, sqlite, jsonc, storh, meta, post_type. 이식성과 쿼리 요구 사항에 따라 선택하세요.

## [Storh개 파일](https://blockstudio.dev/ko/docs/blocks/block-api/database/#storh-files-storage-storh)

uploads 아래에 레코드마다 파일 하나를 저장하고, 스키마에서 인덱스를 생성하며, 동시 쓰기를 더 안전하게 처리합니다. wp bs db migrate –to=storh 명령은 JSONC개 레코드를 옮기고 ID를 유지합니다.

## [테이블 및 글 유형](https://blockstudio.dev/ko/docs/blocks/block-api/database/#custom-table-storage-table)

table 저장소는 dbDelta로 MySQL 테이블을 관리하고 새 필드의 열을 추가합니다. post_type 저장소는 각 레코드를 글로 저장하므로 WP_Query, REST API 플러그인, GraphQL 도구에서 읽을 수 있습니다.

## [여러 스키마](https://blockstudio.dev/ko/docs/blocks/block-api/database/#multiple-schemas)

하나의 db.php에서 이름이 지정된 스키마를 반환합니다. 각 스키마는 자체 저장소, 엔드포인트, 접근 제어를 갖습니다.

## [사용자 범위 데이터](https://blockstudio.dev/ko/docs/blocks/block-api/database/#user-scoped-data)

userScoped를 설정하면 수동 필터링 없이 레코드를 자동으로 분리합니다.

## [유효성 검사 및 훅](https://blockstudio.dev/ko/docs/blocks/block-api/database/#validation)

유형, 필수 값, 열거형, 형식, 길이, 콜백 및 수명 주기 훅.

## RPC

프런트엔드에서 호출할 수 있는 서버 함수.

## [bs.fn() 클라이언트](https://blockstudio.dev/ko/docs/blocks/block-api/rpc/#calling-from-javascript)

JavaScript에서 함수를 호출하세요. 인라인 스크립트가 블록 이름을 자동으로 감지합니다.

## [액세스 제어](https://blockstudio.dev/ko/docs/blocks/block-api/rpc/#access-control)

함수별로 CSRF를 적용한 공개 액세스, 웹훅용 개방 액세스 또는 기능 기반 액세스를 설정할 수 있습니다.

## [블록 간 호출](https://blockstudio.dev/ko/docs/blocks/block-api/rpc/#cross-block-calling)

JavaScript 또는 PHP에서 모든 블록 함수를 호출해 로직을 조합하세요.

## 클라이언트 데이터 계층

브라우저에서 레코드를 읽고, 캐시하고, 씁니다.

## [bs.db() 클라이언트](https://blockstudio.dev/ko/docs/blocks/block-api/database/#javascript-client)

JavaScript에서 레코드를 생성, 목록 조회, 가져오기, 업데이트, 삭제합니다. list는 필드 필터, limit, offset을 받습니다.

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

키별로 가져온 데이터를 캐시합니다. 진행 중인 호출은 하나의 promise를 공유하며, 데이터가 최신이면 staleTime 동안 요청을 건너뜁니다.

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

반응형 상태 배열에서 생성, 업데이트, 삭제를 낙관적으로 처리하고, 요청이 실패하면 스냅샷으로 되돌립니다.

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

bs.query() 및 bs.mutate()을 뒷받침하는 메모리 내 캐시입니다. 항목을 직접 읽고, 설정하고, 무효화하거나 지울 수 있습니다.

## [실시간 폴링](https://blockstudio.dev/ko/docs/blocks/block-api/database/#realtime-polling)

db.php에서 실시간 기능을 설정하면 클라이언트가 일정 간격으로 데이터 해시를 비교한 뒤 Interactivity API 저장소를 업데이트합니다. 숨겨진 탭에서는 폴링이 일시 중지됩니다.

## [캐시된 페이지](https://blockstudio.dev/ko/docs/blocks/block-api/rpc/#cached-pages)

bs.fn() 및 bs.db()은 첫 호출 시 캐시되지 않은 엔드포인트에서 새 자격 증명을 가져오므로, 오래 유지되는 캐시에서 제공되는 페이지에서도 공개 호출이 계속 작동합니다.

## 양식 및 앱 화면

스키마에서 렌더링되는 양식과 이를 기반으로 구축할 수 있는 번들 UI입니다.

## [스키마 양식](https://blockstudio.dev/ko/docs/blocks/block-api/database/#form-rendering)

필드에 컴포넌트 키를 지정하면 bs_db_form()이 해당 블록으로 양식을 렌더링하고 각 블록에 필드 정의를 전달합니다.

## [번들 양식](https://blockstudio.dev/ko/guides/ui-app-screen/#step-4-the-template)

ui.enabled을 사용하면 bsui/form block=”…”이 필드를 해당 블록의 create 엔드포인트로 보내고, 각 필드 아래에 유효성 검사 오류를 표시하며, formsuccess 또는 formerror를 전달합니다.

## [예제 앱](https://blockstudio.dev/ko/docs/general/settings/#ui)

ui 설정은 동일한 bsui 컴포넌트로 만든 app/kitchen-sink, app/chat 같은 app/* 예제도 등록합니다.

## 인프라

Cron, CLI, 설정 코드, 이식성.

## [예약 작업](https://blockstudio.dev/ko/docs/blocks/block-api/cron/)

cron.php 작업은 WP-Cron에 등록됩니다. Composer 설치를 제거하면 wp bs teardown으로 해당 작업도 삭제됩니다.

## [데이터베이스 CLI](https://blockstudio.dev/ko/docs/dev/cli/#database)

wp bs db는 필드 필터를 사용해 레코드를 목록 조회하고, 가져오고, 생성하고, 업데이트하고, 삭제하며, 테이블, JSON 또는 CSV을 출력합니다.

## [터미널에서 테스트](https://blockstudio.dev/ko/docs/dev/cli/#call-a-function)

wp bs rpc call은 –key=value 매개변수로 함수를 실행하고, wp bs cron run은 예약 시간과 관계없이 작업을 즉시 실행합니다.

## [초기화 파일](https://blockstudio.dev/ko/docs/blocks/block-api/initialization/)

블록 폴더의 init.php 및 기타 init*.php 파일은 init에서 한 번 실행되며, 글 유형 등록 같은 설정 작업에 사용할 수 있습니다.

## [PHP 네이티브 정의](https://blockstudio.dev/ko/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/ko/guides/full-stack-blocks/)

SQLite와 JSONC은 코드와 함께 이동합니다. 폴더 하나를 복사해 앱을 배포하세요.

Plus

## 공식 확장 키트

프리미엄 사이트 템플릿, AI 시스템 지침, 비공개 Discord 커뮤니티를 제공합니다. 한 번 구매하면 업데이트를 평생 받을 수 있습니다.

- 500개 이상의 사이트 템플릿
- AI 시스템 지침
- 평생 업데이트
- 비공개 Discord 커뮤니티

[Plus 이용하기](https://blockstudio.dev/ko/plus/)
