# 가능한 경우 정적으로 제공

사전 렌더링된 페이지와 프로덕션 기본값을 blockstudio.json에서 설정하세요.

## 익명 방문자용 페이지 사전 렌더링

정적 사전 렌더링은 기본적으로 꺼져 있습니다. `performance.staticPrerender` 를 켜면 Blockstudio가 익명 방문자에게 제공되는 완전한 HTML 문서를 각각 저장하고, 다음 익명 방문자에게 해당 사본을 제공합니다.

계속 활성 상태로 유지해야 하는 요청은 이 기능을 거치지 않습니다. GET이 아닌 요청, 쿼리 문자열, 관리자 화면, REST, Ajax, cron, 피드, 검색, 미리보기, nonce가 포함된 페이지, `dynamicPaths` 아래의 모든 경로, 그리고 `serveLoggedIn` 이 켜져 있지 않을 때의 로그인 방문자가 여기에 해당합니다.

[정적 사전 렌더링](https://blockstudio.dev/ko/docs/production/static-prerendering/)

blockstudio.json

```
{
  "performance": {
    "staticPrerender": {
      "enabled": true,
      "ttl": 3600,
      "earlyServe": true,
      "dynamicPaths": ["/account", "/checkout"]
    }
  }
}
```

## 기본적으로 꺼져 있음

blockstudio.json에서 기능을 지정하기 전까지는 아무것도 바뀌지 않습니다.

## 동적 경로

/account의 동적 경로는 /account/orders에 적용되지만 /accounting에는 적용되지 않습니다.

## 제외 표시자

blockstudio:no-cache 주석이 있으면 모든 응답이 캐시에서 제외됩니다.

## 로그인한 방문자

serveLoggedIn이 켜져 있으면 로그인한 방문자도 저장된 페이지를 볼 수 있지만, 개인 페이지는 저장되지 않습니다.

## [사용자 지정 우회](https://blockstudio.dev/ko/docs/blocks/hooks/php/#blockstudio-static_prerender-request_bypass)

static_prerender/request_bypass 필터를 사용하면 장바구니 쿠키가 있는 요청처럼 지정한 요청은 저장된 페이지를 사용하지 않도록 할 수 있습니다.

## 예열 대기열

지속성 있는 대기열이 설정한 간격에 따라 오래된 페이지를 다시 렌더링합니다.

## [롱테일 경로](https://blockstudio.dev/ko/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

배포된 맵 외부의 경로도 WordPress가 렌더링하고 저장하면 빠르게 제공됩니다.

## 스타일시트 확인

연결된 Tailwind 스타일시트가 사라진 저장 페이지는 스타일 없이 제공하지 않고 다시 렌더링합니다.

## WordPress이 시작되기 전에 제공됩니다

`earlyServe` 을 켜면 Blockstudio이 `advanced-cache.php` 드롭인 파일을 설치해 WordPress, 플러그인 또는 테마가 로드되기 전에 저장된 페이지를 스트리밍합니다. 기존 드롭인 파일, 경로 맵 또는 직접 작성하지 않은 `WP_CACHE` 줄은 덮어쓰지 않습니다.

이 사이트에서도 사용합니다. 10월 8일, 2026에 blockstudio.dev 페이지는 드롭인 파일이 보내는 헤더인 `x-blockstudio-static-prerender: HIT-EARLY` 로 응답했습니다.

[조기 제공](https://blockstudio.dev/ko/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

터미널

```
# Identity, files, queue, and hit/miss counters
wp bs prerender status

# Re-render stale entries now
wp bs prerender warm

# Dead or orphaned early-serve map entries
wp bs prerender map status
wp bs prerender map prune --dry-run

# Remove the drop-in and map this install owns
wp bs teardown
```

## 변경할 때마다 최신 상태 유지

기본 `signature` 모드는 익명 방문자가 캐시에 없는 페이지를 요청하면 캐시를 채우고, 사이트 수준의 변경이 있으면 캐시를 교체합니다. 글을 저장하거나 삭제하면 해당 글과 프런트 페이지의 캐시를 비우며, 예열 기능이 켜져 있으면 다시 렌더링하도록 대기열에 추가합니다.

`graph` 모드는 배포 도구용입니다. 각 페이지에서 읽은 파일을 기록하므로, 빌드 시 파일이 변경된 경로만 다시 렌더링한 뒤 새 세트를 하나의 아티팩트로 활성화합니다. 참조된 파일의 유효성 검사에 실패하면 이전 아티팩트가 계속 제공됩니다.

아티팩트를 설치할 때 바이트를 비교하고 변경된 문서를 원자적으로 교체합니다. `last_promotion()` 는 승격, 교체, 건너뜀 또는 유지된 경로 수를 보고하므로 배포 로그에 기록하고 활성 빌드 ID와 비교할 수 있습니다.

[서명 모드 및 그래프 모드](https://blockstudio.dev/ko/docs/production/static-prerendering/#signature-and-graph-modes)

deploy.php

```
use Blockstudio\Static_Prerender_Runtime;

$plan = Static_Prerender_Runtime::build_plan($sourceUrls);

foreach ($plan['affectedUrls'] as $url) {
  $result = render_with_dependencies($url);

  Static_Prerender_Runtime::persist_built_response(
    $url,
    $result['html'],
    $result['files'],
    $result['virtualHashes']
  );
}

Static_Prerender_Runtime::garbage_collect(array_keys($plan['live']));
```

## CDN 뒤에서

사전 렌더링 헤더에는 공유해도 안전한 응답이 이미 표시되어 있습니다. `HIT` 와 `HIT-EARLY` 을 원본 서버의 `Cache-Control` 수명에 매핑하고, 해당 수명이 지정된 항목만 캐시하세요. `wordpress_logged_in_`, `wp-postpass_`, `comment_author_email_` 쿠키, 사용자의 `dynamicPaths`, `wp-admin`, `wp-json` 에 대해서는 엣지 캐시를 우회하세요.

엣지에 캐시된 페이지는 렌더링 당시의 콘텐츠 해시 스타일시트를 계속 연결합니다. `cache.namespaceGrace` 를 해당 사본이 유지될 수 있는 최장 시간으로 설정하면, 만료될 때까지 이전 스타일시트가 디스크에 남습니다.

[CDN 설정](https://blockstudio.dev/ko/guides/static-prerendering/#putting-a-cdn-in-front)

nginx.conf

```
map $upstream_http_x_blockstudio_static_prerender $edge_cache_control {
  "~^HIT"  "public, s-maxage=604800";
  default  "";
}

location ~ \.php$ {
  include fastcgi_params;
  fastcgi_pass unix:/run/php/php-fpm.sock;
  add_header Cache-Control $edge_cache_control;
}
```

## 캐시된 페이지의 동적 블록 하나

`blockstudio.island` 를 `dynamic` 로 설정하면 캐시된 페이지에는 블록 대신 플레이스홀더가 포함됩니다. 브라우저는 페이지의 모든 동적 아일랜드를 모아 단일 일괄 요청으로 각 조각을 가져오며, 각 요청에는 블록 이름과 허용 목록에 있는 속성이 서명됩니다.

`hydrate` 는 전체 HTML를 페이지에 유지하고 마운트 이벤트만 전송합니다. 동적 아일랜드는 표시될 때까지 기다리거나, 창 이벤트 발생 시 새로 고치거나, 사용자별 또는 전역으로 조각을 캐시할 수 있습니다.

[블록 아일랜드](https://blockstudio.dev/ko/docs/blocks/islands/)

block.json

```
{
  "name": "acme/cart-count",
  "title": "Cart count",
  "blockstudio": {
    "island": {
      "mode": "dynamic",
      "attributes": ["productId"],
      "loading": "visible",
      "event": "cart:updated",
      "cache": {
        "ttl": 60,
        "per": "user"
      }
    }
  }
}
```

## 렌더링 시간이 어디에 쓰이는지 확인하세요

프런트엔드의 모든 URL에 `?blockstudio-perf` 를 추가하면 패널에 블록별 렌더링 시간, 호출 횟수, 변환, 템플릿, 컴포넌트 단계가 표시됩니다. 같은 시간 정보가 `Server-Timing` 헤더로도 전송되므로 CDN가 HTML를 캐시하는 경우에도 확인할 수 있습니다.

`edit_posts` 권한이 있는 로그인 사용자에게만 출력이 표시되며, 그 외 모든 요청에서는 `init` 에서 프로파일러가 꺼집니다. `performance.measurement` 는 프로필 및 구성 해시 헤더와 `Performance_Measurement::snapshot()` API를 추가합니다.

[프로파일러](https://blockstudio.dev/ko/docs/production/performance/#profiler)

blockstudio.json

```
{
  "dev": {
    "perf": true
  },
  "performance": {
    "measurement": {
      "enabled": true,
      "headers": true,
      "timings": true
    }
  }
}
```

## 운영 환경 기본값을 한 번에 설정

`performance.profile` 을 `speed` 로 설정하면 head에서 generator, emoji, feed, discovery 출력을 제거하고 oEmbed discovery를 끄며, XML-RPC와 pingback을 비활성화하고, 일반적인 코어 프런트엔드 에셋을 제거합니다. 또한 편집기 외부에서 Heartbeat 요청을 제한하고, 마우스를 올리거나 포커스할 때 동일 출처 링크를 미리 가져옵니다.

기본값은 `compat` 이며 아무것도 변경하지 않습니다. 각 하위 값이 프로필보다 우선하므로 나머지 설정은 그대로 두고 원하는 동작만 유지할 수 있습니다.

[성능 프로필](https://blockstudio.dev/ko/docs/production/performance/#performance-profiles)

blockstudio.json

```
{
  "performance": {
    "profile": "speed",
    "preload": {
      "links": "off"
    }
  }
}
```

## 공간을 유지하는 이미지

테마 이미지는 미디어 라이브러리 밖에 있으므로 WordPress은 크기를 알 수 없습니다. `bs_media_image()` 은 생성된 `assets/media.json` 에서 실제 크기를 읽어 파일이 로드되기 전에 종횡비에 맞는 공간을 확보합니다.

`performance.media.lazy` 을 켜면 이미지가 뷰포트에 가까워질 때까지 실제 URL은 크기가 올바르게 지정된 플레이스홀더 뒤에서 대기합니다.

[미디어](https://blockstudio.dev/ko/docs/production/media/)

index.php

```
<?php
echo bs_media_image([
  'src' => 'assets/images/hero.webp',
  'alt' => 'Hero',
  'eager' => true,
]);
```

## [캐시 디렉터리 하나](https://blockstudio.dev/ko/docs/production/caching/)

생성된 모든 파일은 런타임 식별자를 키로 사용해 cache.path 아래에 저장됩니다.

## [빌드 단일화](https://blockstudio.dev/ko/docs/production/caching/#concurrency-and-retention)

요청 하나가 캐시가 없는 키를 빌드합니다. 나머지 요청은 기다리거나, 마지막으로 정상 생성된 페이로드를 재사용하거나, Retry-After가 포함된 503를 받습니다.

## OPcache에 적합한 페이로드

작은 캐시 페이로드는 OPcache가 공유 메모리에서 재사용할 수 있는 일반 PHP 배열입니다. 큰 페이로드는 압축 상태로 유지됩니다.

## [렌더링 캐시](https://blockstudio.dev/ko/docs/production/performance/#render-cache)

같은 속성을 가진 자기 닫힘 블록 태그는 요청당 한 번 렌더링됩니다. 반복 호출은 메모리에서 처리됩니다.

## 선택 항목 새로 고침 통합

가져오기처럼 콘텐츠 쓰기가 한꺼번에 발생하면 캐시된 필드 선택 항목도 한 번에 새로 고쳐집니다.

## 멀티 테넌트 캐시

자체 테넌트 경계를 위해 cache/site_key를, 같은 사이트의 런타임 변형을 위해 cache/context를 필터링하세요.

## [캐시에 저장되는 컴파일된 에셋](https://blockstudio.dev/ko/docs/general/settings/#assets)

assets.output를 cache로 설정하면 컴파일된 에셋이 블록 트리에서 분리되어 불변 체크아웃에서 배포됩니다.

## 분할 빌드

Static_Prerender_Batch_Renderer는 빌드를 안정적인 N/TOTAL 샤드로 나누며, 호출자가 동일한 분할을 계산할 수 있습니다.

## [작은 스타일시트 인라인 처리](https://blockstudio.dev/ko/docs/blocks/assets/registering/#inline-small-stylesheets)

assets.inlineLimit는 바이트 예산 안에서 가장 작은 블록 스타일시트를 같은 캐스케이드 순서로 인라인 출력합니다.

## [헤드의 마지막에 블록 CSS 배치](https://blockstudio.dev/ko/docs/blocks/assets/registering/#load-order)

블록 CSS는 테마 및 플러그인 스타일시트 뒤, 닫는 head 태그 바로 앞에 추가됩니다.

## [사용하지 않는 에셋 건너뛰기](https://blockstudio.dev/ko/docs/blocks/assets/registering/#disable-enqueuing)

아무것도 반환하지 않는 템플릿은 에셋을 대기열에 추가하지 않습니다. assets.enqueue를 false로 설정하면 모든 에셋을 직접 처리할 수 있습니다.

## [캐시 명령](https://blockstudio.dev/ko/docs/dev/cli/)

wp bs cache status, cleanup, clear 명령으로 런타임 캐시를 확인하고 비우고 삭제할 수 있습니다. wp bs prerender purge 명령은 저장된 페이지를 삭제합니다.

## 깔끔한 제거

wp bs teardown은 이 설치가 소유한 상태만 제거합니다.

## 결과 후크

cache/outcome 및 static_prerender/outcome는 적중, 빌드, 누락, 실패를 메트릭에 보고합니다.

## [오류 후크](https://blockstudio.dev/ko/docs/blocks/hooks/php/#error-handling)

error/logged 및 error/exception은 Blockstudio 오류를 외부 로거 또는 추적기로 전달합니다.

## [일괄 렌더링](https://blockstudio.dev/ko/docs/production/performance/#in-process-batch-rendering)

Batch_Render::reset()는 한 프로세스에서 문서 간 요청 상태를 초기화합니다. render/dependencies는 각 블록의 파일을 나열합니다.

Plus

## 공식 확장 키트

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

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

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