feat(core,ecommerce,ckeditor5,board,admin_basic): 공개 자산 직접 URL(CDN) 서빙 옵트인

StorageInterface::url 의 public 하드코딩을 완화하고 core.storage.filter_url 훅을
신설해, 완전 공개 자산(상품·카테고리·리뷰·에디터 이미지)의 직접 URL 서빙을 옵트인으로
열었다. 미설정 시 기존 스트리밍 100% 보존.

디스크 결정은 확장 개별 설정 > 코어 전역 > 미설정 순이며, 서빙·삭제·이동은 행에 기록된
disk 를 따라 전환 전후 자산이 혼재해도 각자 실제 저장 위치를 향한다. 고아 disk(공급
플러그인 비활성화)는 스트리밍으로 폴백해 500 이 되지 않는다.

공개 이슈 (@lyg-kaban 건의) 대응.
This commit is contained in:
HeuJung committed 2026-08-14 08:05:54 +09:00
1 parent 37fad55333
commit 057e002ad1
125 files changed
+5913 -203

No files matched your search

@@ -2202,6 +2202,8 @@ class ComponentHtmlMapperTest extends TestCase
/**
* url 필드가 비어있을 때 download_url로 fallback합니다.
*
* @effects download_url_falls_back_to_api_path_when_direct_unavailable
*/
public function test_image_gallery_download_url_fallback(): void
{
@@ -2242,6 +2244,9 @@ class ComponentHtmlMapperTest extends TestCase
/**
* url 필드가 존재하면 download_url보다 우선합니다.
* (공개 자산 디스크 설정 시 download_url 이 직접 CDN URL 이어도 동일 경로로 소비)
*
* @effects download_url_falls_back_to_api_path_when_direct_unavailable
*/
public function test_image_gallery_url_takes_priority(): void
{
@@ -2273,6 +2278,97 @@ class ComponentHtmlMapperTest extends TestCase
$this->assertStringNotContainsString('product-image/abc123', $html);
}
/**
* download_url 이 절대 CDN URL 일 때(공개 자산 디스크 설정) iterate 가드가
* url() 이중 접두 없이 그대로 통과시킵니다.
*
* 공개#100 이후 download_url 은 상대 API 경로만이 아니라 절대 CDN URL 일 수
* 있다 — 가드가 http 프리픽스를 오판하면 `http://origin/https://cdn...` 처럼
* 깨진 src 가 봇 화면에 나간다.
*
* @effects seo_guard_passes_absolute_cdn_url_unmodified
*/
public function test_image_gallery_absolute_cdn_download_url_passes_unmodified(): void
{
$components = [
[
'name' => 'ProductImageViewer',
'props' => [
'images' => '{{product.images}}',
],
],
];
$context = [
'product' => [
'images' => [
[
'url' => '',
'download_url' => 'https://cdn.test/assets/sirsoft-ecommerce/images/products/1/a.jpg',
'alt_text_current' => 'CDN 이미지',
],
],
],
];
$html = $this->render($components, $context);
$this->assertStringContainsString(
'src="https://cdn.test/assets/sirsoft-ecommerce/images/products/1/a.jpg"',
$html,
);
// url() 이중 접두 회귀 방어 — 절대 URL 앞에 오리진이 덧붙으면 안 된다
$this->assertStringNotContainsString('/https://cdn.test/', $html);
}
/**
* ProductCard(fields attrs 가드)의 thumbnail_url 이 절대 CDN URL 일 때
* 그대로 통과하고, 상대 경로일 때만 절대화됩니다.
*
* @effects seo_guard_passes_absolute_cdn_url_unmodified
*/
public function test_product_card_thumbnail_absolute_cdn_url_passes_unmodified(): void
{
$components = [
[
'type' => 'composite',
'name' => 'ProductCard',
'props' => ['product' => '{{product}}'],
],
];
$context = [
'product' => [
'id' => 7,
'name' => 'CDN Thumb',
'name_localized' => 'CDN 썸네일 상품',
'thumbnail_url' => 'https://cdn.test/assets/sirsoft-ecommerce/images/products/7/t.jpg',
'selling_price_formatted' => '1,000원',
'list_price_formatted' => '1,000원',
'discount_rate' => 0,
'primary_category' => '',
'brand_name' => '',
'sales_status' => '',
'sales_status_label' => '',
'labels' => [],
],
];
$html = $this->render($components, $context);
$this->assertStringContainsString(
'src="https://cdn.test/assets/sirsoft-ecommerce/images/products/7/t.jpg"',
$html,
);
$this->assertStringNotContainsString('/https://cdn.test/', $html);
// 대조군 — 상대 경로는 여전히 절대화된다 (가드의 양방향 동작 고정)
$context['product']['thumbnail_url'] = '/storage/products/rel.jpg';
$relativeHtml = $this->render($components, $context);
$this->assertStringContainsString('src="'.url('/storage/products/rel.jpg').'"', $relativeHtml);
}
/**
* alt_text_current 필드로 alt 속성이 렌더링됩니다.
*/