fix(core): 공개 템플릿 config 캐시 무효화 누락과 확장 캐시 삭제 경로 동종 결함 정비

공개 config.json 의 고정 캐시 키(template.config.{identifier})가 어떤 갱신
경로에서도 forget 되지 않아 template:update/cache-clear/비활성화/삭제 후에도
최대 1시간(TTL) 이전 manifest 로 응답되던 결함(공개 )을 수정한다.

- TemplateManager::clearTemplateCache 공개화 — config/components_manifest(두
 변종)/현재 버전 routes·language 키 능동 forget, updateTemplate cleanup 호출
- forgetLayoutCacheKeys 가 편집기용 .with_source_meta 변종까지 삭제
- ext.cache_version 쓰기를 incrementExtensionCacheVersion 단일 지점으로 통일
- module/plugin:cache-clear 의 유령 키 forget 을 실재 캐시(레이아웃 서빙/해석
 캐시, 상태 키, 미들웨어 인덱스, 버전 bump) 무효화로 교체
- 공개 routes/language/layout API 의 ?v 생략 폴백을 0 → 현재 버전으로 교정
This commit is contained in:
HeuJung committed 2026-08-17 13:22:48 +09:00
1 parent 09a700e4c7
commit e819db9d42
27 files changed
+891 -247

No files matched your search

@@ -16,7 +16,11 @@ use Tests\TestCase;
* 새 CacheInterface 를 통해 캐시를 삭제하는지 검증.
*
* 실제 명령어 실행은 모듈 manager / plugin manager 의존성이 크므로,
* 명령어가 사용하는 키 형식과 forget 동작을 키 차원에서 검증합니다.
* CacheInterface 의 다건 put/forget 왕복 동작을 키 차원에서 검증합니다.
*
* 주의: 아래 키 문자열은 이관 당시의 픽스처다. 현행 커맨드는 유령 키 forget 을
* 제거하고 상태 키 무효화 + 레이아웃 캐시 + 버전 bump 로 동작한다 (#588) —
* 커맨드의 실동작 검증은 {Module,Plugin,Template}ArtisanCommandsTest 가 담당한다.
*/
class ArtisanCacheClearTest extends TestCase
{
@@ -38,9 +42,7 @@ class ArtisanCacheClearTest extends TestCase
}
/**
* G-1-1: module:cache-clear 명령어 — 모듈 관련 캐시 삭제 검증.
*
* ClearModuleCacheCommand::clearModuleCache() 가 사용하는 키 패턴을 검증.
* G-1-1: 모듈 키 픽스처 다건 put→forget 왕복 (드라이버 동작 검증 — 커맨드 미호출).
*/
#[Test]
public function g_1_1_module_cache_clear_removes_per_module_keys(): void
@@ -58,7 +60,7 @@ class ArtisanCacheClearTest extends TestCase
$this->cache->put($k, 'data');
}
// 명령어 핸들러 시뮬레이션 — CacheInterface.forget 호출
// CacheInterface.forget 다건 호출 (드라이버 동작 검증)
foreach ($keys as $k) {
$this->cache->forget($k);
}
@@ -69,7 +71,7 @@ class ArtisanCacheClearTest extends TestCase
}
/**
* G-1-2: plugin:cache-clear 명령어 — 플러그인 캐시 삭제.
* G-1-2: 플러그인 키 픽스처 다건 put→forget 왕복 (드라이버 동작 검증 — 커맨드 미호출).
*/
#[Test]
public function g_1_2_plugin_cache_clear_removes_per_plugin_keys(): void
@@ -96,7 +98,7 @@ class ArtisanCacheClearTest extends TestCase
}
/**
* G-1-3: template:cache-clear 명령어 — 템플릿 + 레이아웃 + routes + 다국어 캐시 삭제.
* G-1-3: 템플릿/레이아웃 키 픽스처 다건 put→forget 왕복 (드라이버 동작 검증 — 커맨드 미호출).
*/
#[Test]
public function g_1_3_template_cache_clear_removes_template_layout_routes(): void
@@ -127,7 +129,7 @@ class ArtisanCacheClearTest extends TestCase
}
/**
* G-1-4: 인수 없이 호출 시 모든 모듈 캐시 + 전역 키 삭제.
* G-1-4: 전역 + 개별 키 혼합 다건 put→forget 왕복 (드라이버 동작 검증 — 커맨드 미호출).
*/
#[Test]
public function g_1_4_clear_without_args_clears_all(): void
@@ -143,7 +145,7 @@ class ArtisanCacheClearTest extends TestCase
$this->cache->put("module.info.{$id}", 'data');
}
// 명령어 시뮬레이션 — 전역 + 개별 모두 삭제
// 전역 + 개별 모두 forget (드라이버 동작 검증)
$globalKeys = ['modules.all', 'modules.active', 'modules.installed'];
foreach ($globalKeys as $k) {
$this->cache->forget($k);
@@ -0,0 +1,86 @@
<?php
namespace Tests\Unit\Extension;
use PHPUnit\Framework\Attributes\Test;
use Tests\TestCase;
/**
* 템플릿 업데이트 성공 cleanup 의 config 캐시 무효화 구조 테스트 (#588, 공개 #119)
*
* `template.config.{identifier}` 는 버전 접미사 없는 고정 키라 캐시 버전 bump 로
* 무효화되지 않는다. updateTemplate() 성공 cleanup 이 clearTemplateCache() 를
* 직접 호출하지 않으면, 비활성 업데이트·레이아웃 무변경 업데이트 경로에서 공개
* config.json 이 TTL(1시간) 동안 이전 manifest 를 계속 서빙한다.
*
* 실제 updateTemplate() 통합 실행은 업데이트 소스(_pending/신버전) 픽스처가 필요해
* 비용이 크므로, clearTemplateCache() 의 키 삭제는 TemplateCacheManagementTest 가
* 동작으로 검증하고 본 테스트는 호출 존재를 소스 구조로 고정한다
* (선례: ExtensionUpdateStatusCacheSymmetryTest).
*/
class TemplateUpdateConfigCacheInvalidationTest extends TestCase
{
/**
* @scenario cache_state=warm_current,lifecycle_trigger=template_update,template_type=user
*
* @effects template_update_invalidates_public_config_cache
*/
#[Test]
public function update_template_cleanup_calls_clear_template_cache(): void
{
$body = $this->methodSource(
base_path('app/Extension/TemplateManager.php'),
'updateTemplate'
);
$this->assertStringContainsString(
'$this->clearTemplateCache(',
$body,
'updateTemplate() 성공 cleanup 이 clearTemplateCache() 를 호출해야 합니다 — '
.'누락 시 공개 config.json 이 캐시 TTL 동안 이전 manifest 로 응답됩니다.'
);
}
/**
* 대상 메서드 본문을 주석 제거 후 반환합니다.
*
* 주석을 남겨 두면 설명 문장에 들어 있는 호출 표기가 검사를 통과시킨다.
*
* @param string $path 대상 파일 절대 경로
* @param string $method 대상 메서드명
* @return string 주석이 제거된 메서드 본문
*/
private function methodSource(string $path, string $method): string
{
$this->assertFileExists($path);
$stripped = '';
foreach (token_get_all(file_get_contents($path)) as $token) {
if (is_array($token) && in_array($token[0], [T_COMMENT, T_DOC_COMMENT], true)) {
continue;
}
$stripped .= is_array($token) ? $token[1] : $token;
}
$start = strpos($stripped, "public function {$method}(");
$this->assertNotFalse($start, "{$path} 에서 {$method}() 메서드를 찾지 못했습니다.");
// 중괄호 균형으로 메서드 본문 끝을 찾는다
$open = strpos($stripped, '{', $start);
$depth = 0;
$length = strlen($stripped);
for ($i = $open; $i < $length; $i++) {
if ($stripped[$i] === '{') {
$depth++;
} elseif ($stripped[$i] === '}') {
$depth--;
if ($depth === 0) {
return substr($stripped, $open, $i - $open + 1);
}
}
}
$this->fail("{$path} 의 {$method}() 본문 끝을 찾지 못했습니다.");
}
}