fix(core,basic): 검색 봇 화면 렌더러 패리티 결손 일괄 수정
일반 화면(React)과 봇 화면(PHP)은 같은 레이아웃을 각각 렌더하는데 봇 화면 쪽 지원 범위가 뒤처져, 확장이 교체한 본문이 통째로 빈 채 나갔다 (공개 이슈 ). 같은 결손 계열을 전수 조사해 함께 닫는다. - 확장 주입 props 를 렌더 진입 시점에 해석해 자손 전체에 상속 → 게시글·답글 원글·댓글·페이지·상품 설명 5개 지점 복구 - 사용자 작성 HTML 정화기 신설 — isHtml 판정에 따라 이스케이프/정화. 미정화 상태에서 봇 경로로 저장형 스크립트가 실제 실행됐다 - 노드 키 패리티: conditions / type:iterator / responsive 매칭 규칙 / children 문자열 / text 우선순위 / $t:defer / 레이아웃 초기 상태 - 표현식: 단일 바인딩 판정 교체, ||·&& 를 값 반환(JS 시맨틱)으로, 비교식이 raw 경로에서 null 이 되던 문제 - 데이터소스: 엔드포인트 표현식 전면 해석 + 레이아웃 8곳 선언 보강 - 봇 페이지 캐시 1회 전량 무효화 업그레이드 스텝 지원 범위 SSoT 표를 문서에 고정하고, 한쪽만 고치는 것을 막는 검사 룰과 레이아웃 전수 순회 테스트로 잠갔다.
This commit is contained in:
1 parent
b505ac7ba7
commit
0dfb45951b
34 files changed
+5244
-172
No files matched your search
@@ -0,0 +1,129 @@
|
||||
<?php
|
||||
|
||||
namespace App\Upgrades\Data\V7_0_6\Migrations;
|
||||
|
||||
use App\Extension\Cache\CoreCacheDriver;
|
||||
use App\Extension\Upgrade\DataMigration;
|
||||
use App\Extension\UpgradeContext;
|
||||
use Illuminate\Support\Facades\Log;
|
||||
|
||||
/**
|
||||
* 봇용 페이지 캐시를 1회 전량 무효화합니다.
|
||||
*
|
||||
* 배경:
|
||||
* 7.0.6 이전의 봇 렌더러는 레이아웃 확장이 교체한 본문 영역(게시글·댓글·페이지·상품
|
||||
* 설명)을 빈 요소로 내보냈고, 그 결과물이 페이지 캐시에 그대로 저장되어 있다.
|
||||
* 렌더러를 고쳐도 캐시가 유효한 동안에는 검색 봇이 계속 빈 본문을 받는다.
|
||||
* 캐시 수명(TTL)을 길게 잡아 둔 사이트일수록 오래 남으므로 업그레이드 시 한 번 비운다.
|
||||
*
|
||||
* 멱등: 인덱스가 없으면 아무 것도 하지 않는다. 재실행해도 부작용이 없다.
|
||||
*
|
||||
* 실패 정책: 캐시 삭제 실패가 업그레이드 전체를 막지 않는다(경고 후 계속).
|
||||
* 비우지 못해도 캐시 수명이 지나면 자연히 새 결과물로 교체된다.
|
||||
*
|
||||
* 격리 원칙 (docs/extension/upgrade-step-guide.md §13):
|
||||
* `SeoCacheManager` 를 참조하지 않는다. 캐시 키 프리픽스와 인덱스 키를 본 클래스에
|
||||
* 로컬 상수로 동결해 V-1 안전을 확보한다 — 미래 버전에서 그 클래스의 상수가 바뀌어도
|
||||
* 본 스텝은 7.0.6 시점의 캐시를 대상으로 동작해야 한다.
|
||||
*/
|
||||
final class ClearSeoPageCacheAfterRendererParityFix implements DataMigration
|
||||
{
|
||||
/**
|
||||
* 봇 페이지 캐시가 저장한 URL 인덱스 키 (7.0.6 시점 고정값).
|
||||
*/
|
||||
private const INDEX_KEY = 'seo.cached_urls';
|
||||
|
||||
/**
|
||||
* 봇 페이지 캐시 키 프리픽스 (7.0.6 시점 고정값).
|
||||
*
|
||||
* 인덱스가 손상되어 다른 네임스페이스의 키가 섞여 있어도 봇 페이지 캐시 밖의
|
||||
* 데이터를 지우지 않도록, 삭제 대상을 이 프리픽스로 한정합니다.
|
||||
*/
|
||||
private const CACHE_PREFIX = 'seo.page.';
|
||||
|
||||
/**
|
||||
* 마이그레이션 식별자 (로그용).
|
||||
*
|
||||
* @return string 식별자
|
||||
*/
|
||||
public function name(): string
|
||||
{
|
||||
return 'ClearSeoPageCacheAfterRendererParityFix';
|
||||
}
|
||||
|
||||
/**
|
||||
* 저장된 봇 페이지 캐시를 전량 삭제합니다.
|
||||
*
|
||||
* @param UpgradeContext $context 업그레이드 컨텍스트
|
||||
*/
|
||||
public function run(UpgradeContext $context): void
|
||||
{
|
||||
try {
|
||||
$this->runInternal($context);
|
||||
} catch (\Throwable $e) {
|
||||
// 업그레이드 중단 금지 — 캐시 삭제 실패가 업그레이드 전체를 막지 않는다.
|
||||
$context->logger->warning(sprintf(
|
||||
'[7.0.6] 봇 페이지 캐시 무효화 실패 (캐시 수명 만료로 자연 해소, 계속 진행): %s',
|
||||
$e->getMessage(),
|
||||
));
|
||||
Log::warning('7.0.6 ClearSeoPageCacheAfterRendererParityFix 실패', [
|
||||
'error' => $e->getMessage(),
|
||||
'trace' => $e->getTraceAsString(),
|
||||
]);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 실제 삭제 로직.
|
||||
*
|
||||
* @param UpgradeContext $context 업그레이드 컨텍스트
|
||||
*/
|
||||
private function runInternal(UpgradeContext $context): void
|
||||
{
|
||||
$cache = $this->resolveCache();
|
||||
if ($cache === null) {
|
||||
$context->logger->info('[7.0.6] 봇 페이지 캐시 드라이버 미가용 — skip');
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
$index = $cache->get(self::INDEX_KEY);
|
||||
if (! is_array($index) || $index === []) {
|
||||
$context->logger->info('[7.0.6] 봇 페이지 캐시 — 비울 대상 없음');
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
$count = 0;
|
||||
foreach ($index as $entry) {
|
||||
$key = is_array($entry) ? ($entry['key'] ?? null) : null;
|
||||
if (! is_string($key) || ! str_starts_with($key, self::CACHE_PREFIX)) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$cache->forget($key);
|
||||
$count++;
|
||||
}
|
||||
|
||||
$cache->forget(self::INDEX_KEY);
|
||||
|
||||
$context->logger->info(sprintf('[7.0.6] 봇 페이지 캐시 %d건 무효화 완료', $count));
|
||||
}
|
||||
|
||||
/**
|
||||
* 코어 캐시 드라이버를 반환합니다.
|
||||
*
|
||||
* 컨테이너 바인딩에 의존하지 않고 직접 생성합니다 — 업그레이드 시점에는 바인딩이
|
||||
* 없을 수 있습니다. 생성 실패 시 null 을 반환해 스텝을 건너뜁니다.
|
||||
*
|
||||
* @return CoreCacheDriver|null 캐시 드라이버 (미가용 시 null)
|
||||
*/
|
||||
private function resolveCache(): ?CoreCacheDriver
|
||||
{
|
||||
try {
|
||||
return new CoreCacheDriver(config('cache.default', 'array'));
|
||||
} catch (\Throwable) {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user