HeuJung
b4ed33aa44
https://github.com/gnuboard/g7/issues/122 제보자의 추가 지적 2건(빌드가 게시본을 지움 / CLI 최초 게시 후 웹 재생성 불가)에 대응하고, 같은 근본 원인을 공유하는 결함을 전수조사로 함께 고친다. - 빌드가 자기 산출물만 교체한다: 루트 vite `emptyOutDir: false` 기본값 true 는 폴백 없는 코어 3번들과 배달된 immutable URL 의 게시본을 함께 지웠다 - 게시 트리 권한을 웹이 이어받는다: 병합 전 프리플라이트 + 부모 그룹 상속·g+w 종전 소유권 정상화는 root 축만 덮어 비-root CLI 계정은 무방비였다 - 갱신 → 생성 → 완전성 확인을 한 묶음으로: 기록 바이트 대조, .old 원자 스왑, rename 일시 거부 재시도, 프론트 JSON 파싱 검증 - 실패를 억제하고 기록한다: 버전 한정 실패 마커 + 사유별 대시보드 알림 + ext-static:status 점검 커맨드 - 파생: catch-all 제외 목록을 에셋 화이트리스트 합집합에서 파생(mjs·webp·otf 누락), 번들 디스크 쓰기 fail-soft·빈 번들 503, 활성 디렉토리 prune 회피
65 lines
3.2 KiB
PHP
65 lines
3.2 KiB
PHP
<?php
|
|
|
|
namespace App\Support;
|
|
|
|
use App\Rules\AllowedModuleFileType;
|
|
use App\Rules\AllowedPluginFileType;
|
|
use App\Rules\AllowedTemplateFileType;
|
|
|
|
/**
|
|
* SPA catch-all 라우트의 정적 확장자 제외 패턴 (#122).
|
|
*
|
|
* catch-all 은 등록되지 않은 경로에 SPA 셸 HTML 을 돌려준다. 그런데 **정적 자산 요청**이
|
|
* 거기 걸리면 존재하지 않는 `.mjs` 가 `Content-Type: text/html` 인 200 을 받고, 브라우저는
|
|
* 그것을 스크립트로 파싱하다 죽는다. `onerror` 는 발화하지 않으므로(응답은 성공이다)
|
|
* 태그 복구기도 뜨지 않는다 — 예외도 404 도 없이 화면만 조용히 비는 결함이다.
|
|
*
|
|
* 제외 목록을 라우트 파일에 손으로 적어 두면 에셋 서빙이 허용하는 확장자와 갈라진다.
|
|
* 실제로 갈라져 있었다 — `mjs` · `webp` · `otf` 세 가지가 서빙은 되는데 제외 목록에는
|
|
* 없었다. `.json` 이 무사했던 것은 lookahead 에 끝 앵커가 없어 `.js` 에 **부분일치**한
|
|
* 우연이었을 뿐이다. 그래서 목록을 손으로 두지 않고 에셋 서빙 화이트리스트에서 **파생**시켜
|
|
* 우연을 제거한다.
|
|
*
|
|
* 모집단은 세 화이트리스트의 **합집합**이다. 게시 트리(`public/build/ext/{v}/`)에는
|
|
* 템플릿 dist 뿐 아니라 모듈·플러그인의 사용자 추가 에셋도 함께 실리므로, 한 종류만
|
|
* 기준으로 삼으면 나머지가 서빙하는 확장자가 다시 빠진다(`ico` 가 그 경우다 — 모듈·
|
|
* 플러그인은 허용하고 템플릿은 허용하지 않는다).
|
|
*
|
|
* 라우트 캐시 안전: `where()` 인자는 **정의 시점**에 평가되어 컴파일된 정규식으로 캐시에
|
|
* 박히므로, 캐시 로드 경로는 이 클래스를 참조하지 않는다. 라우트 파일에 전역 함수를
|
|
* 선언하지도 않는다 (CLAUDE.md "라우트 캐시 안전성").
|
|
*
|
|
* 환경 의존 게터(`getAllowedExtensions()`)를 쓰지 않는 이유도 같다 — 그것은 로컬에서
|
|
* 소스맵(`map`)을 덧붙이므로, 패턴이 **캐시를 구운 환경**에 따라 달라진다.
|
|
*/
|
|
final class StaticExtensionPattern
|
|
{
|
|
/**
|
|
* SPA catch-all `where()` 에 넣을 제외 lookahead 를 반환합니다.
|
|
*
|
|
* 끝 앵커(`$`)를 붙이지 않는다 — 쿼리스트링이 아닌 경로 뒤 세그먼트가 붙은 형태
|
|
* (`/a.js/b`)까지 함께 제외하는 종전 동작을 유지하기 위함이며, 앵커를 붙이면
|
|
* 정적 미스가 SPA 풀 렌더를 경유해 조용히 비싸진다.
|
|
*
|
|
* @return string `(?!.*\.(js|css|…)).*` 형태의 라우트 패턴 조각
|
|
*/
|
|
public static function catchAllExclusion(): string
|
|
{
|
|
return '(?!.*\.('.implode('|', self::servedExtensions()).')).*';
|
|
}
|
|
|
|
/**
|
|
* 정적으로 서빙될 수 있는 확장자 전체(세 화이트리스트 합집합)를 반환합니다.
|
|
*
|
|
* @return array<int, string> 중복 없는 확장자 목록
|
|
*/
|
|
public static function servedExtensions(): array
|
|
{
|
|
return array_values(array_unique([
|
|
...AllowedTemplateFileType::allowedExtensions(),
|
|
...AllowedModuleFileType::allowedExtensions(),
|
|
...AllowedPluginFileType::allowedExtensions(),
|
|
]));
|
|
}
|
|
}
|