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
@@ -8,6 +8,7 @@ use App\Extension\Helpers\EditorSpecAssembler;
|
||||
use App\Http\Controllers\Api\Base\AdminBaseController;
|
||||
use App\Services\PermissionService;
|
||||
use App\Services\TemplateService;
|
||||
use App\Support\AssetUrl;
|
||||
use Illuminate\Http\JsonResponse;
|
||||
use Symfony\Component\HttpFoundation\Response;
|
||||
|
||||
@@ -88,17 +89,19 @@ class AdminTemplateAssetController extends AdminBaseController
|
||||
}
|
||||
|
||||
$extensionCacheVersion = (int) app(CacheInterface::class)->get('ext.cache_version', 0);
|
||||
$version = $extensionCacheVersion > 0 ? "?v={$extensionCacheVersion}" : '';
|
||||
$version = $extensionCacheVersion > 0 ? $extensionCacheVersion : null;
|
||||
|
||||
return $this->success(
|
||||
__('templates.messages.editor_assets_retrieved'),
|
||||
[
|
||||
'identifier' => $identifier,
|
||||
'js' => ["/api/templates/assets/{$identifier}/js/components.iife.js{$version}"],
|
||||
'js' => [AssetUrl::templateAsset($identifier, 'js/components.iife.js', $version)],
|
||||
// CSS 는 편집기 전용 엔드포인트로 — 다크 셀렉터를 프리뷰 마커로 치환해 서빙
|
||||
// 일반 자산 서빙은 원본.
|
||||
// URI 가 `components` 가 아니라 `component-styles` 인 이유: 확장자를 떼면
|
||||
// `editor/components.json` 의 확장자 없는 형태와 충돌한다.
|
||||
'css' => $cssAvailable
|
||||
? ["/api/admin/templates/{$identifier}/editor/components.css{$version}"]
|
||||
? [AssetUrl::suffixed("/api/admin/templates/{$identifier}/editor/component-styles", 'css', $version)]
|
||||
: [],
|
||||
'manifest_present' => true,
|
||||
'manifest_source' => $jsSource,
|
||||
|
||||
@@ -0,0 +1,74 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Controllers\Api\Public;
|
||||
|
||||
use App\Http\Controllers\Api\Base\PublicBaseController;
|
||||
use Illuminate\Http\Response;
|
||||
|
||||
/**
|
||||
* 자산 URL 모드 감지 프로브.
|
||||
*
|
||||
* 서버(nginx/Apache)의 정적 최적화 블록이 확장자 붙은 동적 응답을 가로채는지
|
||||
* 판정하기 위한 대조 엔드포인트다. 브라우저가 아래 두 URL 을 쌍으로 요청한다.
|
||||
*
|
||||
* ```text
|
||||
* GET /api/system/asset-probe.js → 확장자 형태 (정적 블록의 표적)
|
||||
* GET /api/system/asset-probe → 대조군
|
||||
* ```
|
||||
*
|
||||
* | probe.js | probe | 판정 |
|
||||
* |---|---|---|
|
||||
* | 성공 | 성공 | `extension` — 확장자 유지 가능 |
|
||||
* | 실패 | 성공 | `extensionless` — 정적 블록 가로채기 확정 |
|
||||
* | 실패 | 실패 | 모드 문제 아님 (PHP/라우팅 장애) — 별도 안내 |
|
||||
*
|
||||
* ## 판정은 상태코드가 아니라 본문이다
|
||||
*
|
||||
* 클라이언트는 `res.ok && body.includes(PROBE_TOKEN)` 로 판정해야 한다.
|
||||
* 상태코드만 보면 "404 대신 200 + 에러 HTML" 이나 catch-all 200 페이지를
|
||||
* 반환하는 설정에서 영원히 `extension` 으로 오판해, 재감지를 몇 번 눌러도
|
||||
* 같은 오답이 나온다.
|
||||
*
|
||||
* ## 감지는 반드시 브라우저에서 수행한다
|
||||
*
|
||||
* 서버측에서 자기 `APP_URL` 로 curl 하면 loopback 이 nginx vhost·SSL·프록시
|
||||
* 체인을 우회하거나 다른 vhost 를 타서 오판한다.
|
||||
*
|
||||
* ## 실물 파일을 두지 않는다
|
||||
*
|
||||
* `public/` 하위에 실제 `asset-probe.js` 파일이 존재하면 nginx 가 그것을
|
||||
* 성공적으로 서빙해 거짓 양성이 된다. 본 라우트는 반드시 실물 파일이 없는
|
||||
* 경로여야 한다.
|
||||
*/
|
||||
class AssetProbeController extends PublicBaseController
|
||||
{
|
||||
/**
|
||||
* 프로브 성공 판정용 매직 토큰.
|
||||
*
|
||||
* 클라이언트·테스트가 응답 본문에서 이 문자열을 찾아 성공을 판정한다.
|
||||
*/
|
||||
public const PROBE_TOKEN = 'G7_ASSET_PROBE_OK';
|
||||
|
||||
/**
|
||||
* 프로브 응답을 반환합니다.
|
||||
*
|
||||
* DB 에 접근하지 않으며(설치 전에도 응답 가능) 캐시되지 않습니다.
|
||||
* ResponseHelper 의 JSON 봉투를 쓰지 않는 이유: 이 엔드포인트의 목적은
|
||||
* "정적 자산으로 오인될 응답"을 실제로 흉내내는 것이므로, 자바스크립트
|
||||
* Content-Type 과 본문 형태를 그대로 유지해야 대표성이 있다.
|
||||
*
|
||||
* @return Response 매직 토큰을 담은 자바스크립트 응답
|
||||
*/
|
||||
public function probe(): Response
|
||||
{
|
||||
$body = "/* G7 asset URL mode probe */\n"
|
||||
."window.__g7AssetProbe = '".self::PROBE_TOKEN."';\n";
|
||||
|
||||
return response($body, 200, [
|
||||
'Content-Type' => 'application/javascript; charset=utf-8',
|
||||
'Cache-Control' => 'no-store, no-cache, must-revalidate, max-age=0',
|
||||
'Pragma' => 'no-cache',
|
||||
'X-Content-Type-Options' => 'nosniff',
|
||||
]);
|
||||
}
|
||||
}
|
||||
@@ -71,14 +71,16 @@ class PublicModuleController extends PublicBaseController
|
||||
*
|
||||
* @param ServeModuleAssetRequest $request 검증된 요청 (경로, 확장자 검증 완료)
|
||||
* @param string $identifier 모듈 식별자 (vendor-module 형식)
|
||||
* @param string $path 에셋 경로 (dist/js/module.iife.js 등)
|
||||
* @return BinaryFileResponse|JsonResponse|Response 파일 응답 또는 에러 응답
|
||||
*/
|
||||
public function serveAsset(
|
||||
ServeModuleAssetRequest $request,
|
||||
string $identifier,
|
||||
string $path
|
||||
string $identifier
|
||||
): BinaryFileResponse|JsonResponse|Response {
|
||||
// 파일 경로는 FormRequest 에서 받는다 — 확장자 모드는 `{path}` 라우트 세그먼트,
|
||||
// 확장자 없는 모드는 `?file=` 쿼리로 오며 prepareForValidation() 이 이를 흡수한다.
|
||||
$path = (string) $request->validated('path');
|
||||
|
||||
// FormRequest에서 이미 보안 검증 완료
|
||||
// API 사용량 기록
|
||||
$this->logApiUsage('modules.assets', ['identifier' => $identifier, 'path' => $path]);
|
||||
|
||||
@@ -70,14 +70,16 @@ class PublicPluginController extends PublicBaseController
|
||||
*
|
||||
* @param ServePluginAssetRequest $request 검증된 요청 (경로, 확장자 검증 완료)
|
||||
* @param string $identifier 플러그인 식별자 (vendor-plugin 형식)
|
||||
* @param string $path 에셋 경로 (dist/js/plugin.iife.js 등)
|
||||
* @return BinaryFileResponse|JsonResponse|Response 파일 응답 또는 에러 응답
|
||||
*/
|
||||
public function serveAsset(
|
||||
ServePluginAssetRequest $request,
|
||||
string $identifier,
|
||||
string $path
|
||||
string $identifier
|
||||
): BinaryFileResponse|JsonResponse|Response {
|
||||
// 파일 경로는 FormRequest 에서 받는다 — 확장자 모드는 `{path}` 라우트 세그먼트,
|
||||
// 확장자 없는 모드는 `?file=` 쿼리로 오며 prepareForValidation() 이 이를 흡수한다.
|
||||
$path = (string) $request->validated('path');
|
||||
|
||||
// FormRequest에서 이미 보안 검증 완료
|
||||
// API 사용량 기록
|
||||
$this->logApiUsage('plugins.assets', ['identifier' => $identifier, 'path' => $path]);
|
||||
|
||||
@@ -88,13 +88,16 @@ class PublicTemplateController extends PublicBaseController
|
||||
/**
|
||||
* 템플릿 정적 파일 서빙
|
||||
*
|
||||
* @param ServeTemplateAssetRequest $request 요청 (FormRequest 검증)
|
||||
* @param ServeTemplateAssetRequest $request 요청 (FormRequest 검증, 파일 경로 `path` 포함)
|
||||
* @param string $identifier 템플릿 식별자
|
||||
* @param string $path 요청 경로
|
||||
* @return BinaryFileResponse|JsonResponse|Response 파일 응답 또는 에러
|
||||
*/
|
||||
public function serveAsset(ServeTemplateAssetRequest $request, string $identifier, string $path): BinaryFileResponse|JsonResponse|Response
|
||||
public function serveAsset(ServeTemplateAssetRequest $request, string $identifier): BinaryFileResponse|JsonResponse|Response
|
||||
{
|
||||
// 파일 경로는 FormRequest 에서 받는다 — 확장자 모드는 `{path}` 라우트 세그먼트,
|
||||
// 확장자 없는 모드는 `?file=` 쿼리로 오며 prepareForValidation() 이 이를 흡수한다.
|
||||
$path = (string) $request->validated('path');
|
||||
|
||||
// FormRequest에서 이미 보안 검증 완료
|
||||
// API 사용량 기록
|
||||
$this->logApiUsage('templates.assets', ['identifier' => $identifier, 'path' => $path]);
|
||||
|
||||
@@ -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')],
|
||||
|
||||
|
||||
@@ -8,17 +8,18 @@ use App\Extension\PluginManager;
|
||||
use App\Extension\TemplateManager;
|
||||
use App\Extension\Traits\ClearsTemplateCaches;
|
||||
use App\Http\View\Composers\Traits\CollectsActiveExtensionMeta;
|
||||
use App\Http\View\Composers\Traits\CollectsExtensionAssets;
|
||||
use App\Http\View\Composers\Traits\CollectsTemplateExternals;
|
||||
use App\Services\ModuleSettingsService;
|
||||
use App\Services\PluginSettingsService;
|
||||
use App\Services\SettingsService;
|
||||
use App\Services\TemplateService;
|
||||
use Illuminate\Support\Facades\Log;
|
||||
use Illuminate\View\View;
|
||||
|
||||
class TemplateComposer
|
||||
{
|
||||
use CollectsActiveExtensionMeta;
|
||||
use CollectsExtensionAssets;
|
||||
use CollectsTemplateExternals;
|
||||
|
||||
/**
|
||||
@@ -115,156 +116,4 @@ class TemplateComposer
|
||||
$view->with('appConfig', $appConfig);
|
||||
$view->with('templateExternals', $templateExternals);
|
||||
}
|
||||
|
||||
/**
|
||||
* 확장 프론트엔드 병합 번들 URL을 계산합니다.
|
||||
*
|
||||
* 활성 global 에셋(JS/CSS)이 하나라도 있는 타입만 해당 번들 URL을 채우고,
|
||||
* 없으면 null을 두어 프론트가 로드를 스킵하게 한다. URL은 same-origin
|
||||
* (`/api/...`)이어야 gdpr preblocker 의 same-origin 통과 규칙에 자기 차단되지
|
||||
* 않는다(CDN 호스팅 금지).
|
||||
*
|
||||
* @param array $moduleAssets 수집된 모듈 개별 에셋 맵
|
||||
* @param array $pluginAssets 수집된 플러그인 개별 에셋 맵
|
||||
* @param int $version 확장 캐시 버전
|
||||
* @return array{moduleJs: ?string, moduleCss: ?string, pluginJs: ?string, pluginCss: ?string}
|
||||
*/
|
||||
private function buildExtensionBundleUrls(array $moduleAssets, array $pluginAssets, int $version): array
|
||||
{
|
||||
$hasJs = static fn (array $assets): bool => ! empty(array_filter($assets, fn ($a) => ! empty($a['js'])));
|
||||
$hasCss = static fn (array $assets): bool => ! empty(array_filter($assets, fn ($a) => ! empty($a['css'])));
|
||||
|
||||
return [
|
||||
'moduleJs' => $hasJs($moduleAssets) ? "/api/modules/bundle.js?v={$version}" : null,
|
||||
'moduleCss' => $hasCss($moduleAssets) ? "/api/modules/bundle.css?v={$version}" : null,
|
||||
'pluginJs' => $hasJs($pluginAssets) ? "/api/plugins/bundle.js?v={$version}" : null,
|
||||
'pluginCss' => $hasCss($pluginAssets) ? "/api/plugins/bundle.css?v={$version}" : null,
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* 활성화된 모듈의 프론트엔드 에셋 정보를 수집합니다.
|
||||
*
|
||||
* @return array<string, array{js?: string, css?: string, priority: int, external?: array}>
|
||||
*/
|
||||
private function collectModuleAssets(): array
|
||||
{
|
||||
$assets = [];
|
||||
|
||||
try {
|
||||
// ModuleManager에서 활성화된 모듈 목록 조회
|
||||
$activeModules = $this->moduleManager->getActiveModules();
|
||||
|
||||
// 캐시 버전 조회 (브라우저 캐시 무효화용)
|
||||
$cacheVersion = ClearsTemplateCaches::getExtensionCacheVersion();
|
||||
|
||||
foreach ($activeModules as $identifier => $module) {
|
||||
// 모듈에 에셋이 있는지 확인
|
||||
if (! $module->hasAssets()) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$builtPaths = $module->getBuiltAssetPaths();
|
||||
$loadingConfig = $module->getAssetLoadingConfig();
|
||||
$assetConfig = $module->getAssets();
|
||||
|
||||
// global 전략인 경우에만 수집 (layout, lazy는 레이아웃에서 처리)
|
||||
if ($loadingConfig['strategy'] !== 'global') {
|
||||
continue;
|
||||
}
|
||||
|
||||
$moduleAsset = [
|
||||
'priority' => $loadingConfig['priority'],
|
||||
];
|
||||
|
||||
// JS 빌드 경로 (캐시 버전 파라미터 추가)
|
||||
if (! empty($builtPaths['js'])) {
|
||||
$moduleAsset['js'] = "/api/modules/assets/{$identifier}/".$builtPaths['js']."?v={$cacheVersion}";
|
||||
}
|
||||
|
||||
// CSS 빌드 경로 (캐시 버전 파라미터 추가)
|
||||
if (! empty($builtPaths['css'])) {
|
||||
$moduleAsset['css'] = "/api/modules/assets/{$identifier}/".$builtPaths['css']."?v={$cacheVersion}";
|
||||
}
|
||||
|
||||
// 외부 스크립트 (조건부 로드용)
|
||||
if (! empty($assetConfig['external'])) {
|
||||
$moduleAsset['external'] = $assetConfig['external'];
|
||||
}
|
||||
|
||||
$assets[$identifier] = $moduleAsset;
|
||||
}
|
||||
|
||||
// 우선순위 기준 정렬 (낮을수록 먼저)
|
||||
uasort($assets, fn ($a, $b) => $a['priority'] <=> $b['priority']);
|
||||
} catch (\Exception $e) {
|
||||
// 에러 발생 시 빈 배열 반환 (에셋 로드 실패해도 앱 진행)
|
||||
Log::warning('Failed to collect module assets: '.$e->getMessage());
|
||||
}
|
||||
|
||||
return $assets;
|
||||
}
|
||||
|
||||
/**
|
||||
* 활성화된 플러그인의 프론트엔드 에셋 정보를 수집합니다.
|
||||
*
|
||||
* @return array<string, array{js?: string, css?: string, priority: int, external?: array}>
|
||||
*/
|
||||
private function collectPluginAssets(): array
|
||||
{
|
||||
$assets = [];
|
||||
|
||||
try {
|
||||
// PluginManager에서 활성화된 플러그인 목록 조회
|
||||
$activePlugins = $this->pluginManager->getActivePlugins();
|
||||
|
||||
// 캐시 버전 조회 (브라우저 캐시 무효화용)
|
||||
$cacheVersion = ClearsTemplateCaches::getExtensionCacheVersion();
|
||||
|
||||
foreach ($activePlugins as $identifier => $plugin) {
|
||||
// 플러그인에 에셋이 있는지 확인
|
||||
if (! $plugin->hasAssets()) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$builtPaths = $plugin->getBuiltAssetPaths();
|
||||
$loadingConfig = $plugin->getAssetLoadingConfig();
|
||||
$assetConfig = $plugin->getAssets();
|
||||
|
||||
// global 전략인 경우에만 수집 (layout, lazy는 레이아웃에서 처리)
|
||||
if ($loadingConfig['strategy'] !== 'global') {
|
||||
continue;
|
||||
}
|
||||
|
||||
$pluginAsset = [
|
||||
'priority' => $loadingConfig['priority'],
|
||||
];
|
||||
|
||||
// JS 빌드 경로 (캐시 버전 파라미터 추가)
|
||||
if (! empty($builtPaths['js'])) {
|
||||
$pluginAsset['js'] = "/api/plugins/assets/{$identifier}/".$builtPaths['js']."?v={$cacheVersion}";
|
||||
}
|
||||
|
||||
// CSS 빌드 경로 (캐시 버전 파라미터 추가)
|
||||
if (! empty($builtPaths['css'])) {
|
||||
$pluginAsset['css'] = "/api/plugins/assets/{$identifier}/".$builtPaths['css']."?v={$cacheVersion}";
|
||||
}
|
||||
|
||||
// 외부 스크립트 (조건부 로드용)
|
||||
if (! empty($assetConfig['external'])) {
|
||||
$pluginAsset['external'] = $assetConfig['external'];
|
||||
}
|
||||
|
||||
$assets[$identifier] = $pluginAsset;
|
||||
}
|
||||
|
||||
// 우선순위 기준 정렬 (낮을수록 먼저)
|
||||
uasort($assets, fn ($a, $b) => $a['priority'] <=> $b['priority']);
|
||||
} catch (\Exception $e) {
|
||||
// 에러 발생 시 빈 배열 반환 (에셋 로드 실패해도 앱 진행)
|
||||
Log::warning('Failed to collect plugin assets: '.$e->getMessage());
|
||||
}
|
||||
|
||||
return $assets;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,143 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\View\Composers\Traits;
|
||||
|
||||
use App\Extension\Traits\ClearsTemplateCaches;
|
||||
use App\Support\AssetUrl;
|
||||
use Illuminate\Support\Facades\Log;
|
||||
|
||||
/**
|
||||
* 활성 확장(모듈·플러그인)의 프론트엔드 에셋 수집 및 번들 URL 생성.
|
||||
*
|
||||
* `TemplateComposer`(admin)와 `UserTemplateComposer`(user)가 공유한다. 두 클래스는
|
||||
* 이 세 메서드를 주석까지 통째로 중복 보유하고 있었고(123줄), 그래서 한쪽만 고치면
|
||||
* 다른 쪽이 조용히 어긋나는 구조였다. 트레이트로 승격해 그 가능성을 제거한다.
|
||||
*
|
||||
* URL 생성은 전부 `AssetUrl` 을 경유한다 — 자산 URL 이중 모드(확장자 유지/제거)를
|
||||
* 한 곳에서 결정하기 위함이다.
|
||||
*
|
||||
* 사용하는 클래스는 `$moduleManager` / `$pluginManager` 프로퍼티를 가져야 한다.
|
||||
*
|
||||
* @see AssetUrl
|
||||
*/
|
||||
trait CollectsExtensionAssets
|
||||
{
|
||||
/**
|
||||
* 확장 병합 번들 URL 을 생성합니다.
|
||||
*
|
||||
* 병합 번들은 same-origin(`/api/...`)이어야 한다. 외부 origin/CDN 은 GDPR
|
||||
* 프리블로커에 자기 차단되므로 호스팅하지 않는다.
|
||||
*
|
||||
* @param array<string, mixed> $moduleAssets 수집된 모듈 개별 에셋 맵
|
||||
* @param array<string, mixed> $pluginAssets 수집된 플러그인 개별 에셋 맵
|
||||
* @param int $version 확장 캐시 버전
|
||||
* @return array{moduleJs: ?string, moduleCss: ?string, pluginJs: ?string, pluginCss: ?string} 번들 URL 맵
|
||||
*/
|
||||
private function buildExtensionBundleUrls(array $moduleAssets, array $pluginAssets, int $version): array
|
||||
{
|
||||
$hasJs = static fn (array $assets): bool => ! empty(array_filter($assets, fn ($a) => ! empty($a['js'])));
|
||||
$hasCss = static fn (array $assets): bool => ! empty(array_filter($assets, fn ($a) => ! empty($a['css'])));
|
||||
|
||||
return [
|
||||
'moduleJs' => $hasJs($moduleAssets) ? AssetUrl::extensionBundle('modules', 'js', $version) : null,
|
||||
'moduleCss' => $hasCss($moduleAssets) ? AssetUrl::extensionBundle('modules', 'css', $version) : null,
|
||||
'pluginJs' => $hasJs($pluginAssets) ? AssetUrl::extensionBundle('plugins', 'js', $version) : null,
|
||||
'pluginCss' => $hasCss($pluginAssets) ? AssetUrl::extensionBundle('plugins', 'css', $version) : null,
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* 활성화된 모듈의 프론트엔드 에셋 정보를 수집합니다.
|
||||
*
|
||||
* @return array<string, array{js?: string, css?: string, priority: int, external?: array}> 식별자별 에셋 맵
|
||||
*/
|
||||
private function collectModuleAssets(): array
|
||||
{
|
||||
return $this->collectExtensionAssets(
|
||||
'modules',
|
||||
fn () => $this->moduleManager->getActiveModules(),
|
||||
'Failed to collect module assets: '
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* 활성화된 플러그인의 프론트엔드 에셋 정보를 수집합니다.
|
||||
*
|
||||
* @return array<string, array{js?: string, css?: string, priority: int, external?: array}> 식별자별 에셋 맵
|
||||
*/
|
||||
private function collectPluginAssets(): array
|
||||
{
|
||||
return $this->collectExtensionAssets(
|
||||
'plugins',
|
||||
fn () => $this->pluginManager->getActivePlugins(),
|
||||
'Failed to collect plugin assets: '
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* 확장 에셋 수집 공통 구현.
|
||||
*
|
||||
* 모듈/플러그인은 수집 대상 조회 방법과 로그 문구만 다르고 나머지 로직이 동일하다.
|
||||
*
|
||||
* @param string $type `modules` 또는 `plugins`
|
||||
* @param callable $activeResolver 활성 확장 목록을 반환하는 콜백
|
||||
* @param string $logPrefix 실패 시 경고 로그 접두사
|
||||
* @return array<string, array{js?: string, css?: string, priority: int, external?: array}> 식별자별 에셋 맵
|
||||
*/
|
||||
private function collectExtensionAssets(string $type, callable $activeResolver, string $logPrefix): array
|
||||
{
|
||||
$assets = [];
|
||||
|
||||
try {
|
||||
$active = $activeResolver();
|
||||
|
||||
// 캐시 버전 조회 (브라우저 캐시 무효화용)
|
||||
$cacheVersion = ClearsTemplateCaches::getExtensionCacheVersion();
|
||||
|
||||
foreach ($active as $identifier => $extension) {
|
||||
// 확장에 에셋이 있는지 확인
|
||||
if (! $extension->hasAssets()) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$builtPaths = $extension->getBuiltAssetPaths();
|
||||
$loadingConfig = $extension->getAssetLoadingConfig();
|
||||
$assetConfig = $extension->getAssets();
|
||||
|
||||
// global 전략인 경우에만 수집 (layout, lazy는 레이아웃에서 처리)
|
||||
if ($loadingConfig['strategy'] !== 'global') {
|
||||
continue;
|
||||
}
|
||||
|
||||
$asset = [
|
||||
'priority' => $loadingConfig['priority'],
|
||||
];
|
||||
|
||||
// JS 빌드 경로 (캐시 버전 파라미터 추가)
|
||||
if (! empty($builtPaths['js'])) {
|
||||
$asset['js'] = AssetUrl::extensionAsset($type, $identifier, $builtPaths['js'], $cacheVersion);
|
||||
}
|
||||
|
||||
// CSS 빌드 경로 (캐시 버전 파라미터 추가)
|
||||
if (! empty($builtPaths['css'])) {
|
||||
$asset['css'] = AssetUrl::extensionAsset($type, $identifier, $builtPaths['css'], $cacheVersion);
|
||||
}
|
||||
|
||||
// 외부 스크립트 (조건부 로드용)
|
||||
if (! empty($assetConfig['external'])) {
|
||||
$asset['external'] = $assetConfig['external'];
|
||||
}
|
||||
|
||||
$assets[$identifier] = $asset;
|
||||
}
|
||||
|
||||
// 우선순위 기준 정렬 (낮을수록 먼저)
|
||||
uasort($assets, fn ($a, $b) => $a['priority'] <=> $b['priority']);
|
||||
} catch (\Exception $e) {
|
||||
// 에러 발생 시 빈 배열 반환 (에셋 로드 실패해도 앱 진행)
|
||||
Log::warning($logPrefix.$e->getMessage());
|
||||
}
|
||||
|
||||
return $assets;
|
||||
}
|
||||
}
|
||||
@@ -8,12 +8,12 @@ use App\Extension\PluginManager;
|
||||
use App\Extension\TemplateManager;
|
||||
use App\Extension\Traits\ClearsTemplateCaches;
|
||||
use App\Http\View\Composers\Traits\CollectsActiveExtensionMeta;
|
||||
use App\Http\View\Composers\Traits\CollectsExtensionAssets;
|
||||
use App\Http\View\Composers\Traits\CollectsTemplateExternals;
|
||||
use App\Services\ModuleSettingsService;
|
||||
use App\Services\PluginSettingsService;
|
||||
use App\Services\SettingsService;
|
||||
use App\Services\TemplateService;
|
||||
use Illuminate\Support\Facades\Log;
|
||||
use Illuminate\View\View;
|
||||
|
||||
/**
|
||||
@@ -24,6 +24,7 @@ use Illuminate\View\View;
|
||||
class UserTemplateComposer
|
||||
{
|
||||
use CollectsActiveExtensionMeta;
|
||||
use CollectsExtensionAssets;
|
||||
use CollectsTemplateExternals;
|
||||
|
||||
/**
|
||||
@@ -121,156 +122,4 @@ class UserTemplateComposer
|
||||
$view->with('appConfig', $appConfig);
|
||||
$view->with('templateExternals', $templateExternals);
|
||||
}
|
||||
|
||||
/**
|
||||
* 확장 프론트엔드 병합 번들 URL을 계산합니다.
|
||||
*
|
||||
* 활성 global 에셋(JS/CSS)이 하나라도 있는 타입만 해당 번들 URL을 채우고,
|
||||
* 없으면 null을 두어 프론트가 로드를 스킵하게 한다. URL은 same-origin
|
||||
* (`/api/...`)이어야 gdpr preblocker 의 same-origin 통과 규칙에 자기 차단되지
|
||||
* 않는다(CDN 호스팅 금지).
|
||||
*
|
||||
* @param array $moduleAssets 수집된 모듈 개별 에셋 맵
|
||||
* @param array $pluginAssets 수집된 플러그인 개별 에셋 맵
|
||||
* @param int $version 확장 캐시 버전
|
||||
* @return array{moduleJs: ?string, moduleCss: ?string, pluginJs: ?string, pluginCss: ?string}
|
||||
*/
|
||||
private function buildExtensionBundleUrls(array $moduleAssets, array $pluginAssets, int $version): array
|
||||
{
|
||||
$hasJs = static fn (array $assets): bool => ! empty(array_filter($assets, fn ($a) => ! empty($a['js'])));
|
||||
$hasCss = static fn (array $assets): bool => ! empty(array_filter($assets, fn ($a) => ! empty($a['css'])));
|
||||
|
||||
return [
|
||||
'moduleJs' => $hasJs($moduleAssets) ? "/api/modules/bundle.js?v={$version}" : null,
|
||||
'moduleCss' => $hasCss($moduleAssets) ? "/api/modules/bundle.css?v={$version}" : null,
|
||||
'pluginJs' => $hasJs($pluginAssets) ? "/api/plugins/bundle.js?v={$version}" : null,
|
||||
'pluginCss' => $hasCss($pluginAssets) ? "/api/plugins/bundle.css?v={$version}" : null,
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* 활성화된 모듈의 프론트엔드 에셋 정보를 수집합니다.
|
||||
*
|
||||
* @return array<string, array{js?: string, css?: string, priority: int, external?: array}>
|
||||
*/
|
||||
private function collectModuleAssets(): array
|
||||
{
|
||||
$assets = [];
|
||||
|
||||
try {
|
||||
// ModuleManager에서 활성화된 모듈 목록 조회
|
||||
$activeModules = $this->moduleManager->getActiveModules();
|
||||
|
||||
// 캐시 버전 조회 (브라우저 캐시 무효화용)
|
||||
$cacheVersion = ClearsTemplateCaches::getExtensionCacheVersion();
|
||||
|
||||
foreach ($activeModules as $identifier => $module) {
|
||||
// 모듈에 에셋이 있는지 확인
|
||||
if (! $module->hasAssets()) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$builtPaths = $module->getBuiltAssetPaths();
|
||||
$loadingConfig = $module->getAssetLoadingConfig();
|
||||
$assetConfig = $module->getAssets();
|
||||
|
||||
// global 전략인 경우에만 수집 (layout, lazy는 레이아웃에서 처리)
|
||||
if ($loadingConfig['strategy'] !== 'global') {
|
||||
continue;
|
||||
}
|
||||
|
||||
$moduleAsset = [
|
||||
'priority' => $loadingConfig['priority'],
|
||||
];
|
||||
|
||||
// JS 빌드 경로 (캐시 버전 파라미터 추가)
|
||||
if (! empty($builtPaths['js'])) {
|
||||
$moduleAsset['js'] = "/api/modules/assets/{$identifier}/".$builtPaths['js']."?v={$cacheVersion}";
|
||||
}
|
||||
|
||||
// CSS 빌드 경로 (캐시 버전 파라미터 추가)
|
||||
if (! empty($builtPaths['css'])) {
|
||||
$moduleAsset['css'] = "/api/modules/assets/{$identifier}/".$builtPaths['css']."?v={$cacheVersion}";
|
||||
}
|
||||
|
||||
// 외부 스크립트 (조건부 로드용)
|
||||
if (! empty($assetConfig['external'])) {
|
||||
$moduleAsset['external'] = $assetConfig['external'];
|
||||
}
|
||||
|
||||
$assets[$identifier] = $moduleAsset;
|
||||
}
|
||||
|
||||
// 우선순위 기준 정렬 (낮을수록 먼저)
|
||||
uasort($assets, fn ($a, $b) => $a['priority'] <=> $b['priority']);
|
||||
} catch (\Exception $e) {
|
||||
// 에러 발생 시 빈 배열 반환 (에셋 로드 실패해도 앱 진행)
|
||||
Log::warning('Failed to collect module assets: '.$e->getMessage());
|
||||
}
|
||||
|
||||
return $assets;
|
||||
}
|
||||
|
||||
/**
|
||||
* 활성화된 플러그인의 프론트엔드 에셋 정보를 수집합니다.
|
||||
*
|
||||
* @return array<string, array{js?: string, css?: string, priority: int, external?: array}>
|
||||
*/
|
||||
private function collectPluginAssets(): array
|
||||
{
|
||||
$assets = [];
|
||||
|
||||
try {
|
||||
// PluginManager에서 활성화된 플러그인 목록 조회
|
||||
$activePlugins = $this->pluginManager->getActivePlugins();
|
||||
|
||||
// 캐시 버전 조회 (브라우저 캐시 무효화용)
|
||||
$cacheVersion = ClearsTemplateCaches::getExtensionCacheVersion();
|
||||
|
||||
foreach ($activePlugins as $identifier => $plugin) {
|
||||
// 플러그인에 에셋이 있는지 확인
|
||||
if (! $plugin->hasAssets()) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$builtPaths = $plugin->getBuiltAssetPaths();
|
||||
$loadingConfig = $plugin->getAssetLoadingConfig();
|
||||
$assetConfig = $plugin->getAssets();
|
||||
|
||||
// global 전략인 경우에만 수집 (layout, lazy는 레이아웃에서 처리)
|
||||
if ($loadingConfig['strategy'] !== 'global') {
|
||||
continue;
|
||||
}
|
||||
|
||||
$pluginAsset = [
|
||||
'priority' => $loadingConfig['priority'],
|
||||
];
|
||||
|
||||
// JS 빌드 경로 (캐시 버전 파라미터 추가)
|
||||
if (! empty($builtPaths['js'])) {
|
||||
$pluginAsset['js'] = "/api/plugins/assets/{$identifier}/".$builtPaths['js']."?v={$cacheVersion}";
|
||||
}
|
||||
|
||||
// CSS 빌드 경로 (캐시 버전 파라미터 추가)
|
||||
if (! empty($builtPaths['css'])) {
|
||||
$pluginAsset['css'] = "/api/plugins/assets/{$identifier}/".$builtPaths['css']."?v={$cacheVersion}";
|
||||
}
|
||||
|
||||
// 외부 스크립트 (조건부 로드용)
|
||||
if (! empty($assetConfig['external'])) {
|
||||
$pluginAsset['external'] = $assetConfig['external'];
|
||||
}
|
||||
|
||||
$assets[$identifier] = $pluginAsset;
|
||||
}
|
||||
|
||||
// 우선순위 기준 정렬 (낮을수록 먼저)
|
||||
uasort($assets, fn ($a, $b) => $a['priority'] <=> $b['priority']);
|
||||
} catch (\Exception $e) {
|
||||
// 에러 발생 시 빈 배열 반환 (에셋 로드 실패해도 앱 진행)
|
||||
Log::warning('Failed to collect plugin assets: '.$e->getMessage());
|
||||
}
|
||||
|
||||
return $assets;
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user