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
@@ -4,6 +4,7 @@ namespace App\Http\Requests\Public\Module;
|
||||
|
||||
use App\Rules\AllowedModuleFileType;
|
||||
use App\Rules\SafeModulePath;
|
||||
use App\Support\Routing\DualExtensionRoute;
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
|
||||
class ServeModuleAssetRequest extends FormRequest
|
||||
@@ -12,6 +13,8 @@ class ServeModuleAssetRequest extends FormRequest
|
||||
* 사용자가 이 요청을 수행할 권한이 있는지 확인
|
||||
*
|
||||
* 권한 체크는 라우트의 permission 미들웨어에서 수행됩니다.
|
||||
*
|
||||
* @return bool 항상 true (권한은 미들웨어 책임)
|
||||
*/
|
||||
public function authorize(): bool
|
||||
{
|
||||
@@ -21,8 +24,11 @@ class ServeModuleAssetRequest extends FormRequest
|
||||
/**
|
||||
* 요청에 적용할 검증 규칙
|
||||
*
|
||||
* @return array<string, mixed>
|
||||
* @return array<string, mixed> 검증 규칙 배열
|
||||
*/
|
||||
// audit:allow core-formrequest-hook-filter reason: 자산 서빙 경로 검증은 파일시스템
|
||||
// 화이트리스트(SafeModulePath + AllowedModuleFileType)가 유일한 방어선이다.
|
||||
// 확장이 필터로 규칙을 대체할 수 있으면 경로 탈출·임의 파일 읽기가 열린다.
|
||||
public function rules(): array
|
||||
{
|
||||
// 모듈 식별자로부터 기준 경로 구성 (모듈 루트)
|
||||
@@ -35,7 +41,7 @@ class ServeModuleAssetRequest extends FormRequest
|
||||
'required',
|
||||
'string',
|
||||
new SafeModulePath($basePath),
|
||||
new AllowedModuleFileType(),
|
||||
new AllowedModuleFileType,
|
||||
],
|
||||
];
|
||||
}
|
||||
@@ -45,10 +51,11 @@ class ServeModuleAssetRequest extends FormRequest
|
||||
*/
|
||||
protected function prepareForValidation(): void
|
||||
{
|
||||
// 라우트 파라미터를 검증 데이터에 병합
|
||||
// 라우트 파라미터를 검증 데이터에 병합.
|
||||
// 확장자 없는 모드에서는 파일 경로가 `?file=` 쿼리로 온다 (경로 확장자 회피).
|
||||
$this->merge([
|
||||
'identifier' => $this->route('identifier'),
|
||||
'path' => $this->route('path'),
|
||||
'path' => $this->route('path') ?? $this->query(DualExtensionRoute::FILE_QUERY_PARAM),
|
||||
]);
|
||||
}
|
||||
|
||||
|
||||
@@ -4,6 +4,7 @@ namespace App\Http\Requests\Public\Plugin;
|
||||
|
||||
use App\Rules\AllowedPluginFileType;
|
||||
use App\Rules\SafePluginPath;
|
||||
use App\Support\Routing\DualExtensionRoute;
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
|
||||
class ServePluginAssetRequest extends FormRequest
|
||||
@@ -12,6 +13,8 @@ class ServePluginAssetRequest extends FormRequest
|
||||
* 사용자가 이 요청을 수행할 권한이 있는지 확인
|
||||
*
|
||||
* 권한 체크는 라우트의 permission 미들웨어에서 수행됩니다.
|
||||
*
|
||||
* @return bool 항상 true (권한은 미들웨어 책임)
|
||||
*/
|
||||
public function authorize(): bool
|
||||
{
|
||||
@@ -21,8 +24,11 @@ class ServePluginAssetRequest extends FormRequest
|
||||
/**
|
||||
* 요청에 적용할 검증 규칙
|
||||
*
|
||||
* @return array<string, mixed>
|
||||
* @return array<string, mixed> 검증 규칙 배열
|
||||
*/
|
||||
// audit:allow core-formrequest-hook-filter reason: 자산 서빙 경로 검증은 파일시스템
|
||||
// 화이트리스트(SafePluginPath + AllowedPluginFileType)가 유일한 방어선이다.
|
||||
// 확장이 필터로 규칙을 대체할 수 있으면 경로 탈출·임의 파일 읽기가 열린다.
|
||||
public function rules(): array
|
||||
{
|
||||
// 플러그인 식별자로부터 기준 경로 구성 (플러그인 루트)
|
||||
@@ -35,7 +41,7 @@ class ServePluginAssetRequest extends FormRequest
|
||||
'required',
|
||||
'string',
|
||||
new SafePluginPath($basePath),
|
||||
new AllowedPluginFileType(),
|
||||
new AllowedPluginFileType,
|
||||
],
|
||||
];
|
||||
}
|
||||
@@ -48,7 +54,7 @@ class ServePluginAssetRequest extends FormRequest
|
||||
// 라우트 파라미터를 검증 데이터에 병합
|
||||
$this->merge([
|
||||
'identifier' => $this->route('identifier'),
|
||||
'path' => $this->route('path'),
|
||||
'path' => $this->route('path') ?? $this->query(DualExtensionRoute::FILE_QUERY_PARAM),
|
||||
]);
|
||||
}
|
||||
|
||||
|
||||
@@ -4,6 +4,7 @@ namespace App\Http\Requests\Public\Template;
|
||||
|
||||
use App\Rules\AllowedTemplateFileType;
|
||||
use App\Rules\SafeTemplatePath;
|
||||
use App\Support\Routing\DualExtensionRoute;
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
|
||||
class ServeTemplateAssetRequest extends FormRequest
|
||||
@@ -12,6 +13,8 @@ class ServeTemplateAssetRequest extends FormRequest
|
||||
* 사용자가 이 요청을 수행할 권한이 있는지 확인
|
||||
*
|
||||
* 권한 체크는 라우트의 permission 미들웨어에서 수행됩니다.
|
||||
*
|
||||
* @return bool 항상 true (권한은 미들웨어 책임)
|
||||
*/
|
||||
public function authorize(): bool
|
||||
{
|
||||
@@ -20,7 +23,13 @@ class ServeTemplateAssetRequest extends FormRequest
|
||||
|
||||
/**
|
||||
* 요청에 적용할 검증 규칙
|
||||
*
|
||||
* @return array<string, mixed> 검증 규칙 배열
|
||||
*/
|
||||
// audit:allow core-formrequest-hook-filter reason: 자산 서빙 경로 검증은 파일시스템
|
||||
// 화이트리스트(SafeTemplatePath + AllowedTemplateFileType)가 유일한 방어선이다.
|
||||
// 확장이 필터로 규칙을 대체할 수 있으면 경로 탈출·임의 파일 읽기가 열린다.
|
||||
// 확장 가능한 "동적 필드" 가 없는 요청이라 룰의 취지(필드 확장)도 해당하지 않는다.
|
||||
public function rules(): array
|
||||
{
|
||||
// 템플릿 식별자로부터 기준 경로 구성
|
||||
@@ -33,7 +42,7 @@ class ServeTemplateAssetRequest extends FormRequest
|
||||
'required',
|
||||
'string',
|
||||
new SafeTemplatePath($basePath),
|
||||
new AllowedTemplateFileType(),
|
||||
new AllowedTemplateFileType,
|
||||
],
|
||||
];
|
||||
}
|
||||
@@ -43,10 +52,13 @@ class ServeTemplateAssetRequest extends FormRequest
|
||||
*/
|
||||
protected function prepareForValidation(): void
|
||||
{
|
||||
// 라우트 파라미터를 검증 데이터에 병합
|
||||
// 라우트 파라미터를 검증 데이터에 병합.
|
||||
// 확장자 없는 모드에서는 파일 경로가 경로 세그먼트가 아니라 `?file=` 쿼리로 온다
|
||||
// (nginx 정적 최적화 블록이 URL 경로의 확장자만 보고 가로채는 것을 회피).
|
||||
// 어느 형태로 오든 컨트롤러는 동일하게 `path` 만 본다.
|
||||
$this->merge([
|
||||
'identifier' => $this->route('identifier'),
|
||||
'path' => $this->route('path'),
|
||||
'path' => $this->route('path') ?? $this->query(DualExtensionRoute::FILE_QUERY_PARAM),
|
||||
]);
|
||||
}
|
||||
|
||||
@@ -64,4 +76,4 @@ class ServeTemplateAssetRequest extends FormRequest
|
||||
'path.string' => __('validation.asset.path.string'),
|
||||
];
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -5,6 +5,7 @@ namespace App\Http\Requests\Settings;
|
||||
use App\Extension\HookManager;
|
||||
use App\Models\Attachment;
|
||||
use App\Search\Engines\DatabaseFulltextEngine;
|
||||
use App\Support\AssetUrl;
|
||||
use Illuminate\Contracts\Validation\ValidationRule;
|
||||
use Illuminate\Contracts\Validation\Validator;
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
@@ -174,6 +175,13 @@ class SaveSettingsRequest extends FormRequest
|
||||
'general.language' => $this->getTabRules($tab, 'general', [Rule::in(config('app.supported_locales', ['ko', 'en']))]),
|
||||
'general.currency' => ['nullable', 'string', 'max:10'],
|
||||
'general.maintenance_mode' => ['nullable', 'boolean'],
|
||||
// 자산 URL 방식 — 정적 최적화 서버 대응 (이슈 #486).
|
||||
// 임의 문자열이 들어오면 AssetUrl::mode() 가 기본값으로 폴백하지만,
|
||||
// 저장 단계에서 막아 설정 파일에 뜻 모를 값이 남지 않게 한다.
|
||||
'general.asset_url_mode' => ['nullable', 'string', Rule::in([
|
||||
AssetUrl::MODE_EXTENSION,
|
||||
AssetUrl::MODE_EXTENSIONLESS,
|
||||
])],
|
||||
'general.site_logo' => ['nullable', 'array'],
|
||||
'general.site_logo.*' => ['integer', Rule::exists(Attachment::class, 'id')],
|
||||
|
||||
|
||||
Reference in new issue
Block a user