put(self::$extensionCacheVersionKey, $newVersion); Log::info('확장 기능 캐시 버전 증가', [ 'new_version' => $newVersion, ]); } catch (\Exception $e) { Log::warning('확장 기능 캐시 버전 증가 중 오류', [ 'error' => $e->getMessage(), ]); } } /** * 현재 확장 기능 캐시 버전을 반환합니다. * * @return int 캐시 버전 (타임스탬프) 또는 0 (미설정 시) */ public static function getExtensionCacheVersion(): int { return (int) self::resolveExtensionCache()->get(self::$extensionCacheVersionKey, 0); } /** * 모든 활성 템플릿의 언어 캐시를 무효화합니다. * * 버전 있는 캐시는 incrementExtensionCacheVersion()으로 무효화됩니다. * 이전 버전 캐시는 TTL로 자연 만료됩니다. * 이 메서드는 호출 호환성 유지용입니다. */ protected function clearAllTemplateLanguageCaches(): void { Log::info('템플릿 언어 캐시 무효화 (캐시 버전 증가로 처리)'); } /** * 모든 활성 템플릿의 routes 캐시를 무효화합니다. * * 버전 있는 캐시는 incrementExtensionCacheVersion()으로 무효화됩니다. * 이전 버전 캐시는 TTL로 자연 만료됩니다. * 이 메서드는 호출 호환성 유지용입니다. */ protected function clearAllTemplateRoutesCaches(): void { Log::info('템플릿 routes 캐시 무효화 (캐시 버전 증가로 처리)'); } /** * 모든 활성 템플릿의 레이아웃 캐시를 무효화합니다. * * 버전 있는 캐시는 incrementExtensionCacheVersion()으로 무효화됩니다. * 이전 버전 캐시는 TTL로 자연 만료됩니다. * 이 메서드는 호출 호환성 유지용입니다. */ protected function clearAllTemplateLayoutCaches(): void { Log::info('템플릿 레이아웃 캐시 무효화 (캐시 버전 증가로 처리)'); } /** * CacheInterface 인스턴스를 컨테이너에서 lazy 조회합니다. * * 컨테이너 미구성 환경(예: 일부 단위 테스트)에서도 동작하도록 * fallback 으로 직접 CoreCacheDriver 를 생성합니다. */ private static function resolveExtensionCache(): CacheInterface { try { return app(CacheInterface::class); } catch (\Throwable $e) { return new CoreCacheDriver(config('cache.default', 'array')); } } }