feat(seo): 사이트맵 스트리밍 생성 + SEO 캐시 설정 정합화
대용량 사이트에서 사이트맵 생성이 메모리 부족으로 반복 실패하던 문제(공개 )의 1단계로, 전체 URL을 메모리에 적재하던 구조를 스트리밍 분할 생성으로 교체한다. 사이트맵 스트리밍 코어: - SitemapWriter — 자식 파일 1개 분량만 버퍼링하고 임계 도달 시 flush. StorageInterface가 append를 제공하지 않아(put이 전체 덮어쓰기) 택한 구조이며, 최대 메모리가 "자식 파일 1개 크기"로 유계가 된다. URL 수(50,000)와 바이트(45MB) 두 임계로 분할해 sitemaps.org 프로토콜을 지킨다. - 커밋은 _tmp 전량 기록 → live 재배치 → manifest 마지막 기록 순. manifest 존재가 커밋 완료 신호다. 기존 manifest를 먼저 지우지 않아 스왑 중 봇에게 503이 나가지 않는다. - SitemapFileStore — 읽기측 + 파일 경로 SSoT. SitemapXmlRenderer — escape 단일 출처. 데이터 접근 계층 정리: - contributor 3종이 쿼리를 직접 조립하던 것을 Repository 위임으로 전환. MySQL 버퍼드 쿼리에서 cursor는 결과셋 전체를 적재하므로 lazyById를 쓴다. - SeoCacheStatsService → SeoCacheStatRepository 신설 (집계 4쿼리 → 1쿼리). - audit 룰 service-direct-data-access의 사각 2건 수정 — 확장 디렉토리 정규식이 상대경로를 매칭하지 못해 *Contributor처럼 접미사 없는 클래스가 전부 미검출이었다. SEO 캐시 설정 정합화: - SEO 설정의 캐시 3키가 cache 카테고리 형제 키에 항상 져서 운영자 입력이 조용히 무시되고 있었다(설정을 cache 카테고리로 이관하며 SEO 탭 옛 칸을 미제거). 고급 탭을 기준값으로 두되 SEO 탭에 지정이 있으면 오버라이드하도록 SeoCacheSettings 단일 출처로 정리. "지정 여부"는 null로 판정하므로 기본값을 비웠다. - 기존 설치는 Upgrade_7_1_0이 이행 — 옛 기본값과 같으면 미설정으로 비우고, 다르면 운영자 의도로 보아 보존한다. 코어 버전 bump와 루트 CHANGELOG는 계획서 결정(D20)에 따라 마감 단계에서 일괄 수행한다.
This commit is contained in:
1 parent
fcaacad8d1
commit
21f666e4b5
75 files changed
+4767
-951
No files matched your search
@@ -0,0 +1,241 @@
|
||||
<?php
|
||||
|
||||
namespace Tests\Unit\Upgrades;
|
||||
|
||||
require_once __DIR__.'/../../../upgrades/data/7.1.0/migrations/01_NullifyUntouchedSeoCacheOverrides.php';
|
||||
|
||||
use App\Extension\UpgradeContext;
|
||||
use App\Upgrades\Data\V7_1_0\Migrations\NullifyUntouchedSeoCacheOverrides;
|
||||
use Illuminate\Support\Facades\Storage;
|
||||
use Tests\TestCase;
|
||||
|
||||
/**
|
||||
* 7.1.0 업그레이드 스텝 — SEO 캐시 오버라이드 이행 (결정 D19)
|
||||
*
|
||||
* 판정 규칙:
|
||||
* 옛 기본값과 같으면 "안 건드린 것" → null(미설정)로 비움
|
||||
* 옛 기본값과 다르면 "의도적으로 바꾼 것" → 보존 (이제부터 오버라이드로 발동)
|
||||
*
|
||||
* 이 판정이 틀리면 기존 사이트의 캐시 동작이 의도치 않게 바뀐다.
|
||||
*/
|
||||
class NullifyUntouchedSeoCacheOverridesTest extends TestCase
|
||||
{
|
||||
private NullifyUntouchedSeoCacheOverrides $migration;
|
||||
|
||||
/**
|
||||
* 테스트 초기화 - settings 디스크를 가짜로 대체합니다.
|
||||
*/
|
||||
protected function setUp(): void
|
||||
{
|
||||
parent::setUp();
|
||||
|
||||
Storage::fake('settings');
|
||||
$this->migration = new NullifyUntouchedSeoCacheOverrides;
|
||||
}
|
||||
|
||||
/**
|
||||
* 업그레이드 컨텍스트를 만듭니다.
|
||||
*
|
||||
* @return UpgradeContext 컨텍스트
|
||||
*/
|
||||
private function context(): UpgradeContext
|
||||
{
|
||||
return new UpgradeContext('7.0.5', '7.1.0', '7.1.0');
|
||||
}
|
||||
|
||||
/**
|
||||
* seo.json 을 기록합니다.
|
||||
*
|
||||
* @param array<string, mixed> $settings 설정 배열
|
||||
*/
|
||||
private function writeSeoJson(array $settings): void
|
||||
{
|
||||
Storage::disk('settings')->put('seo.json', json_encode($settings));
|
||||
}
|
||||
|
||||
/**
|
||||
* seo.json 을 읽습니다.
|
||||
*
|
||||
* @return array<string, mixed> 설정 배열
|
||||
*/
|
||||
private function readSeoJson(): array
|
||||
{
|
||||
return json_decode(Storage::disk('settings')->get('seo.json'), true);
|
||||
}
|
||||
|
||||
/**
|
||||
* name: 로그용 식별자를 반환한다
|
||||
*/
|
||||
public function test_name_returns_identifier(): void
|
||||
{
|
||||
$this->assertSame('NullifyUntouchedSeoCacheOverrides', $this->migration->name());
|
||||
}
|
||||
|
||||
/**
|
||||
* 옛 기본값 그대로인 키는 null 로 비운다 (안 건드린 것으로 추정)
|
||||
*/
|
||||
public function test_clears_keys_left_at_legacy_defaults(): void
|
||||
{
|
||||
$this->writeSeoJson([
|
||||
'cache_enabled' => true,
|
||||
'cache_ttl' => 7200,
|
||||
'sitemap_cache_ttl' => 86400,
|
||||
'sitemap_enabled' => true,
|
||||
]);
|
||||
|
||||
$this->migration->run($this->context());
|
||||
$result = $this->readSeoJson();
|
||||
|
||||
$this->assertNull($result['cache_enabled']);
|
||||
$this->assertNull($result['cache_ttl']);
|
||||
$this->assertNull($result['sitemap_cache_ttl']);
|
||||
}
|
||||
|
||||
/**
|
||||
* 옛 기본값과 다른 값은 보존한다 (의도적으로 바꾼 것 → 오버라이드로 발동)
|
||||
*
|
||||
* 실제 사례: seo.cache_ttl=3600 을 설정해 뒀으나 그동안 무시되던 사이트.
|
||||
*/
|
||||
public function test_preserves_values_that_differ_from_legacy_defaults(): void
|
||||
{
|
||||
$this->writeSeoJson([
|
||||
'cache_enabled' => false,
|
||||
'cache_ttl' => 3600,
|
||||
'sitemap_cache_ttl' => 604800,
|
||||
]);
|
||||
|
||||
$this->migration->run($this->context());
|
||||
$result = $this->readSeoJson();
|
||||
|
||||
$this->assertFalse($result['cache_enabled'], 'false 는 기본값(true)과 다르므로 보존돼야 합니다.');
|
||||
$this->assertSame(3600, $result['cache_ttl']);
|
||||
$this->assertSame(604800, $result['sitemap_cache_ttl']);
|
||||
}
|
||||
|
||||
/**
|
||||
* 일부만 바뀐 경우 — 바뀐 것만 보존하고 나머지는 비운다
|
||||
*/
|
||||
public function test_clears_untouched_and_preserves_changed_in_same_file(): void
|
||||
{
|
||||
$this->writeSeoJson([
|
||||
'cache_enabled' => true, // 기본값 → 비움
|
||||
'cache_ttl' => 3600, // 변경됨 → 보존
|
||||
'sitemap_cache_ttl' => 86400, // 기본값 → 비움
|
||||
]);
|
||||
|
||||
$this->migration->run($this->context());
|
||||
$result = $this->readSeoJson();
|
||||
|
||||
$this->assertNull($result['cache_enabled']);
|
||||
$this->assertSame(3600, $result['cache_ttl']);
|
||||
$this->assertNull($result['sitemap_cache_ttl']);
|
||||
}
|
||||
|
||||
/**
|
||||
* seo 카테고리의 다른 키는 건드리지 않는다
|
||||
*/
|
||||
public function test_does_not_touch_unrelated_keys(): void
|
||||
{
|
||||
$this->writeSeoJson([
|
||||
'cache_ttl' => 7200,
|
||||
'sitemap_enabled' => true,
|
||||
'sitemap_schedule' => 'hourly',
|
||||
'sitemap_schedule_time' => '03:00',
|
||||
'meta_title_suffix' => ' | G7',
|
||||
]);
|
||||
|
||||
$this->migration->run($this->context());
|
||||
$result = $this->readSeoJson();
|
||||
|
||||
$this->assertTrue($result['sitemap_enabled']);
|
||||
$this->assertSame('hourly', $result['sitemap_schedule'], '재생성 주기는 이 이행과 무관합니다.');
|
||||
$this->assertSame('03:00', $result['sitemap_schedule_time']);
|
||||
$this->assertSame(' | G7', $result['meta_title_suffix']);
|
||||
}
|
||||
|
||||
/**
|
||||
* 멱등: 두 번 실행해도 결과가 같다
|
||||
*/
|
||||
public function test_is_idempotent(): void
|
||||
{
|
||||
$this->writeSeoJson([
|
||||
'cache_ttl' => 7200,
|
||||
'sitemap_cache_ttl' => 3600,
|
||||
]);
|
||||
|
||||
$this->migration->run($this->context());
|
||||
$first = $this->readSeoJson();
|
||||
|
||||
$this->migration->run($this->context());
|
||||
$second = $this->readSeoJson();
|
||||
|
||||
$this->assertSame($first, $second);
|
||||
$this->assertNull($second['cache_ttl']);
|
||||
$this->assertSame(3600, $second['sitemap_cache_ttl']);
|
||||
}
|
||||
|
||||
/**
|
||||
* 이미 null 인 키는 그대로 둔다 (재실행 안전)
|
||||
*/
|
||||
public function test_leaves_already_null_keys_untouched(): void
|
||||
{
|
||||
$this->writeSeoJson(['cache_ttl' => null, 'sitemap_cache_ttl' => null]);
|
||||
|
||||
$this->migration->run($this->context());
|
||||
$result = $this->readSeoJson();
|
||||
|
||||
$this->assertNull($result['cache_ttl']);
|
||||
$this->assertNull($result['sitemap_cache_ttl']);
|
||||
}
|
||||
|
||||
/**
|
||||
* 키가 아예 없으면 새로 만들지 않는다
|
||||
*/
|
||||
public function test_does_not_add_absent_keys(): void
|
||||
{
|
||||
$this->writeSeoJson(['meta_title_suffix' => ' | G7']);
|
||||
|
||||
$this->migration->run($this->context());
|
||||
$result = $this->readSeoJson();
|
||||
|
||||
$this->assertArrayNotHasKey('cache_ttl', $result);
|
||||
$this->assertArrayNotHasKey('sitemap_cache_ttl', $result);
|
||||
}
|
||||
|
||||
/**
|
||||
* seo.json 이 없으면 no-op (예외 없음)
|
||||
*/
|
||||
public function test_no_op_when_settings_file_is_absent(): void
|
||||
{
|
||||
$this->migration->run($this->context());
|
||||
|
||||
$this->assertFalse(Storage::disk('settings')->exists('seo.json'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 손상된 JSON 은 덮어쓰지 않고 보존한다 (파괴 금지)
|
||||
*/
|
||||
public function test_preserves_corrupted_json_without_overwriting(): void
|
||||
{
|
||||
Storage::disk('settings')->put('seo.json', '{ this is not json');
|
||||
|
||||
$this->migration->run($this->context());
|
||||
|
||||
$this->assertSame('{ this is not json', Storage::disk('settings')->get('seo.json'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 타입이 다른 동일 값은 오버라이드로 본다 (느슨한 비교 금지)
|
||||
*
|
||||
* 문자열 "7200" 은 기본값 7200(int)과 == 로는 같지만, 운영자가 폼으로 입력한
|
||||
* 흔적이므로 === 비교로 보존해야 한다.
|
||||
*/
|
||||
public function test_treats_type_mismatched_value_as_override(): void
|
||||
{
|
||||
$this->writeSeoJson(['cache_ttl' => '7200']);
|
||||
|
||||
$this->migration->run($this->context());
|
||||
|
||||
$this->assertSame('7200', $this->readSeoJson()['cache_ttl']);
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user