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:
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}() 본문 끝을 찾지 못했습니다.");
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user