feat(core): 정적 최적화 서버 대응 자산 URL 이중 모드
nginx 의 정규식 location 은 프리픽스 location 보다 먼저 매칭되므로, `location ~* \.(js|css|json)$` 블록이 있는 서버에서는 확장자 붙은 동적 엔드포인트가 `try_files ... /index.php` 폴백이 실행될 기회 없이 404 가 된다. aaPanel/CyberPanel/Plesk 기본 템플릿에 들어있어 드물지 않으며, 관리자 화면조차 뜨지 않아 "서버 설정을 고치세요" 안내가 순환 참조가 된다. 관례를 깬 쪽이 G7 이므로 해소 책임도 G7 에 두고, 두 형태를 모두 서빙한 뒤 환경에 따라 택일한다. 확장자 형태는 영구 유지한다 — 제거하면 URL 을 하드코딩한 서드파티 확장이 깨진다. - 라우트: dualSuffix / dualSuffixSegment / dualAsset 매크로로 23개 엔드포인트와 프로브를 이중 등록. 확장자 형태를 먼저 등록한다 — 확장자 없는 쪽이 더 느슨한 패턴이라 순서가 뒤집히면 `.json` 요청까지 삼킨다 - URL 생성: 서버 App\Support\AssetUrl, 프론트 core/support/assetUrl.ts 로 집약. 기본 모드에서 생성 결과는 치환 이전과 문자열까지 동일하다 (쿼리 순서 포함 — 순서가 바뀌면 의미는 같아도 HTTP 캐시 키가 갈린다) - 자가 복구: 부트스트랩 자산 로드 실패 시 확장자 없는 형태로 1회 단방향 전환. 역방향 금지 + 기존 재시도 예산 공유로 무한 왕복을 막는다 - 감지·전환: 인스톨러 프로브(설치 시 확정) / 관리자 환경설정 일반 탭 / g7:asset-url-mode. 판정은 상태코드가 아니라 매직 토큰 + Content-Type 으로 한다. 상태코드만 보면 "404 대신 200 + 에러 HTML" 환경에서 영원히 오판한다 - 봇은 JavaScript 를 실행하지 않아 자가 복구가 닿지 않으므로, 모드 변경 시 SEO 프리렌더 캐시를 비워 재생성시킨다 가드: audit 룰 2종(dynamic-route-static-extension / asset-url-builder-required), Playwright 6건(정적 블록 가로채기 시뮬레이션), 루프 방지 불변식 L1~L9 전수 red 증명. 부수 정리: 양 Composer 에 중복돼 있던 확장 에셋 수집 123줄을 트레이트로 통합하고, 자산 확장자 화이트리스트 누락(.map)과 경로 정규화 우회 가능성을 함께 교정. sir.kr 커뮤니티의 hang 님께서 제보해주셨습니다.
This commit is contained in:
1 parent
74df8a4b09
commit
15cd4452bf
90 files changed
+4279
-546
No files matched your search
@@ -16,9 +16,16 @@
|
||||
@include('partials.error-fallback-styles')
|
||||
@endif
|
||||
|
||||
{{-- 자산 URL 자가 복구 헬퍼 — CSS <link> 의 onerror 보다 먼저 정의되어야 한다 --}}
|
||||
@include('partials.asset-url-recovery')
|
||||
|
||||
<!-- 템플릿 컴포넌트 스타일 -->
|
||||
@if(!empty($activeAdminTemplate))
|
||||
<link rel="stylesheet" href="/api/templates/assets/{{ $activeAdminTemplate }}/css/components.css?v={{ $extensionCacheVersion }}">
|
||||
{{-- onerror: 정적 최적화 서버에서 확장자 붙은 CSS 가 가로채였을 때
|
||||
확장자 없는 형태로 1회 교체한다(무스타일 화면 방지). 링크당 1회. --}}
|
||||
<link rel="stylesheet"
|
||||
href="{{ \App\Support\AssetUrl::templateAsset($activeAdminTemplate, 'css/components.css', $extensionCacheVersion) }}"
|
||||
onerror="window.__g7AssetUrl && window.__g7AssetUrl.recoverStylesheet(this);">
|
||||
@endif
|
||||
</head>
|
||||
<body>
|
||||
@@ -54,7 +61,14 @@
|
||||
// 키가 새 버전으로 전환되어 routes.json/lang 변경이 즉시 가시화된다.
|
||||
// 미주입 시 클라이언트가 항상 `v0` 으로 호출 → `template:cache-clear` 가 v 와일드카드를
|
||||
// 처리하지 못해 캐시가 영구 stale 되는 결함이 발생.
|
||||
cache_version: {{ (int) ($extensionCacheVersion ?? 0) }}
|
||||
cache_version: {{ (int) ($extensionCacheVersion ?? 0) }},
|
||||
// 자산 URL 모드 — 'extension'(기본) | 'extensionless'.
|
||||
// 정적 최적화 블록이 동적 응답을 가로채는 서버에서 확장자 없는 형태로 전환.
|
||||
// 부트스트랩 자가 복구가 런타임에 뒤집으므로 최상위 키로 노출한다.
|
||||
// 자가 복구가 <head> 에서 이미 전환을 확정했다면 그 값을 잇는다.
|
||||
// 이 대입은 G7Config 객체를 통째로 교체하므로, 독립 전역을 읽지 않으면
|
||||
// 복원/전환 결과가 여기서 덮여 사라진다.
|
||||
assetUrlMode: window.__g7AssetUrlMode || '{{ \App\Support\AssetUrl::mode() }}'
|
||||
};
|
||||
@if(isset($errorCode) && isset($errorLayout))
|
||||
// 에러 상태 정보 (503 의존성 미충족 등)
|
||||
@@ -71,8 +85,11 @@
|
||||
{{-- 코어 엔진 + 템플릿 컴포넌트 번들 로드 → 초기화 (재시도 + 폴백 UI) --}}
|
||||
@include('partials.bootstrap-scripts', [
|
||||
'templateType' => 'admin',
|
||||
'coreEngineSrc' => asset('build/core/template-engine.min.js') . '?v=' . filemtime(public_path('build/core/template-engine.min.js')),
|
||||
'componentsSrc' => '/api/templates/assets/' . $activeAdminTemplate . '/js/components.iife.js?v=' . $extensionCacheVersion,
|
||||
{{-- 코어 엔진 번들은 public/ 의 실물 정적 파일이라 자산 URL 이중 모드 대상이 아니다.
|
||||
미빌드 상태에서 filemtime() 이 warning 을 내지 않도록 file_exists 가드
|
||||
(coreEditorAsset/coreDevToolsAsset 와 동일 패턴). --}}
|
||||
'coreEngineSrc' => asset('build/core/template-engine.min.js') . '?v=' . (file_exists(public_path('build/core/template-engine.min.js')) ? filemtime(public_path('build/core/template-engine.min.js')) : 0),
|
||||
'componentsSrc' => \App\Support\AssetUrl::templateAsset($activeAdminTemplate, 'js/components.iife.js', $extensionCacheVersion),
|
||||
'initConfig' => array_filter([
|
||||
'templateId' => $activeAdminTemplate,
|
||||
'templateType' => 'admin',
|
||||
|
||||
Reference in new issue
Block a user