본문으로 건너뛰기

캐싱

Blockstudio에는 영구 파일 기반 캐시가 포함됩니다. 캐시는 기본적으로 cache.enabled 설정을 통해 활성화되며 다음 위치에 기록됩니다.

코드
wp-content/blockstudio/cache/

이 구성된 루트 하나가 런타임 빌드 페이로드, 사전 빌드된 블록 등록 데이터, 편집기 에셋, Tailwind CSS, 렌더링된 문서, 아일랜드 조각, 정적 HTML, 그래프 인덱스, 워밍 큐 및 캐시 진단 정보를 관리합니다. 이렇게 하면 검색, 파싱, 컴파일 및 렌더링 작업을 반복하지 않으면서 생성된 모든 런타임 상태를 호스트가 관리할 수 있는 단일 경계 안에 둘 수 있습니다.

기본 위치는 강화된 호스트가 PHP 캐시 페이로드를 차단할 수 있는 uploads 바깥에 의도적으로 설정되어 있습니다. cache.path로 위치를 변경하세요. 상대 경로는 WP_CONTENT_DIR를 기준으로 확인되고, 절대 경로는 전용 쓰기 가능 캐시 볼륨에 사용할 수 있습니다.

JSON
{
  "cache": {
    "enabled": true,
    "path": "cache/blockstudio"
  }
}

환경별 구성을 적용하려면 설정 필터나 확인된 디렉터리 필터를 사용하세요.

PHP
add_filter('blockstudio/settings/cache/path', function () {
    return '/srv/wordpress-cache/blockstudio';
});

add_filter('blockstudio/cache/dir', function (string $directory): string {
    return WP_CONTENT_DIR . '/cache/blockstudio';
});

경로를 변경하면 빈 캐시부터 시작합니다. wp-content/uploads/blockstudio/cache 아래의 이전 파일은 더 이상 읽히지 않으므로 삭제할 수 있습니다.

ID 및 무효화

모든 범위는 네트워크/블로그 ID와 완전한 런타임 ID 아래에 중첩됩니다. 감시 대상 블록 파일, 필드 파일, 에셋 종속성, 설정, 활성 테마, 활성 플러그인, 논리적 검색 인벤토리, WordPress, PHP 및 Blockstudio 버전을 비롯해 입력이 바뀌면 캐시 항목도 변경됩니다. 항목별 종속성 해시를 사용하면 변경된 항목만 빌드할 때 관련 없는 객체는 격리됩니다.

논리적 검색 소스도 소스 ID, 콘텐츠 지문 및 감시 입력에 반영됩니다. 대체 런타임 선택은 모든 캐시 범위를 분리하는 blockstudio/cache/context 값을 추가할 수 있습니다. 테넌트 경계가 WordPress 네트워크/블로그 ID와 다른 호스트는 blockstudio/cache/site_key를 필터링할 수 있습니다. 결과는 경로 세그먼트로 사용되기 전에 정제됩니다.

워밍된 프런트엔드 요청에서 Blockstudio는 검색 소스를 구성하기 전에 런타임 레지스트리를 복원합니다. 따라서 유효한 캐시 적중 시 재귀적 소스 검색, 블록 구성, 필드 파싱 및 반복적인 캐시 키 트리 순회를 건너뜁니다.

런타임 페이로드에는 확인된 블록 자산 경로, 크기, 타임스탬프 및 모듈 스타일시트 목록도 저장됩니다. 캐시가 준비된 요청에서는 렌더링된 각 블록의 자산 출력 조회와 모듈 디렉터리 스캔을 반복하는 대신 이 메타데이터를 재사용합니다. 자산 URL 및 비활성화 필터는 현재 요청에 대해 계속 실행되며, assets.inlineLimit은 페이지 전체 예산과 캐스케이드 순서를 유지합니다. assets.enqueue 또는 영구 캐싱이 비활성화되어 있으면 자산 출력 메타데이터를 수집하지 않습니다. 오래된 마지막 정상 빌드는 디스크에서 자산을 확인하는 방식으로 대체됩니다.

변경되지 않은 해석된 설정도 요청 내에서 동일한 지문을 재사용합니다. 설정을 다시 불러오거나 변경하면 지문이 무효화됩니다. 변경 가능한 객체 또는 참조 값은 오래된 지문을 재사용하지 않고 다시 해시합니다.

production 및 staging에서는 검증된 감시 스냅샷을 20초 동안 신뢰한 뒤 Blockstudio가 파일과 디렉터리 정보를 다시 확인합니다. local 및 development 환경의 기본값은 0이므로 소스 편집 내용이 즉시 반영됩니다. 이 간격은 다음과 같이 변경할 수 있습니다.

PHP
add_filter('blockstudio/cache/watch_debounce', function () {
    return 30;
});

디바운스는 자동 소스 변경 감지를 설정된 시간(초)만큼 지연할 수 있습니다. 필수 컴파일 에셋, 캐시된 비어 있지 않은 원시 에셋, 모듈 스타일시트는 캐시 적중 시에도 매번 확인합니다. 이를 삭제하면 유예 기간이 끝날 때까지 오래된 에셋 메타데이터를 제공하는 대신 런타임 페이로드가 즉시 무효화됩니다. 프로덕션과 유사한 환경에서 파일을 직접 편집하는 경우 디바운스를 0으로 설정하세요.

캐시 페이로드는 PHP 파일로 보호됩니다. 쓰기 프로세스에 활성 OPcache 공유 메모리가 있고 대상이 제외되지 않은 경우 작은 페이로드에는 일반 배열을 사용합니다. 그러면 OPcache가 이후 include에서 컴파일된 배열을 재사용할 수 있습니다. 반환된 데이터를 수정할 때는 PHP의 일반적인 copy-on-write 동작이 적용됩니다.

공유 메모리 OPcache가 없으면 페이로드는 압축된 직렬화 데이터로 유지됩니다. OPcache가 가득 찼거나 API을 사용할 수 없거나 제한된 경우, 또는 블랙리스트나 opcache.max_file_size에서 해당 파일을 제외한 경우에도 마찬가지입니다. 파일 캐시 전용 OPcache는 일반 배열 형식을 선택하지 않습니다. 호스트 수준 제어는 PHP OPcache 구성을 참조하세요.

기본 일반 배열 형식의 최대 크기는 1 MiB이며, 직렬화된 데이터와 생성된 PHP 소스 모두를 기준으로 측정합니다. CLI 프로세스에서 OPcache 없이 웹 워커가 준비한 캐시를 읽을 때 대규모 배열 컴파일 비용이 발생하지 않도록, 더 큰 페이로드는 압축된 상태로 유지됩니다. 이러한 리더에서는 작은 일반 파일도 여전히 파싱해야 하며, 새로 작성된 파일은 opcache.file_update_protection 중에 컴파일해야 할 수 있습니다.

blockstudio/cache/compress 필터는 범위별로 형식을 재정의합니다. 예를 들어 WP-CLI이 OPcache가 활성화된 웹 워커용 캐시 파일을 준비하는 경우에 사용할 수 있습니다. false을 반환하면 크기 제한도 재정의됩니다. 모든 리더가 생성된 PHP 파일을 처리할 수 있을 때만 이렇게 하세요. zlib을 사용할 수 없으면 일반 PHP이 대체 형식으로 사용됩니다.

동시성 및 보존

콜드 캐시 키는 단일 실행 잠금을 사용합니다. 한 요청이 페이로드를 빌드하는 동안 동시 요청은 동일한 검색이나 컴파일 작업을 반복하는 대신 원자적으로 게시된 결과를 기다립니다. 원자적 게시로 불완전한 객체가 방지됩니다. 새로 고침에 실패해도 유효한 마지막 정상 객체가 계속 제공되고 실패 원인을 확인할 수 있으며, 다음 요청에서 복구할 수 있습니다.

런타임 범위에는 기본적으로 게시된 페이로드 20개가 보존됩니다. 통합에서 의도적으로 더 많은 캐시 컨텍스트를 생성하는 경우 범위별 한도를 조정하세요.

PHP
add_filter(
    'blockstudio/cache/max_files_per_scope',
    function (int $maximum, string $scope): int {
        return 'runtime' === $scope ? 50 : $maximum;
    },
    10,
    2
);

보존 정책은 설치된 조기 제공 맵이 참조하는 파일을 삭제하지 않으며, blockstudio/cache/protected_paths 필터는 정리 시 그대로 보존해야 할 추가 경로를 표시합니다.

사용하지 않는 네임스페이스는 플러그인 활성화 및 PHP 또는 WordPress 업데이트 때마다 쌓이지 않도록 자동 수집됩니다. 이전 Tailwind 캐시 디렉터리를 검색하던 배포 스크립트는 대신 Blockstudio\Runtime_Cache::purge('tailwind')를 호출해야 합니다.

예를 들어 WordPress 코어 업데이트 후 런타임 ID가 바뀌면 네임스페이스는 폐기 상태가 됩니다. 첫 번째 정리 작업에서 폐기 상태를 확인하면 그 안에 .retired 마커가 기록되고, 그 시점부터 cache.namespaceGrace초(기본값은 하루)가 지나면 트리가 수집됩니다. 그 사이에 트리에 다시 쓰기가 발생하면 유예 기간이 새로 시작됩니다. 범위의 현재 네임스페이스나 조기 제공 맵이 활성화된 아티팩트를 계속 제공하는 네임스페이스는 수집되지 않습니다. 후자의 유예 기간은 다음 활성화에서 맵 항목이 다른 위치로 이동한 뒤 시작됩니다. WordPress 외부에 캐시된 페이지는 렌더링 당시 사용한 콘텐츠 해시 스타일시트를 계속 참조하므로, CDN 또는 긴 브라우저 캐시를 통해 tailwind.output: "link" 페이지를 제공하는 사이트는 해당 사본이 유지될 수 있는 가장 긴 시간에 맞춰 유예 기간을 늘려야 합니다.

JSON
{
  "cache": {
    "namespaceGrace": 777600
  }
}

업그레이드된 설치에 7.6 이전의 평면형 cache/runtime 디렉터리가 있으면 Blockstudio가 이를 활성 경로 밖으로 원자적으로 이름을 변경합니다. 그런 다음 WP-Cron 작업이 실행될 때마다 파일 시스템 항목을 최대 500개씩 제거합니다. 이렇게 하면 오래된 페이로드와 .build.lock 트리가 디스크를 차지하지 않으면서 대형 디렉터리를 감지한 요청이 재귀적으로 삭제 작업을 수행하지 않습니다. 정리는 cache.enabled가 활성 상태일 때만 실행됩니다. 호스트에서 한 번에 처리할 양을 줄이거나 늘리려면 blockstudio/cache/legacy_cleanup_batch_size로 배치 크기를 변경하세요.

blockstudio.json에서 영구 캐시를 비활성화합니다.

JSON
{
  "cache": {
    "enabled": false
  }
}

또는 필터를 사용합니다:

PHP
add_filter('blockstudio/settings/cache/enabled', '__return_false');

성능에서 설명하는 요청별 메모리 렌더링 캐시는 의도적으로 분리되어 있지만, 영구 아티팩트는 이와 동일한 파일 시스템 경계를 사용합니다.

레거시 잠금 파일 대기열 비우기

7.6.14 이전 릴리스는 콘텐츠가 변경될 때마다 .build.lock 파일을 하나씩 남겼으며, 트래픽이 많은 사이트에는 수십만 개가 쌓일 수 있습니다. 업그레이드한 뒤에는 WP-Cron가 제한된 배치로 자동 제거합니다. 대기열을 즉시 비우고 호스트에 수량을 전달하려면 CLI를 실행하세요.

셸
wp bs cache status
wp bs cache cleanup

status는 남은 레거시 잠금 파일 수를 세고 다음 배치 실행 시점을 알려줍니다. cleanup은 유휴 항목이 남지 않을 때까지 배치를 실행한 다음 유예 기간이 지난 캐시 네임스페이스를 수집합니다. 한 시간 이내에 생성된 잠금 파일이나 실행 중인 요청이 보유한 잠금 파일은 다음 실행 때까지 남겨둡니다. 사이트에 트래픽이 있는 동안 잠금 파일을 직접 삭제하지 마세요. 보유 중인 잠금은 동시 요청이 병렬로 빌드하지 않도록 조정하는 역할을 합니다.

wp bs cache clear는 현재 사이트의 전체 런타임 캐시를 비우거나, --scope=runtime를 사용해 모든 네임스페이스에서 범위 하나를 비웁니다. 다음 요청은 빈 캐시부터 다시 빌드하므로 트래픽이 적을 때 실행하세요.

Tailwind 캐시

Tailwind의 컴파일된 CSS 캐시는 네트워크/사이트/런타임 네임스페이스와 tailwind 범위 아래의 공유 런타임 루트를 사용합니다. 기본적으로 최대 1,000개 항목을 30일 동안 저장하므로 소수의 경로만 남기고 제거하지 않고 사이트 전체의 페이지 수준 키를 보존할 수 있습니다.

Tailwind는 수명이 긴 프로세스 안에서 동일한 CSS 입력에 워밍된 컴파일러를 재사용하고, 프로세스 간에도 컴파일러 생성 상태를 유지합니다. 콜드 페이지 후보 집합은 계속 각각 컴파일되지만 매번 프레임워크 파서를 다시 만들 필요는 없습니다.

보존 기간을 변경하려면 다음 필터를 사용하세요.

PHP
add_filter('blockstudio/tailwind/cache_max_files', function () {
    return 1500;
});

add_filter('blockstudio/tailwind/cache_max_age', function () {
    return 14 * DAY_IN_SECONDS;
});

최소 수명은 1시간입니다.

캐시 파일은 콘텐츠 해시를 사용하며 캐시된 페이지는 각 파일을 URL로 참조하므로, 제거된 항목과 저장된 페이지가 여전히 필요한 파일이 무엇인지에 대해 서로 다를 수 있습니다. 프리렌더링된 문서는 제공되기 전에 연결된 스타일시트가 있는지 확인하므로, 파일이 제거되면 스타일이 없는 페이지를 제공하는 대신 한 번 다시 렌더링합니다. 서로 다른 페이지 수준 키의 수보다 cache_max_files를 높이면 다시 렌더링할 필요가 없습니다.

정적 프리렌더링

동일한 루트 아래에 있는 익명 HTML 캐시입니다.