diff --git a/.env.example b/.env.example index ad1164be..8fcf8120 100644 --- a/.env.example +++ b/.env.example @@ -3,7 +3,7 @@ APP_ENV=production APP_KEY= APP_DEBUG=false APP_URL=http://localhost -APP_VERSION=7.0.1 +APP_VERSION=7.0.2 APP_LOCALE=ko APP_FALLBACK_LOCALE=ko @@ -36,7 +36,9 @@ DB_WRITE_PASSWORD= # Database Table Prefix (optional) DB_PREFIX=g7_ -# Read Database Connection (Optional - falls back to WRITE if not set) +# Read Database Connection (Optional) +# 비워두면 각 항목이 대응하는 DB_WRITE_* 값으로 대체됩니다 (config/database.php). +# Read 전용 DB(리플리카)를 쓸 때만 값을 채우세요. DB_READ_HOST= DB_READ_PORT= DB_READ_DATABASE= diff --git a/.env.testing.example b/.env.testing.example index 889ac45f..96277f5a 100644 --- a/.env.testing.example +++ b/.env.testing.example @@ -3,7 +3,7 @@ APP_ENV=testing APP_KEY= APP_DEBUG=false APP_URL=http://localhost -APP_VERSION=7.0.1 +APP_VERSION=7.0.2 APP_LOCALE=ko APP_FALLBACK_LOCALE=ko @@ -34,7 +34,7 @@ DB_WRITE_PASSWORD= DB_PREFIX=g7_ # Read Database Connection (테스트에서는 WRITE와 동일하게 설정) -# database.php의 read 기본값이 WRITE와 다르므로, 명시 설정 필수 +# 비워두면 config/database.php 가 WRITE 값으로 대체하나, 테스트 DB 명시를 위해 값을 채워 둔다. DB_READ_HOST=127.0.0.1 DB_READ_PORT=3306 DB_READ_DATABASE=g7_testing diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md new file mode 100644 index 00000000..6371abda --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -0,0 +1,71 @@ +--- +name: 🐛 버그 제보 +about: 그누보드7(G7) 사용 중 발견한 버그를 제보합니다. +title: "[Bug] " +labels: bug +assignees: '' +--- + +## 증상 요약 + + + +## 재현 절차 + +1. +2. +3. + +## 기대한 동작 + + + +## 실제 동작 + + + +## 환경 정보 (필수) + +> 아래 정보가 없으면 원인 파악이 어렵습니다. 가능한 한 모두 채워 주세요. + +- **코어 버전**: +- **업그레이드 이슈인 경우 — 업그레이드 전 버전 → 후 버전**: +- **PHP 버전**: +- **웹서버·실행 방식**: +- **DB**: +- **OS**: + +## 활성 확장 목록 (해당 시) + + + +```text +(여기에 붙여넣기) +``` + +## 커스텀 자산 여부 (해당 시) + +> 업그레이드·파일 삭제·권한 문제라면 반드시 확인해 주세요. + +- [ ] `modules/_bundled/`·`plugins/_bundled/`·`templates/_bundled/` 아래에 직접 추가한 커스텀 확장이 있습니다. +- [ ] `public/.htaccess` 에 직접 추가한 규칙이 있습니다. +- [ ] 그 외 코어 배포본에 없는 커스텀 파일을 직접 추가/수정했습니다. + + + +## 스크린샷·로그 + + + +## 추가 정보 + + diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 00000000..94e0db64 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,8 @@ +blank_issues_enabled: false +contact_links: + - name: 질문·사용법 문의 (Discussions) + url: https://github.com/gnuboard/g7/discussions + about: 버그가 아닌 사용법 질문·아이디어 논의는 Discussions 를 이용해 주세요. + - name: 보안 취약점 신고 + url: https://github.com/gnuboard/g7/security/advisories/new + about: 보안 취약점은 공개 이슈가 아닌 비공개 Security Advisory 로 신고해 주세요. diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md new file mode 100644 index 00000000..0e9e294b --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.md @@ -0,0 +1,26 @@ +--- +name: ✨ 기능 제안 +about: 새로운 기능이나 개선 아이디어를 제안합니다. +title: "[Feature] " +labels: enhancement +assignees: '' +--- + +## 해결하려는 문제 + + + +## 제안하는 기능 + + + +## 적용 범위 (해당 시) + +- [ ] 코어 +- [ ] 모듈 +- [ ] 플러그인 +- [ ] 템플릿 + +## 대안·참고 사항 + + diff --git a/.github/ISSUE_TEMPLATE/upgrade_issue.md b/.github/ISSUE_TEMPLATE/upgrade_issue.md new file mode 100644 index 00000000..b09d50d0 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/upgrade_issue.md @@ -0,0 +1,51 @@ +--- +name: ⬆️ 업그레이드 문제 +about: core:update / 확장 업데이트 과정에서 발생한 문제를 제보합니다. +title: "[Upgrade] " +labels: "bug, upgrade" +assignees: '' +--- + +## 업그레이드 경로 (필수) + +- **업그레이드 전 버전**: +- **업그레이드 후(목표) 버전**: +- **실행한 명령**: +- **실행 계정/권한**: + +> 참고: `core:update` 는 **현재 설치된(업그레이드 전) 버전의 코드**로 실행됩니다. +> 따라서 최신 버전에서 수정된 버그라도, 그 수정 이전 버전에서 올라오는 경우에는 재발할 수 있습니다. +> 업그레이드 전 반드시 전체 백업을 권장합니다. + +## 증상 + + + +## 확장·커스텀 자산 상태 (필수) + +- [ ] `_bundled/` 아래에 직접 추가한 커스텀 확장이 있습니다. +- [ ] `public/.htaccess`·`public/storage` 등 커스텀 파일/링크가 있습니다. +- [ ] 업데이트 후 위 자산이 삭제/변경되었습니다. + + + +```text +(확장 목록 붙여넣기) +``` + +## 환경 정보 + +- **PHP 버전**: +- **웹서버·실행 방식**: +- **DB**: +- **OS**: + +## 로그·스크린샷 + + diff --git a/.gitignore b/.gitignore index ee76dad5..b2a79076 100644 --- a/.gitignore +++ b/.gitignore @@ -49,6 +49,9 @@ node_modules/ # Settings JSON files (환경별 설정) /storage/app/settings/ +# 확장 프론트엔드 병합 번들 캐시 (version-in-path, 런타임 생성) +/storage/app/ext-bundles/ + # Bootstrap cache (auto-generated) /bootstrap/cache/* !/bootstrap/cache/.gitkeep diff --git a/AGENTS.md b/AGENTS.md index 98717a21..4ffdec6a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -788,6 +788,18 @@ php artisan plugin:update sirsoft-payment --force lazy 번들(편집기/devtools)이 코어 런타임(DynamicRenderer·엔진 싱글톤·React Context·DevTools 코어)을 재사용할 때는 재번들하지 않고 `window.G7Core.__runtime` 을 빌려 쓴다 — React/컨텍스트/싱글톤 인스턴스 동일성이 강제되기 때문(사본이 둘이면 "Invalid hook call"·컨텍스트 미매칭). 메인 번들이 `G7CoreGlobals` 에서 공유 대상을 `G7Core.__runtime` 에 노출하고, lazy 번들 vite config 는 React 4종(`react`/`react-dom`/`react-dom/client`/`react/jsx-runtime`)을 external→window 로, 코어 런타임 모듈을 `resolveId` 플러그인으로 `__runtime-shims/` 로 치환한다. +### 확장 번들 병합 (서버측 concat) + +활성 모듈/플러그인의 프론트엔드 IIFE JS·CSS 는 타입별로 서버에서 하나의 번들로 병합해 서빙한다(`/api/{modules,plugins}/bundle.{js,css}?v={version}`). `ExtensionBundleService` 가 정렬·필터·concat·캐시를 전담하고, 프론트는 `window.G7Config.bundleUrls` 를 읽어 모듈 번들 → 플러그인 번들 순으로 로드한다. 병합 규율: + +- priority 순서는 선언형 — 실행 순서는 오직 manifest `loading.priority` 오름차순(`uasort`). 특정 확장 이름을 지목하는 분기를 두지 않는다. +- IIFE 사이는 `\n;\n`(JS)/`\n`(CSS) 로 잇는다. 미사용 시 ASI 경계가 깨져 번들 전체 파싱 에러가 난다. +- 소스맵은 prod strip, dev 는 개별 에셋 서빙 절대 URL 로 rewrite. 개별 에셋 서빙 라우트(`*.map` 포함)는 존치한다. +- 번들 URL 은 반드시 same-origin(`/api/...`). 외부 origin/CDN·protocol-relative 는 gdpr preblocker 에 자기 차단된다. +- 확장 에셋 절대경로는 `getBuiltAssetAbsolutePaths()`(=`getModulePath()`/`getPluginPath()`) 만 쓴다. `base_path("modules"|"plugins")` 직접 조립은 `_bundled` 경로 오해석 → 빈 번들. +- concat 루프는 확장별 try/catch — 실패 확장만 skip 하고 나머지 병합을 지속한다. +- 번들 파일명에 확장 캐시 버전을 포함(`{type}.{version}.{js,css}`). 조합 변경 시 version bump → 새 파일명 → 자동 재생성. 구파일 GC 는 `ext-bundles:cleanup` + `{module,plugin,template}:cache-clear` 가 담당한다. prod 은 version-in-path 디스크 캐시, 비프로덕션은 매 요청 concat. + ### 빌드 명령어 (Artisan) ```bash diff --git a/CHANGELOG.md b/CHANGELOG.md index 05784da4..468e7d14 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,27 @@ 형식은 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/)를 따르며, [Semantic Versioning](https://semver.org/lang/ko/)을 준수합니다. +## [7.0.2] - 2026-07-08 + +### Added + +- 설치된 모듈·플러그인이 늘어날수록 화면마다 개별로 내려받던 확장 스크립트·스타일 요청을 종류별로 하나로 묶어 내려받도록 개선해, 확장이 많은 사이트의 초기 로딩 요청 수를 크게 줄였습니다. 확장을 설치·활성화·비활성화하면 묶음이 자동으로 다시 만들어져 항상 현재 활성 상태와 일치합니다. + +### Changed + +- 코어 업데이트가 파일을 반영하는 기본 방식을 "새 버전이 실제로 추가·변경한 파일만 반영"으로 바꿔, 업데이트로 인한 사고 가능성을 크게 줄였습니다. 이제 코어가 건드리지 않은 파일은 그대로 두므로, `public/.htaccess` 에 직접 넣은 설정이나 사용자가 추가해 둔 파일이 업데이트 과정에서 사라지지 않습니다. 기존처럼 새 버전에서 제거된 파일 정리까지 포함한 전체 덮어쓰기를 원하면 `--prune` 옵션으로 업데이트하세요. (#64 @bigmsg 님께서 제보해주셨습니다.) +- 화면·데이터를 내려받을 때의 전송 용량을 줄여 초기 로딩과 페이지 이동 속도를 개선했습니다. + - 모듈·플러그인의 묶음 스크립트·스타일이 지금까지 압축 없이 전송되던 것을 압축 전송하도록 바꿔, 확장이 많은 사이트에서 첫 화면에 받는 용량을 크게 줄였습니다. + - 한글 등 다국어 텍스트가 응답에 불필요하게 부풀려 담기던 것을 원래 형태 그대로 담도록 바꿔, 특히 다국어 번역 데이터의 전송 용량을 줄였습니다. + - 화면을 그리는 데 쓰이지 않는 개발용 설명 주석을 화면 정보 응답에서 빼도록 해 응답 용량을 추가로 줄였습니다. + +### Fixed + +- 코어 업데이트 시 레이아웃 편집기·개발자 진단도구 번들의 빌드 설정 파일이 갱신 대상에서 누락되던 문제를 수정했습니다. 이제 코어를 업데이트하면 이 파일들도 최신 내용으로 반영됩니다. +- 설치 마법사에서 Vendor 설치 방식을 "Composer 실행"으로 선택해 설치할 때, 일부 Windows 환경에서 Composer 설치 로그의 문자 인코딩이 어긋나면 진행 상태 응답이 비어 진행 상황이 표시되지 않고 오류가 반복될 수 있던 문제를 보완했습니다. 어떤 문자가 섞이더라도 진행 로그가 항상 정상적으로 전달되도록 처리했습니다. (#62 @kitrio 님께서 제보해주셨습니다.) +- 설치 마법사의 "설치 환경 확인" 단계에서, storage 폴더 하위에 파일이 많이 쌓인 환경일수록 요구사항 검사가 오래 걸리던 문제를 개선했습니다. 폴더 쓰기 권한 검사가 불필요하게 깊은 하위까지 훑던 것을 필요한 범위로 제한해 이 단계가 즉시 완료되도록 했습니다. +- 설치 시 "읽기 전용 데이터베이스(Read DB)를 사용하지 않음"으로 선택했는데도, 읽기 전용 DB 접속 정보를 확인하려다 설치 마지막 단계에서 실패하던 문제를 수정했습니다. 이제 읽기 전용 DB를 사용하지 않으면 쓰기 DB 정보만으로 설치가 정상 완료됩니다. 아울러 설치 이후에도 읽기 전용 DB 접속 정보를 비워 두면 조회 연결이 자동으로 쓰기 DB로 대체되도록 하여, 별도의 읽기 전용 DB 없이도 안정적으로 동작합니다. (#63 @kitrio 님께서 제보해주셨습니다.) + ## [7.0.1] - 2026-07-03 ### Changed diff --git a/INSTALL.md b/INSTALL.md index dc5e17d6..4c4d2f2b 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -246,7 +246,7 @@ unzip g7-release.zip # 압축 해제 결과 확인 — 루트 디렉토리가 g7이 아니면 이름 변경 ls -la -# (필요 시) mv g7-7.0.1 g7 +# (필요 시) mv g7-7.0.2 g7 # ZIP 파일 정리 (선택) rm g7-release.zip diff --git a/README.md b/README.md index c21b4c51..8514de61 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@

- Version + Version PHP Laravel React diff --git a/app/Console/Commands/CleanupExtensionBundlesCommand.php b/app/Console/Commands/CleanupExtensionBundlesCommand.php new file mode 100644 index 00000000..cf1ac59b --- /dev/null +++ b/app/Console/Commands/CleanupExtensionBundlesCommand.php @@ -0,0 +1,43 @@ +getCurrentVersion(); + $deleted = $service->cleanupStaleBundles($currentVersion); + + $this->info("오래된 확장 번들 {$deleted}건이 삭제되었습니다. (현재 version: {$currentVersion})"); + + return self::SUCCESS; + } +} diff --git a/app/Console/Commands/Core/CoreUpdateCommand.php b/app/Console/Commands/Core/CoreUpdateCommand.php index e6104a0c..3012dc67 100644 --- a/app/Console/Commands/Core/CoreUpdateCommand.php +++ b/app/Console/Commands/Core/CoreUpdateCommand.php @@ -28,6 +28,7 @@ class CoreUpdateCommand extends Command protected $signature = 'core:update {--force : 버전 비교 없이 강제 업데이트} {--no-backup : 백업 생성 건너뛰기} + {--prune : 코어가 제거한 파일 정리 + targets 전체 덮어쓰기(기존 방식). 미지정 시 코어가 실제 변경/추가한 파일만 적용하고 나머지는 보존} {--no-maintenance : 유지보수 모드 활성화 건너뛰기} {--local : 로컬 코드베이스를 업데이트 소스로 사용 (GitHub 스킵)} {--source= : 수동 업데이트용 소스 디렉토리 경로 (GitHub 다운로드 대신 지정 디렉토리 사용)} @@ -346,6 +347,12 @@ class CoreUpdateCommand extends Command // // `--no-backup` 모드면 backupPath 가 null 이므로 manifest 생성을 스킵 — 롤백 // 자체가 불가능한 모드이므로 기존 동작 유지. + // 증분 적용(3-way) 대상 목록. 백업 있음 + --prune 미지정 시에만 산출. + // null 로 남으면(백업 부재 또는 --prune) applyUpdate 가 전체 덮어쓰기로 회귀. + $applyList = null; + $applyStats = null; + $prune = (bool) $this->option('prune'); + if ($backupPath !== null) { $bar->setMessage('신규 파일 manifest 생성 중...'); $log('신규 파일 manifest 생성 시작'); @@ -371,15 +378,51 @@ class CoreUpdateCommand extends Command 'error' => $manifestError->getMessage(), ]); } + + // ── 증분 적용 대상 산출 (3-way) ── + // --prune 이면 전체 덮어쓰기이므로 산출 자체를 스킵. + if (! $prune) { + try { + $applyStats = CoreBackupHelper::computeApplyList( + $backupPath, + $pendingPath, + (array) config('app.update.targets', []), + (array) config('app.update.protected_paths', []), + (array) config('app.update.excludes', []), + ); + $applyList = $applyStats['apply']; + $log(sprintf( + '증분 적용 대상 산출 완료 (added=%d, changed=%d, total=%d)', + $applyStats['added_count'], + $applyStats['changed_count'], + count($applyList), + )); + } catch (\Throwable $applyError) { + // 산출 실패 시 안전하게 전체 덮어쓰기로 회귀 (applyList=null 유지) + $applyList = null; + $applyStats = null; + $log("증분 적용 대상 산출 실패 (전체 덮어쓰기로 회귀): {$applyError->getMessage()}"); + Log::warning('코어 업데이트: 증분 적용 대상 산출 실패', [ + 'error' => $applyError->getMessage(), + ]); + } + } } // ── Step 7: 파일 적용 ── $bar->setMessage(__('settings.core_update.step_apply')); $bar->advance(); - $log('코어 파일 덮어쓰기 시작'); - $service->applyUpdate($pendingPath, $onProgress); - $log('코어 파일 덮어쓰기 완료'); + if ($prune) { + $log('코어 파일 덮어쓰기 시작 (--prune: 전체 덮어쓰기 + orphan 정리)'); + } elseif ($applyList !== null) { + $log(sprintf('코어 파일 적용 시작 (증분: 코어 변경분 %d건만 적용, 나머지 보존)', count($applyList))); + } else { + $log('코어 파일 덮어쓰기 시작 (백업 부재 — 전체 덮어쓰기로 회귀)'); + } + + $service->applyUpdate($pendingPath, $onProgress, prune: $prune, applyList: $applyList); + $log('코어 파일 적용 완료'); // ── Step 8: vendor 디렉토리 복사 (_pending → 운영) ── if ($composerSkipped) { @@ -503,6 +546,9 @@ class CoreUpdateCommand extends Command $this->info("그누보드7 코어가 {$toVersion} 버전으로 업데이트되었습니다!"); $this->newLine(); + // ── 파일 적용 방식 요약 (부수의무: 설명의무) ── + $this->summarizeApplyMode($prune, $applyList, $applyStats); + // _bundled 확장 일괄 업데이트 프롬프트 (번들에 신버전이 있을 때만 표시). // // 주의: Step 11 restoreOwnership 이후에 실행되므로, 프롬프트 내 실제 @@ -1068,6 +1114,41 @@ class CoreUpdateCommand extends Command return true; } + /** + * 파일 적용 방식(증분/prune/fallback)과 통계를 사용자에게 요약 출력합니다. + * + * @param bool $prune --prune 지정 여부 + * @param array|null $applyList 증분 적용 대상 목록 (null 이면 전체 덮어쓰기) + * @param array{apply:array, added_count:int, changed_count:int, has_symlink:bool}|null $applyStats computeApplyList 산출 통계 + */ + private function summarizeApplyMode(bool $prune, ?array $applyList, ?array $applyStats): void + { + if ($prune) { + $this->line(__('settings.core_update.apply_mode_prune')); + $this->newLine(); + + return; + } + + if ($applyList === null) { + // 백업 부재 또는 산출 실패 → 전체 덮어쓰기로 회귀 + $this->warn(__('settings.core_update.apply_mode_fallback')); + $this->newLine(); + + return; + } + + // 증분 모드 + $added = $applyStats['added_count'] ?? 0; + $changed = $applyStats['changed_count'] ?? 0; + $this->line(__('settings.core_update.apply_mode_incremental', [ + 'added' => $added, + 'changed' => $changed, + ])); + $this->line(__('settings.core_update.apply_mode_incremental_prune_hint')); + $this->newLine(); + } + /** * 업데이트 로그를 파일로 저장합니다. * diff --git a/app/Console/Commands/Module/ClearModuleCacheCommand.php b/app/Console/Commands/Module/ClearModuleCacheCommand.php index 1fad57b9..6c2d5362 100644 --- a/app/Console/Commands/Module/ClearModuleCacheCommand.php +++ b/app/Console/Commands/Module/ClearModuleCacheCommand.php @@ -5,6 +5,7 @@ namespace App\Console\Commands\Module; use App\Contracts\Extension\CacheInterface; use App\Contracts\Repositories\ModuleRepositoryInterface; use App\Extension\ModuleManager; +use App\Services\ExtensionBundleService; use Illuminate\Console\Command; use Illuminate\Support\Facades\Log; @@ -27,7 +28,8 @@ class ClearModuleCacheCommand extends Command public function __construct( private ModuleManager $moduleManager, private ModuleRepositoryInterface $moduleRepository, - private CacheInterface $cache + private CacheInterface $cache, + private ExtensionBundleService $bundleService ) { parent::__construct(); } @@ -86,6 +88,9 @@ class ClearModuleCacheCommand extends Command $clearedCount += $this->clearModuleCache($module->getIdentifier()); } + // 모듈 프론트엔드 병합 번들 파일 삭제 (캐시 키 forget 만으로는 미삭제) + $clearedCount += $this->bundleService->clearBundles('module'); + $this->info('✅ '.__('modules.commands.cache_clear.success_all', ['count' => $clearedCount])); } diff --git a/app/Console/Commands/Plugin/ClearPluginCacheCommand.php b/app/Console/Commands/Plugin/ClearPluginCacheCommand.php index 1fd77bb3..0dd0aa42 100644 --- a/app/Console/Commands/Plugin/ClearPluginCacheCommand.php +++ b/app/Console/Commands/Plugin/ClearPluginCacheCommand.php @@ -5,6 +5,7 @@ namespace App\Console\Commands\Plugin; use App\Contracts\Extension\CacheInterface; use App\Contracts\Repositories\PluginRepositoryInterface; use App\Extension\PluginManager; +use App\Services\ExtensionBundleService; use Illuminate\Console\Command; use Illuminate\Support\Facades\Log; @@ -27,7 +28,8 @@ class ClearPluginCacheCommand extends Command public function __construct( private PluginManager $pluginManager, private PluginRepositoryInterface $pluginRepository, - private CacheInterface $cache + private CacheInterface $cache, + private ExtensionBundleService $bundleService ) { parent::__construct(); } @@ -86,6 +88,9 @@ class ClearPluginCacheCommand extends Command $clearedCount += $this->clearPluginCache($plugin->getIdentifier()); } + // 플러그인 프론트엔드 병합 번들 파일 삭제 (캐시 키 forget 만으로는 미삭제) + $clearedCount += $this->bundleService->clearBundles('plugin'); + $this->info('✅ '.__('plugins.commands.cache_clear.success_all', ['count' => $clearedCount])); } diff --git a/app/Console/Commands/Template/ClearTemplateCacheCommand.php b/app/Console/Commands/Template/ClearTemplateCacheCommand.php index 8c8a8632..ca13ec43 100644 --- a/app/Console/Commands/Template/ClearTemplateCacheCommand.php +++ b/app/Console/Commands/Template/ClearTemplateCacheCommand.php @@ -6,6 +6,7 @@ use App\Contracts\Extension\CacheInterface; use App\Extension\TemplateManager; use App\Models\Template; use App\Models\TemplateLayout; +use App\Services\ExtensionBundleService; use Illuminate\Console\Command; use Illuminate\Support\Facades\Log; @@ -27,7 +28,8 @@ class ClearTemplateCacheCommand extends Command */ public function __construct( private TemplateManager $templateManager, - private CacheInterface $cache + private CacheInterface $cache, + private ExtensionBundleService $bundleService ) { parent::__construct(); } @@ -153,6 +155,9 @@ class ClearTemplateCacheCommand extends Command $this->cache->forget('templates.active.user'); $clearedCount += 2; + // 5. 확장 프론트엔드 병합 번들 파일 전체 삭제 (템플릿 캐시 정리는 페이지 전면 갱신) + $clearedCount += $this->bundleService->clearBundles(); + $this->info('✅ '.__('templates.commands.cache_clear.success_all', [ 'count' => $clearedCount, ])); diff --git a/app/Extension/AbstractModule.php b/app/Extension/AbstractModule.php index 8a72e698..c7a3f532 100644 --- a/app/Extension/AbstractModule.php +++ b/app/Extension/AbstractModule.php @@ -1190,6 +1190,29 @@ abstract class AbstractModule implements CacheableExtensionInterface, ModuleInte return $result; } + /** + * 빌드된 에셋의 절대 파일 경로를 반환합니다. + * + * `getBuiltAssetPaths()` 는 module.json 의 상대 output 경로를 돌려주므로 + * 파일을 실제로 읽으려면 모듈 루트(`getModulePath()`: 활성 dir 또는 `_bundled` + * 실제 위치)를 앞에 붙여야 한다. 서버측 번들 병합(ExtensionBundleService)이 + * `getAssetFilePath()` 의 `base_path("modules/{id}/...")` 하드코딩을 복제하지 + * 않고 `_bundled` 확장에서도 정확한 경로를 얻도록 이 게터를 SSoT 로 쓴다. + * + * @return array 빌드된 에셋 절대 경로 배열 ['js' => '...', 'css' => '...'] + */ + public function getBuiltAssetAbsolutePaths(): array + { + $relative = $this->getBuiltAssetPaths(); + $result = []; + + foreach ($relative as $kind => $output) { + $result[$kind] = $this->getModulePath().'/'.$output; + } + + return $result; + } + /** * 모듈 스토리지 드라이버 인스턴스 반환 * diff --git a/app/Extension/AbstractPlugin.php b/app/Extension/AbstractPlugin.php index 5dd4ad10..1e76a1b8 100644 --- a/app/Extension/AbstractPlugin.php +++ b/app/Extension/AbstractPlugin.php @@ -1011,6 +1011,30 @@ abstract class AbstractPlugin implements CacheableExtensionInterface, PluginInte return $result; } + /** + * 빌드된 에셋의 절대 파일 경로를 반환합니다. + * + * `getBuiltAssetPaths()` 는 plugin.json 의 상대 output 경로를 돌려주므로 + * 파일을 실제로 읽으려면 플러그인 루트(`getPluginPath()`: 활성 dir 또는 + * `_bundled` 실제 위치)를 앞에 붙여야 한다. 서버측 번들 병합 + * (ExtensionBundleService)이 `getAssetFilePath()` 의 + * `base_path("plugins/{id}/...")` 하드코딩을 복제하지 않고 `_bundled` + * 확장에서도 정확한 경로를 얻도록 이 게터를 SSoT 로 쓴다. + * + * @return array 빌드된 에셋 절대 경로 배열 ['js' => '...', 'css' => '...'] + */ + public function getBuiltAssetAbsolutePaths(): array + { + $relative = $this->getBuiltAssetPaths(); + $result = []; + + foreach ($relative as $kind => $output) { + $result[$kind] = $this->getPluginPath().'/'.$output; + } + + return $result; + } + /** * 플러그인이 설정 페이지를 가지고 있는지 확인합니다. * diff --git a/app/Extension/Helpers/CoreBackupHelper.php b/app/Extension/Helpers/CoreBackupHelper.php index 08d305b7..204bd42e 100644 --- a/app/Extension/Helpers/CoreBackupHelper.php +++ b/app/Extension/Helpers/CoreBackupHelper.php @@ -336,6 +336,176 @@ class CoreBackupHelper ]; } + /** + * 코어(신 버전)가 실제로 추가·변경한 파일 목록(적용 대상)을 3-way 비교로 산출합니다. + * + * `core:update` 기본(증분) 모드에서 `applyUpdate()` 가 참조하는 "적용 대상 집합"을 + * 만든다. 코어가 건드리지 않은 파일(base == theirs)은 목록에서 제외되어, 활성 + * 디렉토리에 남은 현재 상태(사용자 수정 포함 가능)를 그대로 보존한다. + * + * 3-way 판정: + * - base = 구버전 원본 = 백업 스냅샷 (`$backupPath/$target`) + * - theirs = 신 버전 = _pending 소스 (`$sourcePath/$target`) + * - 규칙: + * · base 없음 (theirs 에만 존재) → added (신규 파일 — 적용) + * · base 있고 size 또는 md5 다름 → changed (코어가 변경 — 적용) + * · base 있고 size·md5 동일 → 제외 (코어 미변경 — 스킵/보존) + * + * 성능: size 가 다르면 md5 를 계산하지 않는다(즉시 changed). size 가 같을 때만 + * `md5_file`. mtime 은 비교하지 않는다 — `_pending` 은 방금 추출되어 mtime 이 + * 전부 추출 시각이므로 항상 "다름"으로 오판한다. + * + * symlink 는 목록에서 제외한다 — 링크 자체는 `copyDirectory` 의 별도 링크 처리 + * 경로가 담당하며, 증분 모드에서도 항상 재생성되어야 한다(target 추적 없이 동일 + * 링크). 따라서 반환값 `is_partial` 이 true 여도 링크는 정상 반영된다. + * + * `writeNewFilesManifest()` 와 동일한 순회 구조·가드(`excludes`/`protectedPaths`)를 + * 재사용한다. 두 산출을 각각 별도 순회하지만, 반환값은 in-memory 로 즉시 소비되어 + * 파일화 비용이 없다(롤백용 `_new_files_manifest.json` 은 별도). + * + * @param string $backupPath 백업 디렉토리 경로 (= base, 활성 사전 스냅샷) + * @param string $sourcePath 소스 디렉토리 경로 (= theirs, _pending 신 버전) + * @param array $targets 처리할 target 경로 목록 (`app.update.targets`) + * @param array $protectedPaths 보호 경로 목록 (목록에서 제외) + * @param array $excludes 제외 패턴 목록 (예: ['node_modules', '.git']) + * @return array{apply:array, added_count:int, changed_count:int, has_symlink:bool} + * apply = 적용 대상 상대경로 목록(정렬됨, 슬래시 정규화) + */ + public static function computeApplyList( + string $backupPath, + string $sourcePath, + array $targets, + array $protectedPaths, + array $excludes, + ): array { + $added = []; + $changed = []; + $hasSymlink = false; + + $protectedSet = self::normalizeProtectedSet($protectedPaths); + $excludeSet = array_values(array_filter(array_map('trim', $excludes))); + + foreach ($targets as $target) { + $target = trim($target); + if ($target === '') { + continue; + } + + if (self::isWithinProtectedPath($target, $protectedSet)) { + continue; + } + + $sourceTargetPath = $sourcePath.DIRECTORY_SEPARATOR.$target; + if (! file_exists($sourceTargetPath)) { + continue; + } + + // 단일 파일 target + if (is_file($sourceTargetPath) && ! is_link($sourceTargetPath)) { + $rel = self::normalizeRelative($target); + $backupFilePath = $backupPath.DIRECTORY_SEPARATOR.$target; + self::classifyForApply($rel, $sourceTargetPath, $backupFilePath, $added, $changed); + + continue; + } + + if (is_link($sourceTargetPath)) { + $hasSymlink = true; + + continue; + } + + if (! is_dir($sourceTargetPath)) { + continue; + } + + // 디렉토리 target — 재귀 비교 + $iterator = new RecursiveIteratorIterator( + new RecursiveDirectoryIterator($sourceTargetPath, FilesystemIterator::SKIP_DOTS), + RecursiveIteratorIterator::SELF_FIRST, + ); + + foreach ($iterator as $item) { + /** @var SplFileInfo $item */ + $absolute = $item->getPathname(); + $relative = self::normalizeRelative($target.'/'.ltrim(substr($absolute, strlen($sourceTargetPath)), DIRECTORY_SEPARATOR.'/')); + + if (self::matchesExcludes($relative, $excludeSet)) { + continue; + } + if (self::isWithinProtectedPath($relative, $protectedSet)) { + continue; + } + + // symlink 는 목록 제외 — 링크 처리 경로가 별도 담당 + if ($item->isLink()) { + $hasSymlink = true; + + continue; + } + + // 디렉토리 자체는 목록에 담지 않는다 — 파일 단위 적용이 디렉토리를 + // 필요 시 생성한다(copyDirectory 가 대상 디렉토리를 ensure). + if (! $item->isFile()) { + continue; + } + + $backupItemPath = $backupPath.DIRECTORY_SEPARATOR.str_replace('/', DIRECTORY_SEPARATOR, $relative); + self::classifyForApply($relative, $absolute, $backupItemPath, $added, $changed); + } + } + + $apply = array_values(array_unique(array_merge($added, $changed))); + sort($apply, SORT_STRING); + + return [ + 'apply' => $apply, + 'added_count' => count($added), + 'changed_count' => count($changed), + 'has_symlink' => $hasSymlink, + ]; + } + + /** + * 3-way 판정으로 파일 하나를 added/changed 로 분류하거나 제외합니다. + * + * base(백업) 부재 → added, size 다름 또는 md5 다름 → changed, 동일 → 제외. + * + * @param string $relative 슬래시 정규화된 상대 경로 (목록 등재값) + * @param string $theirsAbsolute 신 버전(_pending) 파일 절대 경로 + * @param string $baseAbsolute 백업(base) 파일 절대 경로 + * @param array $added added 누적 배열 (참조) + * @param array $changed changed 누적 배열 (참조) + */ + private static function classifyForApply( + string $relative, + string $theirsAbsolute, + string $baseAbsolute, + array &$added, + array &$changed, + ): void { + if (! file_exists($baseAbsolute) || is_dir($baseAbsolute)) { + $added[] = $relative; + + return; + } + + // size 선필터 — 다르면 md5 생략하고 즉시 changed + $theirsSize = @filesize($theirsAbsolute); + $baseSize = @filesize($baseAbsolute); + if ($theirsSize !== $baseSize) { + $changed[] = $relative; + + return; + } + + // size 동일 → 내용 비교 + if (@md5_file($theirsAbsolute) !== @md5_file($baseAbsolute)) { + $changed[] = $relative; + } + // 동일하면 제외 (코어 미변경 — 스킵) + } + /** * 백업 디렉토리의 manifest 를 로드해 활성 디렉토리에서 신 버전 신규 파일을 정리합니다. * diff --git a/app/Extension/Helpers/FilePermissionHelper.php b/app/Extension/Helpers/FilePermissionHelper.php index e29877b2..35e99155 100644 --- a/app/Extension/Helpers/FilePermissionHelper.php +++ b/app/Extension/Helpers/FilePermissionHelper.php @@ -32,8 +32,13 @@ class FilePermissionHelper * @param string $relativePath 현재 상대 경로 (내부 재귀용) * @param bool $removeOrphans 소스에 없는 대상 파일/디렉토리 삭제 여부 * @param bool $preserveTopLevelOrphans 최상위 한 레벨의 orphan 보존 여부 + * @param array|null $applyList 적용 대상 파일 상대경로 화이트리스트 + * (이 디렉토리 루트 기준, `'sub/file.txt' => true` 형태의 lookup 맵). null 이면 + * 전체 파일 복사(기존 동작). 지정 시 이 맵에 없는 파일은 복사를 스킵한다 — 코어 + * 업데이트 증분 모드에서 "코어가 변경하지 않은 파일"을 건드리지 않기 위함. symlink + * 는 이 필터의 영향을 받지 않고 항상 재생성된다(링크는 목록 산출 대상이 아님). */ - public static function copyDirectory(string $source, string $destination, ?\Closure $onProgress = null, array $excludes = [], string $relativePath = '', bool $removeOrphans = false, bool $preserveTopLevelOrphans = false): void + public static function copyDirectory(string $source, string $destination, ?\Closure $onProgress = null, array $excludes = [], string $relativePath = '', bool $removeOrphans = false, bool $preserveTopLevelOrphans = false, ?array $applyList = null): void { if (! File::isDirectory($destination)) { // 신규 디렉토리: 부모 디렉토리의 퍼미션/소유권 상속 @@ -76,8 +81,13 @@ class FilePermissionHelper if ($item->isDir()) { // preserveTopLevelOrphans 는 최상위 한 레벨 한정 — 자식 재귀에는 항상 false 전달. - static::copyDirectory($item->getPathname(), $destPath, $onProgress, $excludes, $itemRelativePath, $removeOrphans, preserveTopLevelOrphans: false); + static::copyDirectory($item->getPathname(), $destPath, $onProgress, $excludes, $itemRelativePath, $removeOrphans, preserveTopLevelOrphans: false, applyList: $applyList); } else { + // 증분 모드(applyList 지정): 화이트리스트에 없는 파일은 스킵 — + // 코어가 변경하지 않은 파일의 현재 디스크 상태(사용자 수정 포함)를 보존. + if ($applyList !== null && ! isset($applyList[$itemRelativePath])) { + continue; + } static::copyFile($item->getPathname(), $destPath); } } diff --git a/app/Helpers/ResponseHelper.php b/app/Helpers/ResponseHelper.php index e7114513..f83a3ea6 100644 --- a/app/Helpers/ResponseHelper.php +++ b/app/Helpers/ResponseHelper.php @@ -9,14 +9,23 @@ use Illuminate\Support\Facades\App; class ResponseHelper { + /** + * JSON 응답 인코딩 옵션. + * + * JSON_UNESCAPED_UNICODE: 한글 등 멀티바이트 문자를 `\uXXXX` (6바이트) 로 + * 이스케이프하지 않고 raw UTF-8 (한글 3바이트) 로 직렬화하여 응답 크기를 줄인다. + * 특히 다국어 팩(lang) 응답에서 전송량 절감 효과가 크다. + */ + public const JSON_ENCODE_OPTIONS = JSON_UNESCAPED_UNICODE; + /** * 성공 응답을 생성합니다. * - * @param string $messageKey 메시지 키 (기본값: 'messages.success') - * @param mixed $data 응답 데이터 - * @param int $statusCode HTTP 상태 코드 (기본값: 200) - * @param array $messageParams 메시지 매개변수 - * @param string $domain 번역 도메인 (기본값: 'core') + * @param string $messageKey 메시지 키 (기본값: 'messages.success') + * @param mixed $data 응답 데이터 + * @param int $statusCode HTTP 상태 코드 (기본값: 200) + * @param array $messageParams 메시지 매개변수 + * @param string $domain 번역 도메인 (기본값: 'core') * @return JsonResponse JSON 응답 */ public static function success( @@ -29,18 +38,18 @@ class ResponseHelper return response()->json([ 'success' => true, 'message' => self::trans($messageKey, $messageParams, $domain), - 'data' => $data - ], $statusCode); + 'data' => $data, + ], $statusCode, [], self::JSON_ENCODE_OPTIONS); } /** * 실패 응답을 생성합니다. * - * @param string $messageKey 메시지 키 (기본값: 'messages.failed') - * @param int $statusCode HTTP 상태 코드 (기본값: 400) - * @param mixed $errors 오류 정보 - * @param array $messageParams 메시지 매개변수 - * @param string $domain 번역 도메인 (기본값: 'core') + * @param string $messageKey 메시지 키 (기본값: 'messages.failed') + * @param int $statusCode HTTP 상태 코드 (기본값: 400) + * @param mixed $errors 오류 정보 + * @param array $messageParams 메시지 매개변수 + * @param string $domain 번역 도메인 (기본값: 'core') * @return JsonResponse JSON 응답 */ public static function error( @@ -59,28 +68,28 @@ class ResponseHelper if (config('app.debug')) { // messageParams에 이미 에러 메시지가 포함된 경우 중복 방지 if (empty($messageParams)) { - $response['message'] .= ': ' . $errors->getMessage(); + $response['message'] .= ': '.$errors->getMessage(); } $response['debug'] = self::formatException($errors); } } elseif ($errors !== null) { - if ($statusCode >= 500 && is_string($errors) && !config('app.debug')) { + if ($statusCode >= 500 && is_string($errors) && ! config('app.debug')) { // 프로덕션 500+ 에러의 string errors 차단 (내부 예외 메시지 노출 방지) } else { $response['errors'] = $errors; } } - return response()->json($response, $statusCode); + return response()->json($response, $statusCode, [], self::JSON_ENCODE_OPTIONS); } /** * 입력 검증 실패 응답을 생성합니다. * - * @param mixed $errors 검증 오류 정보 - * @param string $messageKey 메시지 키 (기본값: 'messages.validation_failed') - * @param array $messageParams 메시지 매개변수 - * @param string $domain 번역 도메인 (기본값: 'core') + * @param mixed $errors 검증 오류 정보 + * @param string $messageKey 메시지 키 (기본값: 'messages.validation_failed') + * @param array $messageParams 메시지 매개변수 + * @param string $domain 번역 도메인 (기본값: 'core') * @return JsonResponse 422 상태 코드를 가진 JSON 응답 */ public static function validationError( @@ -92,16 +101,16 @@ class ResponseHelper return response()->json([ 'success' => false, 'message' => self::trans($messageKey, $messageParams, $domain), - 'errors' => $errors - ], 422); + 'errors' => $errors, + ], 422, [], self::JSON_ENCODE_OPTIONS); } /** * 인증 실패 응답을 생성합니다. * - * @param string $messageKey 메시지 키 (기본값: 'messages.unauthorized') - * @param array $messageParams 메시지 매개변수 - * @param string $domain 번역 도메인 (기본값: 'core') + * @param string $messageKey 메시지 키 (기본값: 'messages.unauthorized') + * @param array $messageParams 메시지 매개변수 + * @param string $domain 번역 도메인 (기본값: 'core') * @return JsonResponse 401 상태 코드를 가진 JSON 응답 */ public static function unauthorized( @@ -111,16 +120,16 @@ class ResponseHelper ): JsonResponse { return response()->json([ 'success' => false, - 'message' => self::trans($messageKey, $messageParams, $domain) - ], 401); + 'message' => self::trans($messageKey, $messageParams, $domain), + ], 401, [], self::JSON_ENCODE_OPTIONS); } /** * 권한 부족 응답을 생성합니다. * - * @param string $messageKey 멤시지 키 (기본값: 'messages.forbidden') - * @param array $messageParams 멤시지 매개변수 - * @param string $domain 번역 도메인 (기본값: 'core') + * @param string $messageKey 멤시지 키 (기본값: 'messages.forbidden') + * @param array $messageParams 멤시지 매개변수 + * @param string $domain 번역 도메인 (기본값: 'core') * @return JsonResponse 403 상태 코드를 가진 JSON 응답 */ public static function forbidden( @@ -130,16 +139,16 @@ class ResponseHelper ): JsonResponse { return response()->json([ 'success' => false, - 'message' => self::trans($messageKey, $messageParams, $domain) - ], 403); + 'message' => self::trans($messageKey, $messageParams, $domain), + ], 403, [], self::JSON_ENCODE_OPTIONS); } /** * 리소스를 찾을 수 없음 응답을 생성합니다. * - * @param string $messageKey 멤시지 키 (기본값: 'messages.not_found') - * @param array $messageParams 멤시지 매개변수 - * @param string $domain 번역 도메인 (기본값: 'core') + * @param string $messageKey 멤시지 키 (기본값: 'messages.not_found') + * @param array $messageParams 멤시지 매개변수 + * @param string $domain 번역 도메인 (기본값: 'core') * @return JsonResponse 404 상태 코드를 가진 JSON 응답 */ public static function notFound( @@ -149,17 +158,17 @@ class ResponseHelper ): JsonResponse { return response()->json([ 'success' => false, - 'message' => self::trans($messageKey, $messageParams, $domain) - ], 404); + 'message' => self::trans($messageKey, $messageParams, $domain), + ], 404, [], self::JSON_ENCODE_OPTIONS); } /** * 서버 내부 오류 응답을 생성합니다. * - * @param string $messageKey 멤시지 키 (기본값: 'messages.error_occurred') - * @param mixed $error 오류 정보 (디버그 모드에서만 표시) - * @param array $messageParams 멤시지 매개변수 - * @param string $domain 번역 도메인 (기본값: 'core') + * @param string $messageKey 멤시지 키 (기본값: 'messages.error_occurred') + * @param mixed $error 오류 정보 (디버그 모드에서만 표시) + * @param array $messageParams 멤시지 매개변수 + * @param string $domain 번역 도메인 (기본값: 'core') * @return JsonResponse 500 상태 코드를 가진 JSON 응답 */ public static function serverError( @@ -175,22 +184,22 @@ class ResponseHelper if ($error instanceof \Throwable) { if (config('app.debug')) { - $response['message'] .= ': ' . $error->getMessage(); + $response['message'] .= ': '.$error->getMessage(); $response['debug'] = self::formatException($error); } } elseif ($error !== null && config('app.debug')) { $response['error'] = $error; } - return response()->json($response, 500); + return response()->json($response, 500, [], self::JSON_ENCODE_OPTIONS); } /** * 다국어 메시지를 변환합니다. * - * @param string $key 번역 키 - * @param array $params 번역 매개변수 - * @param string $domain 번역 도메인 + * @param string $key 번역 키 + * @param array $params 번역 매개변수 + * @param string $domain 번역 도메인 * @return string 번역된 메시지 */ private static function trans( @@ -199,10 +208,10 @@ class ResponseHelper string $domain = 'core' ): string { $locale = self::getUserLocale(); - + // 도메인별로 다른 경로에서 번역 파일 로드 $translationKey = $domain === 'core' ? $key : "{$domain}::{$key}"; - + return __($translationKey, $params, $locale); } @@ -225,7 +234,7 @@ class ResponseHelper /** * 예외 정보를 디버그용 배열로 변환합니다. * - * @param \Throwable $e 예외 인스턴스 + * @param \Throwable $e 예외 인스턴스 * @return array 디버그 정보 배열 */ private static function formatException(\Throwable $e): array @@ -238,7 +247,7 @@ class ResponseHelper 'trace' => collect($e->getTrace())->take(10)->map(fn ($frame) => [ 'file' => $frame['file'] ?? null, 'line' => $frame['line'] ?? null, - 'function' => ($frame['class'] ?? '') . ($frame['type'] ?? '') . ($frame['function'] ?? ''), + 'function' => ($frame['class'] ?? '').($frame['type'] ?? '').($frame['function'] ?? ''), ])->toArray(), ]; } @@ -246,11 +255,11 @@ class ResponseHelper /** * 모듈별 성공 응답을 생성합니다. * - * @param string $module 모듈명 - * @param string $messageKey 멤시지 키 - * @param mixed $data 응답 데이터 - * @param int $statusCode HTTP 상태 코드 (기본값: 200) - * @param array $messageParams 멤시지 매개변수 + * @param string $module 모듈명 + * @param string $messageKey 멤시지 키 + * @param mixed $data 응답 데이터 + * @param int $statusCode HTTP 상태 코드 (기본값: 200) + * @param array $messageParams 멤시지 매개변수 * @return JsonResponse JSON 응답 */ public static function moduleSuccess( @@ -266,11 +275,11 @@ class ResponseHelper /** * 모듈별 실패 응답을 생성합니다. * - * @param string $module 모듈명 - * @param string $messageKey 멤시지 키 - * @param int $statusCode HTTP 상태 코드 (기본값: 400) - * @param mixed $errors 오류 정보 - * @param array $messageParams 멤시지 매개변수 + * @param string $module 모듈명 + * @param string $messageKey 멤시지 키 + * @param int $statusCode HTTP 상태 코드 (기본값: 400) + * @param mixed $errors 오류 정보 + * @param array $messageParams 멤시지 매개변수 * @return JsonResponse JSON 응답 */ public static function moduleError( @@ -286,11 +295,11 @@ class ResponseHelper /** * 플러그인별 성공 응답을 생성합니다. * - * @param string $plugin 플러그인명 - * @param string $messageKey 멤시지 키 - * @param mixed $data 응답 데이터 - * @param int $statusCode HTTP 상태 코드 (기본값: 200) - * @param array $messageParams 멤시지 매개변수 + * @param string $plugin 플러그인명 + * @param string $messageKey 멤시지 키 + * @param mixed $data 응답 데이터 + * @param int $statusCode HTTP 상태 코드 (기본값: 200) + * @param array $messageParams 멤시지 매개변수 * @return JsonResponse JSON 응답 */ public static function pluginSuccess( @@ -306,11 +315,11 @@ class ResponseHelper /** * 플러그인별 실패 응답을 생성합니다. * - * @param string $plugin 플러그인명 - * @param string $messageKey 멤시지 키 - * @param int $statusCode HTTP 상태 코드 (기본값: 400) - * @param mixed $errors 오류 정보 - * @param array $messageParams 멤시지 매개변수 + * @param string $plugin 플러그인명 + * @param string $messageKey 멤시지 키 + * @param int $statusCode HTTP 상태 코드 (기본값: 400) + * @param mixed $errors 오류 정보 + * @param array $messageParams 멤시지 매개변수 * @return JsonResponse JSON 응답 */ public static function pluginError( @@ -326,11 +335,11 @@ class ResponseHelper /** * JSON Resource를 사용한 성공 응답을 생성합니다. * - * @param string $messageKey 멤시지 키 (기본값: 'messages.success') - * @param JsonResource|ResourceCollection|null $resource JSON 리소스 - * @param int $statusCode HTTP 상태 코드 (기본값: 200) - * @param array $messageParams 멤시지 매개변수 - * @param string $domain 번역 도메인 (기본값: 'core') + * @param string $messageKey 멤시지 키 (기본값: 'messages.success') + * @param JsonResource|ResourceCollection|null $resource JSON 리소스 + * @param int $statusCode HTTP 상태 코드 (기본값: 200) + * @param array $messageParams 멤시지 매개변수 + * @param string $domain 번역 도메인 (기본값: 'core') * @return JsonResponse JSON 응답 */ public static function successWithResource( @@ -341,22 +350,22 @@ class ResponseHelper string $domain = 'core' ): JsonResponse { $data = $resource ? $resource->resolve() : null; - + return response()->json([ 'success' => true, 'message' => self::trans($messageKey, $messageParams, $domain), - 'data' => $data - ], $statusCode); + 'data' => $data, + ], $statusCode, [], self::JSON_ENCODE_OPTIONS); } /** * JSON Resource를 사용한 모듈 성공 응답을 생성합니다. * - * @param string $module 모듈명 - * @param string $messageKey 멤시지 키 - * @param JsonResource|ResourceCollection|null $resource JSON 리소스 - * @param int $statusCode HTTP 상태 코드 (기본값: 200) - * @param array $messageParams 멤시지 매개변수 + * @param string $module 모듈명 + * @param string $messageKey 멤시지 키 + * @param JsonResource|ResourceCollection|null $resource JSON 리소스 + * @param int $statusCode HTTP 상태 코드 (기본값: 200) + * @param array $messageParams 멤시지 매개변수 * @return JsonResponse JSON 응답 */ public static function moduleSuccessWithResource( @@ -372,11 +381,11 @@ class ResponseHelper /** * JSON Resource를 사용한 플러그인 성공 응답을 생성합니다. * - * @param string $plugin 플러그인명 - * @param string $messageKey 멤시지 키 - * @param JsonResource|ResourceCollection|null $resource JSON 리소스 - * @param int $statusCode HTTP 상태 코드 (기본값: 200) - * @param array $messageParams 멤시지 매개변수 + * @param string $plugin 플러그인명 + * @param string $messageKey 멤시지 키 + * @param JsonResource|ResourceCollection|null $resource JSON 리소스 + * @param int $statusCode HTTP 상태 코드 (기본값: 200) + * @param array $messageParams 멤시지 매개변수 * @return JsonResponse JSON 응답 */ public static function pluginSuccessWithResource( @@ -392,21 +401,21 @@ class ResponseHelper /** * 페이지네이션된 리소스 응답을 생성합니다. * - * @param string $messageKey 멤시지 키 (기본값: 'messages.success') - * @param ResourceCollection|null $collection 페이지네이션된 리소스 컬렉션 - * @param array $messageParams 멤시지 매개변수 - * @param string $domain 번역 도메인 (기본값: 'core') + * @param string $messageKey 멤시지 키 (기본값: 'messages.success') + * @param ResourceCollection|null $collection 페이지네이션된 리소스 컬렉션 + * @param array $messageParams 멤시지 매개변수 + * @param string $domain 번역 도메인 (기본값: 'core') * @return JsonResponse 페이지네이션 메타 데이터를 포함한 JSON 응답 */ public static function successWithPagination( string $messageKey = 'messages.success', - ResourceCollection|null $collection = null, + ?ResourceCollection $collection = null, array $messageParams = [], string $domain = 'core' ): JsonResponse { $response = [ 'success' => true, - 'message' => self::trans($messageKey, $messageParams, $domain) + 'message' => self::trans($messageKey, $messageParams, $domain), ]; if ($collection) { @@ -424,7 +433,7 @@ class ResponseHelper $response['links'] = $paginationData['links'] ?? null; } - return response()->json($response); + return response()->json($response, 200, [], self::JSON_ENCODE_OPTIONS); } /** @@ -444,6 +453,6 @@ class ResponseHelper 'error_code' => 'identity_verification_required', 'message' => self::trans('identity.errors.verification_required', [], 'core'), 'verification' => $verification, - ], 428); + ], 428, [], self::JSON_ENCODE_OPTIONS); } } diff --git a/app/Http/Controllers/Api/Base/BaseApiController.php b/app/Http/Controllers/Api/Base/BaseApiController.php index 84e57b35..c8f4e2f5 100644 --- a/app/Http/Controllers/Api/Base/BaseApiController.php +++ b/app/Http/Controllers/Api/Base/BaseApiController.php @@ -4,6 +4,7 @@ namespace App\Http\Controllers\Api\Base; use App\Helpers\ResponseHelper; use App\Http\Controllers\Controller; +use App\Models\User; use Illuminate\Http\JsonResponse; use Illuminate\Http\Response; use Illuminate\Support\Facades\Auth; @@ -20,11 +21,11 @@ abstract class BaseApiController extends Controller /** * 성공 응답을 생성합니다. * - * @param string $messageKey 메시지 키 - * @param mixed $data 응답 데이터 - * @param int $statusCode HTTP 상태 코드 - * @param array $messageParams 메시지 매개변수 - * @return \Illuminate\Http\JsonResponse + * @param string $messageKey 메시지 키 + * @param mixed $data 응답 데이터 + * @param int $statusCode HTTP 상태 코드 + * @param array $messageParams 메시지 매개변수 + * @return JsonResponse */ protected function success( string $messageKey = 'common.success', @@ -38,11 +39,11 @@ abstract class BaseApiController extends Controller /** * 실패 응답을 생성합니다. * - * @param string $messageKey 메시지 키 - * @param int $statusCode HTTP 상태 코드 - * @param mixed $errors 오류 정보 - * @param array $messageParams 메시지 매개변수 - * @return \Illuminate\Http\JsonResponse + * @param string $messageKey 메시지 키 + * @param int $statusCode HTTP 상태 코드 + * @param mixed $errors 오류 정보 + * @param array $messageParams 메시지 매개변수 + * @return JsonResponse */ protected function error( string $messageKey = 'common.failed', @@ -56,11 +57,11 @@ abstract class BaseApiController extends Controller /** * 리소스와 함께 성공 응답을 생성합니다. * - * @param string $messageKey 메시지 키 - * @param mixed $resource JSON 리소스 - * @param int $statusCode HTTP 상태 코드 - * @param array $messageParams 메시지 매개변수 - * @return \Illuminate\Http\JsonResponse + * @param string $messageKey 메시지 키 + * @param mixed $resource JSON 리소스 + * @param int $statusCode HTTP 상태 코드 + * @param array $messageParams 메시지 매개변수 + * @return JsonResponse */ protected function successWithResource( string $messageKey = 'common.success', @@ -74,7 +75,7 @@ abstract class BaseApiController extends Controller /** * 현재 인증된 사용자를 반환합니다. * - * @return \App\Models\User|null + * @return User|null */ protected function getCurrentUser() { @@ -84,9 +85,9 @@ abstract class BaseApiController extends Controller /** * Not Found 응답을 생성합니다. * - * @param string $messageKey 메시지 키 - * @param array $messageParams 메시지 매개변수 - * @return \Illuminate\Http\JsonResponse + * @param string $messageKey 메시지 키 + * @param array $messageParams 메시지 매개변수 + * @return JsonResponse */ protected function notFound( string $messageKey = 'common.not_found', @@ -98,9 +99,9 @@ abstract class BaseApiController extends Controller /** * Unauthorized 응답을 생성합니다. * - * @param string $messageKey 메시지 키 - * @param array $messageParams 메시지 매개변수 - * @return \Illuminate\Http\JsonResponse + * @param string $messageKey 메시지 키 + * @param array $messageParams 메시지 매개변수 + * @return JsonResponse */ protected function unauthorized( string $messageKey = 'common.unauthorized', @@ -112,9 +113,9 @@ abstract class BaseApiController extends Controller /** * Forbidden 응답을 생성합니다. * - * @param string $messageKey 메시지 키 - * @param array $messageParams 메시지 매개변수 - * @return \Illuminate\Http\JsonResponse + * @param string $messageKey 메시지 키 + * @param array $messageParams 메시지 매개변수 + * @return JsonResponse */ protected function forbidden( string $messageKey = 'common.forbidden', @@ -126,10 +127,10 @@ abstract class BaseApiController extends Controller /** * Validation Error 응답을 생성합니다. * - * @param mixed $errors 검증 오류 - * @param string $messageKey 메시지 키 - * @param array $messageParams 메시지 매개변수 - * @return \Illuminate\Http\JsonResponse + * @param mixed $errors 검증 오류 + * @param string $messageKey 메시지 키 + * @param array $messageParams 메시지 매개변수 + * @return JsonResponse */ protected function validationError( mixed $errors, @@ -142,9 +143,9 @@ abstract class BaseApiController extends Controller /** * 파일 응답을 반환합니다 (ETag 및 캐싱 헤더 포함). * - * @param string $filePath 파일 경로 - * @param string $mimeType MIME 타입 - * @param int $maxAge 캐시 유지 시간 (초, 기본: 1년) + * @param string $filePath 파일 경로 + * @param string $mimeType MIME 타입 + * @param int $maxAge 캐시 유지 시간 (초, 기본: 1년) */ protected function fileResponse(string $filePath, string $mimeType, int $maxAge = 31536000): BinaryFileResponse|Response { @@ -176,35 +177,35 @@ abstract class BaseApiController extends Controller /** * JSON 응답을 반환합니다 (캐싱 헤더 포함). * - * @param mixed $data JSON으로 변환할 데이터 - * @param int $maxAge 캐시 유지 시간 (초, 기본: 1시간) - * @param int $status HTTP 상태 코드 + * @param mixed $data JSON으로 변환할 데이터 + * @param int $maxAge 캐시 유지 시간 (초, 기본: 1시간) + * @param int $status HTTP 상태 코드 * @return JsonResponse JSON 응답 */ protected function cachedJsonResponse(mixed $data, int $maxAge = 3600, int $status = 200): JsonResponse { return response()->json($data, $status, [ 'Cache-Control' => "public, max-age={$maxAge}", - ]); + ], ResponseHelper::JSON_ENCODE_OPTIONS); } /** * ETag를 생성합니다. * - * @param mixed $data 해시할 데이터 + * @param mixed $data 해시할 데이터 * @return string ETag 값 (따옴표 포함) */ protected function generateETag(mixed $data): string { $content = is_string($data) ? $data : json_encode($data); - return '"' . md5($content) . '"'; + return '"'.md5($content).'"'; } /** * 클라이언트 캐시가 유효한지 확인합니다. * - * @param string $etag 현재 ETag 값 + * @param string $etag 현재 ETag 값 * @return bool 캐시가 유효하면 true */ protected function isNotModified(string $etag): bool @@ -217,8 +218,8 @@ abstract class BaseApiController extends Controller /** * 304 Not Modified 응답을 반환합니다. * - * @param string $etag ETag 값 - * @param int $maxAge 캐시 TTL (초) + * @param string $etag ETag 값 + * @param int $maxAge 캐시 TTL (초) * @return Response 304 응답 */ protected function notModifiedResponse(string $etag, int $maxAge = 3600): Response @@ -233,10 +234,10 @@ abstract class BaseApiController extends Controller * * 클라이언트의 ETag가 일치하면 304 Not Modified를 반환합니다. * - * @param string $messageKey 메시지 키 - * @param mixed $data 응답 데이터 - * @param int $maxAge 캐시 TTL (초, 기본: 1시간) - * @param array $messageParams 메시지 매개변수 + * @param string $messageKey 메시지 키 + * @param mixed $data 응답 데이터 + * @param int $maxAge 캐시 TTL (초, 기본: 1시간) + * @param array $messageParams 메시지 매개변수 * @return JsonResponse|Response JSON 응답 또는 304 응답 */ protected function successWithCache( @@ -256,7 +257,7 @@ abstract class BaseApiController extends Controller 'success' => true, 'message' => __($messageKey, $messageParams), 'data' => $data, - ]) + ], 200, [], ResponseHelper::JSON_ENCODE_OPTIONS) ->header('ETag', $etag) ->header('Cache-Control', "public, max-age={$maxAge}") ->header('Vary', 'Accept-Encoding, Accept-Language'); diff --git a/app/Http/Controllers/Api/Public/PublicModuleController.php b/app/Http/Controllers/Api/Public/PublicModuleController.php index cf46e435..85de88f1 100644 --- a/app/Http/Controllers/Api/Public/PublicModuleController.php +++ b/app/Http/Controllers/Api/Public/PublicModuleController.php @@ -4,6 +4,7 @@ namespace App\Http\Controllers\Api\Public; use App\Http\Controllers\Api\Base\PublicBaseController; use App\Http\Requests\Public\Module\ServeModuleAssetRequest; +use App\Services\ExtensionBundleService; use App\Services\ModuleService; use Illuminate\Http\JsonResponse; use Illuminate\Http\Response; @@ -17,11 +18,54 @@ use Symfony\Component\HttpFoundation\BinaryFileResponse; class PublicModuleController extends PublicBaseController { public function __construct( - private readonly ModuleService $moduleService + private readonly ModuleService $moduleService, + private readonly ExtensionBundleService $bundleService ) { parent::__construct(); } + /** + * 활성 모듈 프론트엔드 IIFE 병합 번들(JS)을 서빙합니다. + * + * 활성 global 모듈 에셋이 없으면 빈 200 응답(text/javascript)을 반환한다 + * (프론트는 빈 스크립트 로드로 무해). 그 외에는 병합 파일을 fileResponse 로 + * 서빙(ETag/304/환경별 Cache-Control 재사용). + * + * @return BinaryFileResponse|Response 병합 JS 파일 응답 또는 빈 응답 + */ + public function serveBundleJs(): BinaryFileResponse|Response + { + $this->logApiUsage('modules.bundle', ['kind' => 'js']); + + $version = $this->bundleService->getCurrentVersion(); + $path = $this->bundleService->getBundleFilePath('module', 'js', $version); + + if ($path === '') { + return response('', 200)->header('Content-Type', 'text/javascript'); + } + + return $this->fileResponse($path, 'text/javascript', 31536000); + } + + /** + * 활성 모듈 프론트엔드 병합 번들(CSS)을 서빙합니다. + * + * @return BinaryFileResponse|Response 병합 CSS 파일 응답 또는 빈 응답 + */ + public function serveBundleCss(): BinaryFileResponse|Response + { + $this->logApiUsage('modules.bundle', ['kind' => 'css']); + + $version = $this->bundleService->getCurrentVersion(); + $path = $this->bundleService->getBundleFilePath('module', 'css', $version); + + if ($path === '') { + return response('', 200)->header('Content-Type', 'text/css'); + } + + return $this->fileResponse($path, 'text/css', 31536000); + } + /** * 모듈 에셋 서빙 * diff --git a/app/Http/Controllers/Api/Public/PublicPluginController.php b/app/Http/Controllers/Api/Public/PublicPluginController.php index bb3e0f7b..b187f984 100644 --- a/app/Http/Controllers/Api/Public/PublicPluginController.php +++ b/app/Http/Controllers/Api/Public/PublicPluginController.php @@ -4,6 +4,7 @@ namespace App\Http\Controllers\Api\Public; use App\Http\Controllers\Api\Base\PublicBaseController; use App\Http\Requests\Public\Plugin\ServePluginAssetRequest; +use App\Services\ExtensionBundleService; use App\Services\PluginService; use Illuminate\Http\JsonResponse; use Illuminate\Http\Response; @@ -17,11 +18,53 @@ use Symfony\Component\HttpFoundation\BinaryFileResponse; class PublicPluginController extends PublicBaseController { public function __construct( - private readonly PluginService $pluginService + private readonly PluginService $pluginService, + private readonly ExtensionBundleService $bundleService ) { parent::__construct(); } + /** + * 활성 플러그인 프론트엔드 IIFE 병합 번들(JS)을 서빙합니다. + * + * 활성 global 플러그인 에셋이 없으면 빈 200 응답(text/javascript)을 반환한다. + * 그 외에는 병합 파일을 fileResponse 로 서빙(ETag/304/환경별 Cache-Control 재사용). + * + * @return BinaryFileResponse|Response 병합 JS 파일 응답 또는 빈 응답 + */ + public function serveBundleJs(): BinaryFileResponse|Response + { + $this->logApiUsage('plugins.bundle', ['kind' => 'js']); + + $version = $this->bundleService->getCurrentVersion(); + $path = $this->bundleService->getBundleFilePath('plugin', 'js', $version); + + if ($path === '') { + return response('', 200)->header('Content-Type', 'text/javascript'); + } + + return $this->fileResponse($path, 'text/javascript', 31536000); + } + + /** + * 활성 플러그인 프론트엔드 병합 번들(CSS)을 서빙합니다. + * + * @return BinaryFileResponse|Response 병합 CSS 파일 응답 또는 빈 응답 + */ + public function serveBundleCss(): BinaryFileResponse|Response + { + $this->logApiUsage('plugins.bundle', ['kind' => 'css']); + + $version = $this->bundleService->getCurrentVersion(); + $path = $this->bundleService->getBundleFilePath('plugin', 'css', $version); + + if ($path === '') { + return response('', 200)->header('Content-Type', 'text/css'); + } + + return $this->fileResponse($path, 'text/css', 31536000); + } + /** * 플러그인 에셋 서빙 * diff --git a/app/Http/Middleware/GzipEncodeResponse.php b/app/Http/Middleware/GzipEncodeResponse.php index e66953d1..f8d56022 100644 --- a/app/Http/Middleware/GzipEncodeResponse.php +++ b/app/Http/Middleware/GzipEncodeResponse.php @@ -4,6 +4,7 @@ namespace App\Http\Middleware; use Closure; use Illuminate\Http\Request; +use Symfony\Component\HttpFoundation\BinaryFileResponse; use Symfony\Component\HttpFoundation\Response; /** @@ -98,6 +99,15 @@ class GzipEncodeResponse } // 최소 크기 이상인지 확인 + // BinaryFileResponse 는 getContent() 가 false 를 반환하므로 파일 크기로 판정한다. + // (번들 JS/CSS 서빙은 response()->file() 로 BinaryFileResponse 를 반환하며, + // 이 분기가 없으면 미들웨어가 압축 없이 통과시켜 비압축 전송된다.) + if ($response instanceof BinaryFileResponse) { + $file = $response->getFile(); + + return $file !== null && $file->getSize() >= self::MIN_COMPRESS_SIZE; + } + $content = $response->getContent(); if ($content === false || strlen($content) < self::MIN_COMPRESS_SIZE) { return false; @@ -158,6 +168,12 @@ class GzipEncodeResponse */ private function compressResponse(Response $response): Response { + // BinaryFileResponse 는 본문을 setContent() 로 교체할 수 없으므로 + // 파일 내용을 읽어 일반 Response 로 치환한 뒤 압축한다 (헤더는 승계). + if ($response instanceof BinaryFileResponse) { + return $this->compressBinaryFileResponse($response); + } + $content = $response->getContent(); // gzip 압축 적용 @@ -173,14 +189,70 @@ class GzipEncodeResponse $response->headers->set('Content-Encoding', 'gzip'); $response->headers->set('Content-Length', (string) strlen($compressed)); - // Vary 헤더가 없으면 추가 (캐시 프록시 지원) + $this->ensureVaryAcceptEncoding($response); + + return $response; + } + + /** + * BinaryFileResponse 를 gzip 압축된 일반 Response 로 치환합니다. + * + * BinaryFileResponse 는 파일 스트림 기반이라 setContent() 로 본문을 교체할 수 없으므로, + * 파일 내용을 읽어 gzip 압축한 새 Response 를 생성하고 기존 헤더(Content-Type, + * ETag, Cache-Control, Expires 등)를 승계한다. Content-Encoding/Content-Length 는 + * 압축 결과로 재설정한다. + * + * @param BinaryFileResponse $response 파일 응답 + * @return Response gzip 압축된 응답 (실패 시 원본 반환) + */ + private function compressBinaryFileResponse(BinaryFileResponse $response): Response + { + $file = $response->getFile(); + + if ($file === null) { + return $response; + } + + $content = @file_get_contents($file->getPathname()); + + if ($content === false) { + // 파일 읽기 실패 시 원본(비압축) 반환 + return $response; + } + + $compressed = gzencode($content, self::COMPRESSION_LEVEL); + + if ($compressed === false) { + return $response; + } + + // 기존 헤더를 승계한 새 Response 생성 (본문만 압축된 내용으로 교체) + $compressedResponse = new Response( + $compressed, + $response->getStatusCode(), + $response->headers->all() + ); + + $compressedResponse->headers->set('Content-Encoding', 'gzip'); + $compressedResponse->headers->set('Content-Length', (string) strlen($compressed)); + + $this->ensureVaryAcceptEncoding($compressedResponse); + + return $compressedResponse; + } + + /** + * 응답에 `Vary: Accept-Encoding` 헤더를 보장합니다 (캐시 프록시 지원). + * + * @param Response $response HTTP 응답 + */ + private function ensureVaryAcceptEncoding(Response $response): void + { if (! $response->headers->has('Vary')) { $response->headers->set('Vary', 'Accept-Encoding'); } elseif (! str_contains($response->headers->get('Vary', ''), 'Accept-Encoding')) { $currentVary = $response->headers->get('Vary'); $response->headers->set('Vary', $currentVary.', Accept-Encoding'); } - - return $response; } } diff --git a/app/Http/View/Composers/TemplateComposer.php b/app/Http/View/Composers/TemplateComposer.php index ff7c9320..5d565fb3 100644 --- a/app/Http/View/Composers/TemplateComposer.php +++ b/app/Http/View/Composers/TemplateComposer.php @@ -99,6 +99,9 @@ class TemplateComposer // 확장 기능 캐시 버전 (브라우저 캐시 무효화용) $extensionCacheVersion = ClearsTemplateCaches::getExtensionCacheVersion(); + // 확장 프론트엔드 병합 번들 URL (상시 ON — 활성 에셋이 없으면 null) + $bundleUrls = $this->buildExtensionBundleUrls($moduleAssets, $pluginAssets, $extensionCacheVersion); + $view->with('activeAdminTemplate', $activeTemplate); $view->with('extensionCacheVersion', $extensionCacheVersion); $view->with('frontendSettings', $frontendSettings); @@ -106,12 +109,39 @@ class TemplateComposer $view->with('moduleSettings', $moduleSettings); $view->with('moduleAssets', $moduleAssets); $view->with('pluginAssets', $pluginAssets); + $view->with('bundleUrls', $bundleUrls); $view->with('activeModulesMeta', $activeModulesMeta); $view->with('activePluginsMeta', $activePluginsMeta); $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, + ]; + } + /** * 활성화된 모듈의 프론트엔드 에셋 정보를 수집합니다. * diff --git a/app/Http/View/Composers/UserTemplateComposer.php b/app/Http/View/Composers/UserTemplateComposer.php index c6460938..d145b0b1 100644 --- a/app/Http/View/Composers/UserTemplateComposer.php +++ b/app/Http/View/Composers/UserTemplateComposer.php @@ -105,6 +105,9 @@ class UserTemplateComposer // 확장 기능 캐시 버전 (브라우저 캐시 무효화용) $extensionCacheVersion = ClearsTemplateCaches::getExtensionCacheVersion(); + // 확장 프론트엔드 병합 번들 URL (상시 ON — 활성 에셋이 없으면 null) + $bundleUrls = $this->buildExtensionBundleUrls($moduleAssets, $pluginAssets, $extensionCacheVersion); + $view->with('activeUserTemplate', $activeTemplate); $view->with('extensionCacheVersion', $extensionCacheVersion); $view->with('frontendSettings', $frontendSettings); @@ -112,12 +115,39 @@ class UserTemplateComposer $view->with('moduleSettings', $moduleSettings); $view->with('moduleAssets', $moduleAssets); $view->with('pluginAssets', $pluginAssets); + $view->with('bundleUrls', $bundleUrls); $view->with('activeModulesMeta', $activeModulesMeta); $view->with('activePluginsMeta', $activePluginsMeta); $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, + ]; + } + /** * 활성화된 모듈의 프론트엔드 에셋 정보를 수집합니다. * diff --git a/app/Services/CoreUpdateService.php b/app/Services/CoreUpdateService.php index b3523eff..10cd302d 100644 --- a/app/Services/CoreUpdateService.php +++ b/app/Services/CoreUpdateService.php @@ -885,7 +885,16 @@ class CoreUpdateService } /** - * 코어 업데이트 대상 파일만 선택적으로 덮어씁니다. + * 코어 업데이트 대상 파일을 덮어씁니다. + * + * 기본(증분) 모드 — `$applyList` 가 주어지고 `$prune === false`: + * - 코어(신 버전)가 실제로 추가·변경한 파일만 적용한다(3-way 판정 산출물). + * - 코어가 건드리지 않은 파일은 복사·chmod·chown·mtime 갱신을 전부 스킵하여 현재 + * 디스크 상태(사용자 수정 포함 가능)를 그대로 보존한다. + * - orphan(소스에 없는 대상 파일) 삭제를 하지 않는다 — 사용자가 추가한 신규 파일 보존. + * + * prune 모드 — `$prune === true` 또는 `$applyList === null`(백업 부재 fallback): + * - targets 전체를 무조건 덮어쓰고, 소스에 없는 orphan 을 삭제한다(기존 동작). * * 주의: ExtensionPendingHelper::copyToActive()는 PHP copy()를 사용하여 * 파일 퍼미션/소유자를 보존하지 않으므로, 코어 업데이트에서는 사용하지 않습니다. @@ -893,12 +902,29 @@ class CoreUpdateService * * @param string $sourcePath 소스 경로 (_pending 내) * @param \Closure|null $onProgress 진행 콜백 + * @param bool $prune true 면 전체 덮어쓰기 + orphan 삭제(기존 동작), false 면 증분 적용 + * @param array|null $applyList 적용 대상 상대경로 목록(target 접두사 포함). + * `CoreBackupHelper::computeApplyList()` 산출물. null 이면 증분 불가로 판단해 전체 덮어쓰기. */ - public function applyUpdate(string $sourcePath, ?\Closure $onProgress = null): void + public function applyUpdate(string $sourcePath, ?\Closure $onProgress = null, bool $prune = false, ?array $applyList = null): void { $targets = config('app.update.targets', []); $excludes = config('app.update.excludes', []); + // 증분 모드 여부: prune 이 아니고 적용 목록이 주어진 경우에만 증분 적용. + // applyList 가 null 이면(백업 부재 등) 안전을 위해 전체 덮어쓰기로 회귀한다. + $incremental = ! $prune && $applyList !== null; + + // 증분 모드에서 각 target 하위 파일을 O(1) 로 조회하기 위한 lookup 맵. + // computeApplyList 는 target 접두사를 포함한 상대경로(예: 'public/.htaccess')를 + // 반환하므로, 그대로 정규화 키로 담는다. + $applySet = []; + if ($incremental) { + foreach ($applyList as $rel) { + $applySet[$this->normalizeRelativePath((string) $rel)] = true; + } + } + $applied = []; foreach ($targets as $target) { @@ -909,21 +935,45 @@ class CoreUpdateService continue; } + $normalizedTarget = $this->normalizeRelativePath($target); + $onProgress?->__invoke('apply', $target); if (File::isDirectory($src)) { + // 증분 모드: 이 target 하위의 적용 대상만 추린 뒤, target 접두사를 벗겨 + // copyDirectory 의 내부 상대경로($itemRelativePath)와 직접 매칭되는 + // 화이트리스트 맵을 만든다. + $targetApplyList = null; + if ($incremental) { + $targetApplyList = $this->buildTargetApplyList($applySet, $normalizedTarget); + } + // `{domain}/_bundled` 타깃은 최상위 한 레벨의 orphan 을 보존한다 — 사용자가 // `_bundled/` 바로 아래에 직접 만든 커스텀 확장 디렉토리/파일이 코어 업데이트 // 소스(번들 확장만 포함)에 없다는 이유로 삭제되던 결함 차단. - // 번들 확장 디렉토리 *내부* stale 정리는 그대로 유지된다. - $preserveTopLevelOrphans = str_ends_with($this->normalizeRelativePath($target), '_bundled'); - FilePermissionHelper::copyDirectory($src, $dest, $onProgress, $excludes, removeOrphans: true, preserveTopLevelOrphans: $preserveTopLevelOrphans); + // 번들 확장 디렉토리 *내부* stale 정리는 prune 모드에서만 수행된다. + $preserveTopLevelOrphans = str_ends_with($normalizedTarget, '_bundled'); + FilePermissionHelper::copyDirectory( + $src, + $dest, + $onProgress, + $excludes, + removeOrphans: $prune, + preserveTopLevelOrphans: $preserveTopLevelOrphans, + applyList: $targetApplyList, + ); } else { + // 단일 파일 target — 증분 모드에서는 적용 목록에 있을 때만 복사. + if ($incremental && ! isset($applySet[$normalizedTarget])) { + $applied[$normalizedTarget] = true; + + continue; + } File::ensureDirectoryExists(dirname($dest)); FilePermissionHelper::copyFile($src, $dest); } - $applied[$this->normalizeRelativePath($target)] = true; + $applied[$normalizedTarget] = true; } // 자동 발견 폴백 — 부모 프로세스(구버전) 의 stale `app.update.targets` 가 @@ -1005,6 +1055,31 @@ class CoreUpdateService return trim(str_replace(['\\', '/'], '/', $path), '/'); } + /** + * 전체 적용 집합에서 특정 target 하위 항목만 추려, target 접두사를 제거한 + * `copyDirectory` 내부 상대경로 화이트리스트 맵을 만듭니다. + * + * `computeApplyList` 는 target 접두사를 포함한 경로(예: `public/.htaccess`)를 담지만, + * `copyDirectory` 는 target 루트 기준 상대경로(`.htaccess`)로 항목을 순회하므로 접두사를 + * 벗겨야 매칭된다. + * + * @param array $applySet 전체 적용 대상 정규화 경로 lookup 맵 + * @param string $normalizedTarget 정규화된 target 경로 (예: `public`) + * @return array target 내부 상대경로 화이트리스트 (빈 맵일 수 있음 → 전부 스킵) + */ + private function buildTargetApplyList(array $applySet, string $normalizedTarget): array + { + $prefix = $normalizedTarget.'/'; + $out = []; + foreach ($applySet as $rel => $_) { + if (str_starts_with((string) $rel, $prefix)) { + $out[substr((string) $rel, strlen($prefix))] = true; + } + } + + return $out; + } + /** * 정규화된 path 가 이미 처리된 상위/하위 path 와 관계가 있는지 검사합니다. * diff --git a/app/Services/ExtensionBundleService.php b/app/Services/ExtensionBundleService.php new file mode 100644 index 00000000..9966b4c5 --- /dev/null +++ b/app/Services/ExtensionBundleService.php @@ -0,0 +1,475 @@ +` 로 실행해도 등록 로직은 동일하게 동작한다. + * + * 정렬/필터(`hasAssets()` && strategy==='global' + `uasort(priority)`) 는 + * TemplateComposer 와 공유하는 SSoT 로 이 서비스에 둔다(drift 방지). + * + * 경로는 절대경로 게터(`getBuiltAssetAbsolutePaths()`)를 재사용한다 — + * `ModuleService::getAssetFilePath()` 의 `base_path("modules/{id}/...")` + * 하드코딩을 복제하지 않아야 `_bundled` 확장에서도 정확히 읽는다(제약 4). + * + * @see TemplateComposer + */ +class ExtensionBundleService +{ + // ext.cache_version 게터 재사용 — 트레이트를 use 해 self:: 로 호출(트레이트명 + // 직접 정적 호출은 PHP 8.3+ deprecated). 인스턴스 캐시 무효화 메서드는 미사용. + use ClearsTemplateCaches; + + /** + * 번들 캐시 파일이 저장되는 스토리지 디스크(= storage/app/ext-bundles). + */ + private const BUNDLE_DISK = 'ext-bundles'; + + /** + * 서비스 주입 + * + * @param ModuleManager $moduleManager 모듈 매니저 + * @param PluginManager $pluginManager 플러그인 매니저 + */ + public function __construct( + private readonly ModuleManager $moduleManager, + private readonly PluginManager $pluginManager + ) {} + + /** + * 확장 타입별 global 전략 에셋을 priority 오름차순으로 정렬해 반환합니다. + * + * TemplateComposer 의 개별 에셋 URL 생성과 번들러의 concat 이 동일한 + * 필터/정렬을 쓰도록 하는 SSoT. 순서 제어는 오직 manifest + * `loading.priority` 숫자 오름차순뿐이며 특정 확장 이름 하드코딩은 없다(제약 1). + * + * @param string $type 'module' | 'plugin' + * @return array + * identifier => 절대경로/우선순위 (priority 오름차순 정렬) + */ + public function getOrderedGlobalAssetPaths(string $type): array + { + $extensions = $type === 'plugin' + ? $this->pluginManager->getActivePlugins() + : $this->moduleManager->getActiveModules(); + + $ordered = []; + + foreach ($extensions as $extension) { + if (! $extension->hasAssets()) { + continue; + } + + $loadingConfig = $extension->getAssetLoadingConfig(); + + // global 전략만 번들 대상 (layout, lazy 는 레이아웃에서 개별 처리) + if (($loadingConfig['strategy'] ?? 'global') !== 'global') { + continue; + } + + $absolutePaths = $extension->getBuiltAssetAbsolutePaths(); + + $jsAbsPath = $absolutePaths['js'] ?? null; + $cssAbsPath = $absolutePaths['css'] ?? null; + + // JS/CSS 둘 다 없으면 번들에 기여할 것이 없으므로 제외 + if ($jsAbsPath === null && $cssAbsPath === null) { + continue; + } + + $ordered[$extension->getIdentifier()] = [ + 'jsAbsPath' => $jsAbsPath, + 'cssAbsPath' => $cssAbsPath, + 'priority' => (int) ($loadingConfig['priority'] ?? 100), + ]; + } + + // priority 오름차순 (낮을수록 먼저) — 개별 로딩과 동일 규칙 + uasort($ordered, fn ($a, $b) => $a['priority'] <=> $b['priority']); + + return $ordered; + } + + /** + * 확장 타입의 JS 번들 문자열을 생성합니다. + * + * priority 순으로 각 IIFE 파일을 읽어 `\n;\n` 구분자로 이어붙인다(제약 2 — + * ASI 경계 보호). 각 파일 끝의 `//# sourceMappingURL` 주석은 prod 에서는 + * strip(맵 생략), dev 에서는 개별 에셋 서빙 절대 URL 로 rewrite 한다(제약 3). + * + * 확장별 fine-grained try/catch — 파일 읽기 실패 시 해당 확장만 skip + + * Log::warning, 나머지 병합 지속(한 확장 실패가 번들 전체를 붕괴시키지 않음). + * + * @param string $type 'module' | 'plugin' + * @return string 병합된 JS (활성 global 에셋이 없으면 빈 문자열) + */ + public function buildJsBundle(string $type): string + { + $ordered = $this->getOrderedGlobalAssetPaths($type); + $isProduction = app()->environment('production'); + $segments = []; + + foreach ($ordered as $identifier => $paths) { + if (empty($paths['jsAbsPath'])) { + continue; + } + + try { + $content = @file_get_contents($paths['jsAbsPath']); + + if ($content === false) { + Log::warning('확장 JS 번들 병합: 파일 읽기 실패, 해당 확장 skip', [ + 'type' => $type, + 'identifier' => $identifier, + 'path' => $paths['jsAbsPath'], + ]); + + continue; + } + + $segments[] = $this->processJsSourceMap($content, $type, $identifier, $isProduction); + } catch (\Throwable $e) { + Log::warning('확장 JS 번들 병합 중 오류, 해당 확장 skip', [ + 'type' => $type, + 'identifier' => $identifier, + 'error' => $e->getMessage(), + ]); + } + } + + return implode("\n;\n", $segments); + } + + /** + * 확장 타입의 CSS 번들 문자열을 생성합니다. + * + * priority 순으로 각 CSS 파일을 읽어 `\n` 구분자로 이어붙인다. 상대경로 + * `url(...)` 참조가 있는 CSS 는 병합 시 경로가 깨지므로 번들에서 제외하고 + * 경고 로그를 남긴다(안전장치 — 현재 번들 CSS 는 url() 0건). + * + * @param string $type 'module' | 'plugin' + * @return string 병합된 CSS (활성 global 에셋이 없으면 빈 문자열) + */ + public function buildCssBundle(string $type): string + { + $ordered = $this->getOrderedGlobalAssetPaths($type); + $segments = []; + + foreach ($ordered as $identifier => $paths) { + if (empty($paths['cssAbsPath'])) { + continue; + } + + try { + $content = @file_get_contents($paths['cssAbsPath']); + + if ($content === false) { + Log::warning('확장 CSS 번들 병합: 파일 읽기 실패, 해당 확장 skip', [ + 'type' => $type, + 'identifier' => $identifier, + 'path' => $paths['cssAbsPath'], + ]); + + continue; + } + + // 상대경로 url() 참조가 있으면 병합 시 폰트/이미지 경로가 깨진다. + // 절대/data URI 는 안전하므로 상대경로만 검출해 해당 CSS 제외. + if ($this->hasRelativeUrl($content)) { + Log::warning('확장 CSS 에 상대경로 url() 존재 — 번들에서 제외(개별 폴백 유지)', [ + 'type' => $type, + 'identifier' => $identifier, + ]); + + continue; + } + + $segments[] = $content; + } catch (\Throwable $e) { + Log::warning('확장 CSS 번들 병합 중 오류, 해당 확장 skip', [ + 'type' => $type, + 'identifier' => $identifier, + 'error' => $e->getMessage(), + ]); + } + } + + return implode("\n", $segments); + } + + /** + * 캐시된 번들 파일의 절대 경로를 반환합니다(없으면 build → 원자적 write). + * + * 파일명에 version 을 포함(`{type}.{version}.{js|css}`)하므로 활성 조합이 + * 바뀌어 version 이 bump 되면 새 파일명으로 자연 무효화된다. 프로덕션에서만 + * 디스크 캐시하며, 비프로덕션(dev/watch)에서는 캐시하지 않고 매 요청 build 해 + * rebuild 를 즉시 반영한다(PO 결정). + * + * @param string $type 'module' | 'plugin' + * @param string $kind 'js' | 'css' + * @param int $version 확장 캐시 버전(ClearsTemplateCaches::getExtensionCacheVersion) + * @return string 캐시(또는 방금 build 한) 파일의 절대 경로. 병합 결과가 빈 문자열이면 빈 문자열. + */ + public function getBundleFilePath(string $type, string $kind, int $version): string + { + $content = $kind === 'css' + ? $this->buildCssBundle($type) + : $this->buildJsBundle($type); + + // 병합할 에셋이 하나도 없으면 파일을 만들지 않는다(호출측이 빈 문자열로 판단). + if ($content === '') { + return ''; + } + + $storage = $this->bundleStorage(); + $relativeName = $this->bundleFileName($type, $kind, $version); + + // 비프로덕션은 캐시하지 않고 임시 파일로 매번 build → rebuild 즉시 반영 + if (! app()->environment('production')) { + return $this->writeAtomically($storage, $relativeName, $content, cache: false); + } + + // 프로덕션: 동일 version 캐시가 있으면 그대로 사용 + if ($storage->exists('', $relativeName)) { + return $storage->getBasePath('').'/'.$relativeName; + } + + return $this->writeAtomically($storage, $relativeName, $content, cache: true); + } + + /** + * 현재 version 외의 오래된 번들 파일을 삭제하고 삭제 건수를 반환합니다. + * + * @param int $currentVersion 보존할 현재 캐시 버전 + * @return int 삭제된 파일 수 + */ + public function cleanupStaleBundles(int $currentVersion): int + { + $storage = $this->bundleStorage(); + $deleted = 0; + + foreach ($storage->files('', '') as $file) { + $name = basename($file); + + // 현재 version 파일과 .gitignore 는 보존 + if ($name === '.gitignore' || $this->matchesVersion($name, $currentVersion)) { + continue; + } + + if ($this->isBundleFile($name) && $storage->delete('', $name)) { + $deleted++; + } + } + + return $deleted; + } + + /** + * 번들 캐시 파일을 삭제합니다(cache-clear 커맨드용). + * + * @param string|null $type 'module' | 'plugin' 지정 시 해당 타입만, null 이면 전체 + * @return int 삭제된 파일 수 + */ + public function clearBundles(?string $type = null): int + { + $storage = $this->bundleStorage(); + $deleted = 0; + + foreach ($storage->files('', '') as $file) { + $name = basename($file); + + if ($name === '.gitignore' || ! $this->isBundleFile($name)) { + continue; + } + + // 타입 필터 (파일명 접두사 `{type}.`) + if ($type !== null && ! str_starts_with($name, $type.'.')) { + continue; + } + + if ($storage->delete('', $name)) { + $deleted++; + } + } + + return $deleted; + } + + /** + * 번들 파일명을 생성합니다(`{type}.{version}.{kind}`). + * + * @param string $type 'module' | 'plugin' + * @param string $kind 'js' | 'css' + * @param int $version 캐시 버전 + * @return string 파일명 (디렉토리 제외) + */ + private function bundleFileName(string $type, string $kind, int $version): string + { + return "{$type}.{$version}.{$kind}"; + } + + /** + * 파일명이 번들 파일 패턴(`{type}.{version}.{kind}`)인지 확인합니다. + * + * @param string $name 파일명 + * @return bool 번들 파일이면 true + */ + private function isBundleFile(string $name): bool + { + return (bool) preg_match('/^(module|plugin)\.\d+\.(js|css)$/', $name); + } + + /** + * 파일명이 지정한 version 의 번들인지 확인합니다. + * + * @param string $name 파일명 + * @param int $version 비교할 버전 + * @return bool 해당 version 파일이면 true + */ + private function matchesVersion(string $name, int $version): bool + { + return (bool) preg_match('/^(module|plugin)\.'.preg_quote((string) $version, '/').'\.(js|css)$/', $name); + } + + /** + * 병합 결과를 원자적으로(임시 파일 → rename) 기록하고 절대 경로를 반환합니다. + * + * @param CoreStorageDriver $storage 번들 디스크 스토리지 + * @param string $relativeName 대상 파일명 + * @param string $content 기록할 내용 + * @param bool $cache true 면 version 파일명 유지, false 면 임시 파일 사용 + * @return string 기록된 파일의 절대 경로 + */ + private function writeAtomically(CoreStorageDriver $storage, string $relativeName, string $content, bool $cache): string + { + $basePath = $storage->getBasePath(''); + + if (! is_dir($basePath)) { + @mkdir($basePath, 0o755, true); + } + + $finalPath = $basePath.'/'.$relativeName; + + if (! $cache) { + // 비프로덕션: 매 요청 덮어써도 무방(원자성 불요), 그대로 write + $storage->put('', $relativeName, $content); + + return $finalPath; + } + + // 프로덕션: 임시 파일에 쓴 뒤 rename 으로 원자적 게시(부분 파일 서빙 방지) + $tmpName = $relativeName.'.tmp.'.getmypid(); + $storage->put('', $tmpName, $content); + + $tmpPath = $basePath.'/'.$tmpName; + + if (! @rename($tmpPath, $finalPath)) { + // rename 실패 시(경합으로 이미 존재 등) 임시 파일 정리 후 최종 경로 사용 + $storage->delete('', $tmpName); + } + + return $finalPath; + } + + /** + * IIFE 소스맵 주석을 환경에 맞게 처리합니다. + * + * prod: `//# sourceMappingURL` 라인 strip(맵 생략). + * dev: 개별 에셋 서빙 절대 URL(`/api/{type}s/assets/{id}/dist/js/*.map`)로 + * rewrite → 브라우저가 확장별 원본 맵을 추적(완벽한 통합 맵은 아님). + * + * @param string $content 원본 IIFE 내용 + * @param string $type 'module' | 'plugin' + * @param string $identifier 확장 식별자 + * @param bool $isProduction 프로덕션 여부 + * @return string 처리된 내용 + */ + private function processJsSourceMap(string $content, string $type, string $identifier, bool $isProduction): string + { + // 구분자로 `~` 사용 — 패턴 자체에 `#`(`//#`)가 포함되어 `#` 구분자는 못 씀 + $pattern = '~//# sourceMappingURL=(\S+)~'; + + if ($isProduction) { + // prod: 맵 참조 제거 + return preg_replace($pattern, '', $content) ?? $content; + } + + // dev: 상대 맵 파일명을 개별 에셋 서빙 절대 URL 로 rewrite + $typeSegment = $type === 'plugin' ? 'plugins' : 'modules'; + + return preg_replace_callback($pattern, function (array $m) use ($typeSegment, $identifier) { + $mapFile = ltrim($m[1], './'); + + return '//# sourceMappingURL=/api/'.$typeSegment.'/assets/'.$identifier.'/dist/js/'.basename($mapFile); + }, $content) ?? $content; + } + + /** + * CSS 내용에 상대경로 url() 참조가 있는지 확인합니다. + * + * 절대 URL(http/https), 루트 절대경로(/), data URI 는 병합에 안전하므로 + * 그 외의 url() 참조만 상대경로로 간주한다. + * + * @param string $css CSS 내용 + * @return bool 상대경로 url() 이 하나라도 있으면 true + */ + private function hasRelativeUrl(string $css): bool + { + if (! preg_match_all('/url\(\s*[\'"]?([^\'")]+)[\'"]?\s*\)/i', $css, $matches)) { + return false; + } + + foreach ($matches[1] as $url) { + $url = trim($url); + + if ($url === '') { + continue; + } + + $isAbsolute = str_starts_with($url, 'http://') + || str_starts_with($url, 'https://') + || str_starts_with($url, '//') + || str_starts_with($url, '/') + || str_starts_with($url, 'data:'); + + if (! $isAbsolute) { + return true; + } + } + + return false; + } + + /** + * 번들 디스크용 스토리지 드라이버를 반환합니다(StorageInterface 경유). + * + * @return CoreStorageDriver ext-bundles 디스크 스토리지 + */ + private function bundleStorage(): CoreStorageDriver + { + return (new CoreStorageDriver)->withDisk(self::BUNDLE_DISK); + } + + /** + * 현재 확장 캐시 버전을 반환합니다. + * + * @return int 캐시 버전 + */ + public function getCurrentVersion(): int + { + return self::getExtensionCacheVersion(); + } +} diff --git a/app/Services/LayoutService.php b/app/Services/LayoutService.php index 71057529..0e5fe794 100644 --- a/app/Services/LayoutService.php +++ b/app/Services/LayoutService.php @@ -807,6 +807,12 @@ class LayoutService // 캐시 비활성 시 매번 병합 실행 if (! $cacheEnabled) { $merged = $this->loadAndMergeLayoutInternal($templateId, $layoutName, $withSourceMeta); + + // 공개 서빙 응답에서 개발자용 comment 필드 제거 (편집 모드는 보존) + if (! $withSourceMeta) { + $merged = $this->stripDeveloperComments($merged); + } + HookManager::doAction('core.layout.after_load', $merged, $templateId, $layoutName, false); return $merged; @@ -844,6 +850,12 @@ class LayoutService // 병합된 레이아웃 생성 $mergedLayout = $this->loadAndMergeLayoutInternal($templateId, $layoutName, $withSourceMeta); + // 공개 서빙 응답에서 개발자용 comment 필드 제거 (편집 모드는 보존). + // withSourceMeta 가 캐시 키에 반영되므로 공개/편집 캐시가 분리되어 안전. + if (! $withSourceMeta) { + $mergedLayout = $this->stripDeveloperComments($mergedLayout); + } + // 캐시에 저장 $cacheTtl = $this->getCacheTtl(); $this->cache->put($cacheKey, $mergedLayout, $cacheTtl); @@ -1601,6 +1613,30 @@ class LayoutService }, $components); } + /** + * 병합된 레이아웃에서 개발자용 comment 필드를 재귀적으로 제거합니다. + * + * 레이아웃 JSON 의 `comment` / `_comment` 키는 편집기(layout-editor)와 개발자를 위한 + * 설명 주석으로, 프론트엔드 런타임 렌더러(DynamicRenderer)는 이를 참조하지 않는다. + * 공개 서빙 응답에서만 제거하여 전송 크기를 줄이며, 편집 모드(withSourceMeta)에서는 + * 호출하지 않아 보존한다. 배열/객체 노드를 재귀 순회하며 두 키만 unset 한다. + * + * @param array $node 정리 대상 레이아웃(또는 하위) 배열 + * @return array comment 필드가 제거된 배열 + */ + private function stripDeveloperComments(array $node): array + { + unset($node['comment'], $node['_comment']); + + foreach ($node as $key => $value) { + if (is_array($value)) { + $node[$key] = $this->stripDeveloperComments($value); + } + } + + return $node; + } + /** * 컴포넌트의 props를 sanitize합니다. * diff --git a/config/app.php b/config/app.php index 536b5173..a7d6823b 100644 --- a/config/app.php +++ b/config/app.php @@ -231,7 +231,7 @@ return [ | */ - 'version' => env('APP_VERSION', '7.0.1'), + 'version' => env('APP_VERSION', '7.0.2'), /* |-------------------------------------------------------------------------- @@ -270,7 +270,7 @@ return [ 'github_url' => env('G7_UPDATE_GITHUB_URL', 'https://github.com/gnuboard/g7'), 'github_token' => env('G7_UPDATE_GITHUB_TOKEN', ''), 'pending_path' => env('G7_UPDATE_PENDING_PATH') ?: storage_path('app/core_pending'), - 'targets' => array_filter(array_map('trim', explode(',', env('G7_UPDATE_TARGETS', 'app,bootstrap,config,database,docs,lang,lang-packs/_bundled,resources,routes,public,tests,upgrades,artisan,composer.json,composer.json.default,composer.lock,package.json,package-lock.json,vite.config.js,vite.config.core.js,vitest.config.ts,playwright.config.ts,tsconfig.json,phpunit.xml,.editorconfig,.gitattributes,.gitignore,README.md,CHANGELOG.md,modules/_bundled,plugins/_bundled,templates/_bundled')))), + 'targets' => array_filter(array_map('trim', explode(',', env('G7_UPDATE_TARGETS', 'app,bootstrap,config,database,docs,lang,lang-packs/_bundled,resources,routes,public,tests,upgrades,artisan,composer.json,composer.json.default,composer.lock,package.json,package-lock.json,vite.config.js,vite.config.core.js,vite.config.editor.js,vite.config.devtools.js,vitest.config.ts,playwright.config.ts,tsconfig.json,phpunit.xml,.editorconfig,.gitattributes,.gitignore,README.md,CHANGELOG.md,modules/_bundled,plugins/_bundled,templates/_bundled')))), 'excludes' => array_filter(array_map('trim', explode(',', env('G7_UPDATE_EXCLUDES', 'node_modules,.git,bootstrap/cache')))), // applyUpdate 의 "신규 최상위 항목 자동 발견" 폴백이 절대 덮어쓰면 안 되는 경로 목록. // 런타임 데이터(`storage`), 로컬 환경(`.env*`), 별도 파이프라인 산출물(`vendor`), diff --git a/config/database.php b/config/database.php index da01b564..05fcc509 100644 --- a/config/database.php +++ b/config/database.php @@ -45,14 +45,20 @@ return [ 'mysql' => [ 'driver' => 'mysql', + // Read 커넥션 — DB_READ_* 가 비어 있으면(미설정/빈 값/주석) 대응하는 + // DB_WRITE_* 로 fallback 한다. Read DB 미사용 환경에서도 SELECT 가 write DB 로 + // 정확히 향하도록 보장한다. (이슈 #63) + // 중첩 env(A, env(B)) 대신 Elvis(?:) 를 쓰는 이유: env('DB_READ_HOST') 가 + // 빈 문자열('')을 반환하면 두 번째 인자(default)가 적용되지 않아 fallback 이 + // 무력화된다. ?: 는 빈 문자열까지 falsy 로 흡수하여 write 로 넘긴다. 'read' => [ 'host' => [ - env('DB_READ_HOST', '127.0.0.1'), + env('DB_READ_HOST') ?: env('DB_WRITE_HOST', '127.0.0.1'), ], - 'port' => env('DB_READ_PORT', '3306'), - 'database' => env('DB_READ_DATABASE', 'laravel'), - 'username' => env('DB_READ_USERNAME', 'root'), - 'password' => env('DB_READ_PASSWORD', ''), + 'port' => env('DB_READ_PORT') ?: env('DB_WRITE_PORT', '3306'), + 'database' => env('DB_READ_DATABASE') ?: env('DB_WRITE_DATABASE', 'laravel'), + 'username' => env('DB_READ_USERNAME') ?: env('DB_WRITE_USERNAME', 'root'), + 'password' => env('DB_READ_PASSWORD') ?: env('DB_WRITE_PASSWORD', ''), ], 'write' => [ 'host' => [ diff --git a/config/filesystems.php b/config/filesystems.php index ede7cb8e..56165197 100644 --- a/config/filesystems.php +++ b/config/filesystems.php @@ -74,6 +74,16 @@ return [ 'report' => false, ], + // 확장(모듈/플러그인) 프론트엔드 IIFE/CSS 번들 병합 결과 캐시. + // ExtensionBundleService 가 version-in-path 파일명으로 저장/서빙한다. + 'ext-bundles' => [ + 'driver' => 'local', + 'root' => storage_path('app/ext-bundles'), + 'serve' => false, + 'throw' => true, + 'report' => false, + ], + 'public' => [ 'driver' => 'local', 'root' => storage_path('app/public'), diff --git a/docs/backend/core-update-system.md b/docs/backend/core-update-system.md index 947f195b..7f663cc8 100644 --- a/docs/backend/core-update-system.md +++ b/docs/backend/core-update-system.md @@ -111,7 +111,8 @@ ├─ Step 4: 다운로드 (GitHub zipball 또는 --source/--local에서 복사) ├─ Step 5: 백업 생성 (--no-backup 시 스킵) ├─ Step 6: Composer install (_pending에서 실행, 변경 없으면 스킵) -├─ Step 7: 파일 적용 (_pending → base_path 선택적 덮어쓰기) +├─ Step 6.5: 신규 파일 manifest 생성 + 증분 적용 대상(3-way) 산출 (백업 있을 때) +├─ Step 7: 파일 적용 (_pending → base_path, 기본=코어 변경분만 / --prune=전체 덮어쓰기) ├─ Step 8: vendor 복사 (_pending/vendor → base_path/vendor, Step 6 스킵 시 함께 스킵) ├─ Step 9: 마이그레이션 + 동기화 (migrate, roles, permissions, menus, mail templates) ├─ Step 10: 업그레이드 스텝 실행 (upgrades/Upgrade_X_Y_Z.php) @@ -178,16 +179,46 @@ v접두사 자동 감지 (resolveGithubArchiveUrl): > Vendor 번들 시스템 상세: [docs/extension/vendor-bundle.md](../extension/vendor-bundle.md) +### Step 6.5: 신규 파일 manifest + 증분 적용 대상 산출 + +```text +백업이 있을 때(--no-backup 아님)만 수행: + +1. writeNewFilesManifest() — 자동 롤백용 `_new_files_manifest.json` 기록 + (base=백업 vs theirs=_pending: 신 버전이 추가한 파일/디렉토리 목록) + +2. computeApplyList() — 기본(증분) 모드의 3-way 적용 대상 산출 (--prune 시 스킵) + · base = 구버전 원본 = 백업 스냅샷 + · theirs = 신 버전 = _pending + · base 없음 → added / size·md5 다름 → changed / 동일 → 제외(스킵) + · size 선필터 후 size 동일할 때만 md5 (mtime 비교 안 함 — _pending 은 추출 시각) + · symlink / excludes / protected_paths 하위 → 목록 제외 +``` + ### Step 7: 파일 적용 ```text -- _pending 소스에서 config('app.update.targets') 에 해당하는 파일/디렉토리 선택적 덮어쓰기 +기본(증분) 모드 — --prune 미지정 + 백업 있음: +- Step 6.5 의 applyList(코어가 실제 변경/추가한 파일)에 있는 파일만 적용 +- 코어가 건드리지 않은 파일은 복사·chmod·chown·mtime 갱신을 전부 스킵 → 현재 디스크 + 상태(사용자 수정 포함 가능)를 그대로 보존 +- orphan(소스에 없는 대상 파일) 삭제 안 함 → 사용자가 추가한 신규 파일 보존 + +--prune 모드 (또는 백업 부재 fallback): +- targets 전체 무조건 덮어쓰기 + orphan 삭제 (기존 동작) +- 백업 부재 시 base 가 없어 3-way 불가 → 안전하게 전체 덮어쓰기로 회귀 + 안내 출력 + +공통: - 자동 발견 폴백: targets 에 미등재된 source 최상위 항목도 스캔하여 적용 (config('app.update.protected_paths') 와 config('app.update.excludes') 매치 시 스킵) - FilePermissionHelper::copyDirectory() 사용 → 원본 파일 권한 보존 - ExtensionPendingHelper::copyToActive() 미사용 (권한 유실 방지) ``` +> **기본 동작 변경 배경 (공개 #64)**: 이전에는 Step 7 이 targets 전체를 무조건 재복사하고 orphan 을 삭제하여, 사용자가 수정한 `public/.htaccess` 커스텀 블록이나 `_bundled/` 아래 커스텀 확장이 소실되는 사고가 반복 제보되었다. 기본 동작을 "코어가 실제로 변경/추가한 파일만 적용(3-way)"으로 전환해 발생 표면을 제거했다. 전체 덮어쓰기 + 정리를 원하면 `--prune` 을 지정한다. "코어도 바꾸고 사용자도 바꾼" 파일은 코어 버전으로 갱신되지만 백업에 원본이 보존되어 복구 가능하다. + +> **증분 모드 잔존 stale 파일 정리**: 기본(증분) 모드는 orphan 을 삭제하지 않으므로, 신 버전에서 제거된 파일이 활성 디렉토리에 잔존할 수 있다. 완료 요약이 잔존을 안내하며, 정리하려면 다음 업데이트를 `--prune` 으로 실행하거나 단발성 정리 도구 `php artisan hotfix:rollback-stale-files --prune` 을 사용한다 (진단 모드 기본, `--prune` 시 확인 프롬프트 후 정리, symlink/protected_paths 가드 적용). 상세 사용법: [docs/cheatsheet.md](../cheatsheet.md) "단발성 결함 보정 (hotfix)". + > **자동 발견 폴백의 배경 (engine-v / beta.4 이후)**: Step 7 은 부모 프로세스의 `config('app.update.targets')` 를 사용한다. 부모는 업그레이드 *직전* 의 코드/메모리 상태이므로 신버전이 도입한 신규 최상위 디렉토리(예: beta.4 의 `lang-packs/`) 가 부모의 stale targets 에서 누락된다. 폴백은 이 결함을 안전망으로 차단하며, `config/app.php` 의 `update.protected_paths` 가 런타임 데이터(`storage`)·로컬 환경(`.env*`)·별도 파이프라인 산출물(`vendor`)·개발 메타(`.git`/`.claude`/`.serena` 등) 의 의도치 않은 덮어쓰기를 방지한다. ### Step 9: 마이그레이션 + 동기화 @@ -631,12 +662,13 @@ config('app.version') = env('APP_VERSION', 'config/app.php 기본값') |--------|---------|------| | `createBackup()` | `(?Closure $onProgress): string` | CoreBackupHelper로 백업 생성 | | `restoreFromBackup()` | `(string $backupPath, ?Closure $onProgress): void` | 백업에서 파일 복원 | +| `CoreBackupHelper::computeApplyList()` | `(string $backupPath, string $sourcePath, array $targets, array $protectedPaths, array $excludes): array` | 3-way 판정으로 증분 적용 대상(added/changed) 산출 (`apply`, `added_count`, `changed_count`, `has_symlink`) | ### 적용 및 설치 | 메서드 | 시그니처 | 설명 | |--------|---------|------| -| `applyUpdate()` | `(string $sourcePath, ?Closure $onProgress): void` | _pending → base_path 선택적 덮어쓰기 | +| `applyUpdate()` | `(string $sourcePath, ?Closure $onProgress, bool $prune = false, ?array $applyList = null): void` | _pending → base_path 적용. `$applyList` 지정 + `!$prune` 이면 증분(코어 변경분만), 그 외 전체 덮어쓰기 + orphan 삭제 | | `runComposerInstallInPending()` | `(string $pendingPath, ?Closure $onProgress): void` | _pending에서 composer install (--no-scripts) | | `isComposerUnchangedForCore()` | `(string $pendingPath): bool` | composer.json/lock MD5 비교 | | `runComposerInstall()` | `(?Closure $onProgress): void` | base_path에서 composer install | @@ -678,13 +710,14 @@ config('app.version') = env('APP_VERSION', 'config/app.php 기본값') ### core:update ```bash -php artisan core:update [--force] [--no-backup] [--no-maintenance] [--local] [--source={path}] +php artisan core:update [--force] [--no-backup] [--prune] [--no-maintenance] [--local] [--source={path}] ``` | 옵션 | 설명 | |------|------| | `--force` | 버전 비교 스킵, 동일 버전이어도 강제 업데이트 | -| `--no-backup` | 백업 생성 스킵 (Step 5) | +| `--no-backup` | 백업 생성 스킵 (Step 5). 증분 적용 불가 → 전체 덮어쓰기로 회귀 | +| `--prune` | 코어가 제거한 파일 정리 + targets 전체 덮어쓰기(기존 방식). 미지정 시 코어가 실제 변경/추가한 파일만 적용(3-way)하고 나머지는 보존 | | `--no-maintenance` | 유지보수 모드 스킵 (Step 3) | | `--local` | 현재 코드베이스를 소스로 사용 (GitHub 스킵) | | `--source={path}` | 지정 디렉토리를 소스로 사용 (GitHub 스킵) | diff --git a/docs/backend/response-helper.md b/docs/backend/response-helper.md index fcc8d259..76a92414 100644 --- a/docs/backend/response-helper.md +++ b/docs/backend/response-helper.md @@ -587,6 +587,27 @@ class PublicLayoutController extends PublicBaseController --- +## JSON 인코딩 옵션 (JSON_UNESCAPED_UNICODE) + +모든 `response()->json()` 호출은 `ResponseHelper::JSON_ENCODE_OPTIONS`(= `JSON_UNESCAPED_UNICODE`)를 인코딩 옵션으로 전달한다. 한글 등 멀티바이트 문자를 `\uXXXX`(6바이트)로 이스케이프하지 않고 raw UTF-8(한글 3바이트)로 직렬화하여 응답 전송 크기를 줄인다. 다국어 팩(lang) 응답처럼 한글 비중이 큰 페이로드에서 절감 효과가 크다. + +```php +// ✅ 올바른 사용 — 네 번째 인자로 옵션 전달 +return response()->json($payload, $status, [], ResponseHelper::JSON_ENCODE_OPTIONS); + +// 헤더 배열이 필요한 경우 (세 번째 인자) +return response()->json($payload, $status, ['Cache-Control' => '...'], ResponseHelper::JSON_ENCODE_OPTIONS); + +// ❌ 옵션 누락 — 한글이 \uXXXX 로 팽창 +return response()->json($payload, $status); +``` + +`ResponseHelper` 의 모든 메서드(`success`/`error`/`validationError`/… )와 `BaseApiController::successWithCache`/`cachedJsonResponse` 는 이미 이 옵션을 적용한다. 컨트롤러/서비스는 `ResponseHelper` 를 사용하면 자동으로 적용되므로 별도 조치가 불필요하다. `response()->json()` 을 직접 호출하는 신규 코드에서만 옵션 전달을 잊지 않는다. + +> 슬래시 언이스케이프(`JSON_UNESCAPED_SLASHES`)는 적용하지 않는다 — endpoint 경로의 `\/` 는 크기 영향이 미미하고, 기존 응답 본문 정확 매칭 테스트의 안전성을 우선한다. + +--- + ## 관련 문서 - [index.md](index.md) - 백엔드 가이드 인덱스 diff --git a/docs/cheatsheet.md b/docs/cheatsheet.md index 08d14bb6..621254f3 100644 --- a/docs/cheatsheet.md +++ b/docs/cheatsheet.md @@ -27,6 +27,8 @@ _bundled에서 TSX/TS 파일 수정한 경우 → 빌드 후 확장 업데이 | `modules/**/resources/js/**/*.ts` (핸들러) | `module:build` + `module:update {id} --force` | | `templates/**/src/**/*.tsx` (컴포넌트) | `template:build` + `template:update {id} --force` | +> **확장 프론트엔드 번들**: 활성 모듈/플러그인 IIFE 는 서버측에서 종류별 1개 번들로 병합 서빙된다(`/api/{modules,plugins}/bundle.{js,css}`). `{type}:update` 후 확장 캐시 버전이 bump 되면 번들이 자동 재생성된다(prod 캐시, dev 매 요청 concat). 구버전 번들 파일은 `ext-bundles:cleanup` 또는 `{type}:cache-clear` 로 정리. 상세: [module-assets.md](extension/module-assets.md#서버측-번들-병합). + --- ## 확장 업데이트 (_bundled → 활성 반영) diff --git a/docs/extension/module-assets.md b/docs/extension/module-assets.md index 0bc197e1..ef51b35c 100644 --- a/docs/extension/module-assets.md +++ b/docs/extension/module-assets.md @@ -381,6 +381,72 @@ GET /api/modules/assets/{identifier}/{path} --- +## 서버측 번들 병합 (Server-side Bundle) + +활성 모듈/플러그인이 늘어날수록 개별 IIFE JS/CSS 요청이 선형 증가한다. 이를 줄이기 위해 코어는 타입별(모듈/플러그인)로 활성 `global` 에셋을 서버에서 하나의 번들로 병합해 서빙한다. 각 확장 IIFE 는 자체 클로저에서 자가등록(레지스트리 + 핸들러/리스너)을 수행하므로, priority 순으로 이어붙여 단일 `'; echo ''; echo ''; @@ -537,7 +537,7 @@ function showAlertAndRedirect(string $title, string $message, string $redirectUr /** * 단계 파일을 찾을 수 없을 때 에러 페이지를 표시합니다. * - * @param int $currentStep 현재 단계 번호 + * @param int $currentStep 현재 단계 번호 */ function showStepFileNotFoundError(int $currentStep): void { @@ -553,9 +553,9 @@ function showStepFileNotFoundError(int $currentStep): void echo ''; echo lang('error'); echo ''; - echo '

' . lang('error_step_file_not_found') . '

'; + echo '

'.lang('error_step_file_not_found').'

'; echo '
'; - echo '← ' . lang('previous') . ''; + echo '← '.lang('previous').''; echo '
'; echo ''; } @@ -565,8 +565,8 @@ function showStepFileNotFoundError(int $currentStep): void * * DB 연결 정보가 변경되었는지 감지하기 위해 사용됩니다. * - * @param array $config 폼 데이터 배열 - * @param string $prefix DB 접두사 ('db_write' 또는 'db_read') + * @param array $config 폼 데이터 배열 + * @param string $prefix DB 접두사 ('db_write' 또는 'db_read') * @return string MD5 해시값 */ function getDatabaseFieldHash(array $config, string $prefix): string @@ -575,14 +575,14 @@ function getDatabaseFieldHash(array $config, string $prefix): string $config["{$prefix}_host"] ?? '', $config["{$prefix}_port"] ?? '', $config["{$prefix}_database"] ?? '', - $config["{$prefix}_username"] ?? '' + $config["{$prefix}_username"] ?? '', ])); } /** * SVG 아이콘을 반환합니다. * - * @param string $type 아이콘 타입 ('success', 'warning', 'error') + * @param string $type 아이콘 타입 ('success', 'warning', 'error') * @return string SVG HTML */ function getSvgIcon(string $type): string @@ -609,12 +609,12 @@ function getSvgIcon(string $type): string /** * 설치 결과 섹션 HTML을 렌더링합니다. * - * @param string $sectionId 섹션 ID ('completion', 'aborted', 'failure') - * @param string $iconType 아이콘 타입 ('success', 'warning', 'error') - * @param string $titleKey 제목 번역 키 - * @param string $messageKey 메시지 번역 키 (failure인 경우 동적) - * @param string $buttonsHtml 버튼 HTML - * @param string $extraHtml 메시지 하단에 추가로 렌더링할 HTML (이미 escape 된 상태로 전달) + * @param string $sectionId 섹션 ID ('completion', 'aborted', 'failure') + * @param string $iconType 아이콘 타입 ('success', 'warning', 'error') + * @param string $titleKey 제목 번역 키 + * @param string $messageKey 메시지 번역 키 (failure인 경우 동적) + * @param string $buttonsHtml 버튼 HTML + * @param string $extraHtml 메시지 하단에 추가로 렌더링할 HTML (이미 escape 된 상태로 전달) * @return string 결과 섹션 HTML */ function renderInstallResultSection(string $sectionId, string $iconType, string $titleKey, string $messageKey, string $buttonsHtml, string $extraHtml = ''): string @@ -625,7 +625,7 @@ function renderInstallResultSection(string $sectionId, string $iconType, string // failure는 동적 메시지이므로 번역하지 않음 $message = $sectionId === 'failure' ? '
' - : '

' . htmlspecialchars(lang($messageKey)) . '

'; + : '

'.htmlspecialchars(lang($messageKey)).'

'; return << @@ -657,8 +657,8 @@ function renderInstallResultSection(string $sectionId, string $iconType, string function getCoreAppVersion(): string { foreach (['/.env', '/.env.example'] as $relative) { - $path = BASE_PATH . $relative; - if (!is_readable($path)) { + $path = BASE_PATH.$relative; + if (! is_readable($path)) { continue; } $content = @file_get_contents($path); @@ -676,8 +676,8 @@ function getCoreAppVersion(): string /** * Progress indicator HTML을 렌더링합니다. * - * @param int $currentStep 현재 단계 번호 - * @param int $totalSteps 전체 단계 수 (기본값: 7, Step 0~6) + * @param int $currentStep 현재 단계 번호 + * @param int $totalSteps 전체 단계 수 (기본값: 7, Step 0~6) * @return string Progress indicator HTML */ function renderProgressIndicator(int $currentStep, int $totalSteps = 7): string @@ -690,9 +690,10 @@ function renderProgressIndicator(int $currentStep, int $totalSteps = 7): string } elseif ($i === $currentStep) { $class .= ' active'; } - $html .= '
'; + $html .= '
'; } $html .= ''; + return $html; } @@ -709,7 +710,7 @@ function getWebServerUser(): ?string // 1. posix 확장 (가장 신뢰도 높음) if (function_exists('posix_geteuid') && function_exists('posix_getpwuid')) { $info = posix_getpwuid(posix_geteuid()); - if ($info && !empty($info['name'])) { + if ($info && ! empty($info['name'])) { return $info['name']; } } @@ -717,14 +718,14 @@ function getWebServerUser(): ?string // 2. exec('whoami') if (function_exists('exec')) { $user = @exec('whoami'); - if (!empty($user)) { + if (! empty($user)) { return trim($user); } } // 3. 환경변수 $envUser = getenv('USER') ?: getenv('APACHE_RUN_USER') ?: null; - if (!empty($envUser)) { + if (! empty($envUser)) { return $envUser; } @@ -740,13 +741,13 @@ function getWebServerGroup(): ?string { if (function_exists('posix_getegid') && function_exists('posix_getgrgid')) { $info = posix_getgrgid(posix_getegid()); - if ($info && !empty($info['name'])) { + if ($info && ! empty($info['name'])) { return $info['name']; } } $envGroup = getenv('APACHE_RUN_GROUP') ?: null; - if (!empty($envGroup)) { + if (! empty($envGroup)) { return $envGroup; } @@ -758,7 +759,7 @@ function getWebServerGroup(): ?string * * posix 확장이 없거나 확인할 수 없는 경우 null을 반환합니다. * - * @param string $path 파일/디렉토리 경로 + * @param string $path 파일/디렉토리 경로 * @return string|null 소유자 이름 또는 null */ function getFileOwnerName(string $path): ?string @@ -770,7 +771,7 @@ function getFileOwnerName(string $path): ?string if (function_exists('posix_getpwuid')) { $info = @posix_getpwuid($uid); - if ($info && !empty($info['name'])) { + if ($info && ! empty($info['name'])) { return $info['name']; } } @@ -784,7 +785,7 @@ function getFileOwnerName(string $path): ?string * * posix 확장이 없거나 확인할 수 없는 경우 null을 반환합니다. * - * @param string $path 파일/디렉토리 경로 + * @param string $path 파일/디렉토리 경로 * @return string|null 그룹 이름 또는 null */ function getFileGroupName(string $path): ?string @@ -796,7 +797,7 @@ function getFileGroupName(string $path): ?string if (function_exists('posix_getgrgid')) { $info = @posix_getgrgid($gid); - if ($info && !empty($info['name'])) { + if ($info && ! empty($info['name'])) { return $info['name']; } } @@ -817,7 +818,7 @@ function getChownTarget(): string $user = getWebServerUser() ?? 'www-data'; $group = getWebServerGroup() ?? $user; - return $user . ':' . $group; + return $user.':'.$group; } /** @@ -826,7 +827,7 @@ function getChownTarget(): string * Step 0과 Step 2에서 재사용 가능한 공통 함수입니다. * 디렉토리를 생성하지 않고 존재 여부와 권한만 체크합니다. * - * @param array $directories 체크할 디렉토리 경로 배열 (키: 경로, 값: 재귀 체크 여부) + * @param array $directories 체크할 디렉토리 경로 배열 (키: 경로, 값: 재귀 체크 여부) * @return array{all_passed: bool, results: array}>} */ function checkDirectoryPermissions(array $directories): array @@ -842,7 +843,7 @@ function checkDirectoryPermissions(array $directories): array $webServerUser = getWebServerUser(); foreach ($directories as $path => $checkRecursive) { - $fullPath = BASE_PATH . '/' . $path; + $fullPath = BASE_PATH.'/'.$path; // 디렉토리 존재 여부 확인 (생성하지 않음) $exists = is_dir($fullPath); @@ -883,22 +884,22 @@ function checkDirectoryPermissions(array $directories): array $parentPassed = $writable && $readable; // 최종 통과 여부: 상위 + 하위 모두 통과해야 함 - $passed = $parentPassed && !$hasSubdirectoryIssues; + $passed = $parentPassed && ! $hasSubdirectoryIssues; // 에러 타입 구분 // ownership_mismatch: 권한 비트는 0755 이상이지만 소유자가 웹서버 사용자와 달라 // 실제 쓰기 불가 (전통적 Apache: 파일 소유자 != www-data) $errorType = null; - if (!$exists) { + if (! $exists) { $errorType = 'not_exists'; - } elseif (!$writable) { + } elseif (! $writable) { // 권한 비트가 충분(0755+)한데도 쓰기 불가 → 소유권 불일치 가능성 if ($permsOctal >= 0755 && $webServerUser && $owner && $owner !== $webServerUser) { $errorType = 'ownership_mismatch'; } else { $errorType = 'not_writable'; } - } elseif (!$readable) { + } elseif (! $readable) { $errorType = 'not_readable'; } elseif ($hasSubdirectoryIssues) { // 상위는 OK, 하위 디렉토리만 문제 @@ -920,7 +921,7 @@ function checkDirectoryPermissions(array $directories): array 'failed_subdirectories' => $failedSubdirectories, ]; - if (!$passed) { + if (! $passed) { $allPassed = false; } } @@ -934,14 +935,22 @@ function checkDirectoryPermissions(array $directories): array /** * 디렉토리의 하위를 재귀적으로 체크하여 권한이 없는 경로와 권한 정보 반환 * - * @param string $path 체크할 디렉토리 경로 + * 깊이 제한(maxDepth)을 둔다 (dev-g7#445 후속): storage 처럼 하위에 수만 개 + * 디렉토리가 누적되는 경로(예: storage/framework/testing/)를 무한 재귀로 순회하면 + * 인스톨러 2단계(요구사항 검증) 응답이 수 초 이상 지연된다. 쓰기 권한 문제는 트리 + * 상위 얕은 깊이에서 결정되므로(상위가 쓰기 가능하면 하위도 통상 상속), 제한 깊이까지만 + * 검사해 성능과 안내 유효성을 모두 확보한다. + * + * @param string $path 체크할 디렉토리 경로 + * @param int $maxDepth 재귀 최대 깊이 (0 = 현재 디렉토리의 직속 하위만). 기본 1 + * @param int $currentDepth 내부 재귀용 현재 깊이 (호출자는 지정하지 않음) * @return array 권한이 없는 하위 디렉토리 정보 배열 */ -function checkSubdirectoriesRecursive(string $path): array +function checkSubdirectoriesRecursive(string $path, int $maxDepth = 1, int $currentDepth = 0): array { $failedPaths = []; - if (!is_dir($path)) { + if (! is_dir($path)) { return $failedPaths; } @@ -962,21 +971,21 @@ function checkSubdirectoriesRecursive(string $path): array continue; } - $itemPath = $path . DIRECTORY_SEPARATOR . $item; + $itemPath = $path.DIRECTORY_SEPARATOR.$item; // 디렉토리인지 확인 (심볼릭 링크 제외) - if (!is_dir($itemPath) || is_link($itemPath)) { + if (! is_dir($itemPath) || is_link($itemPath)) { continue; } // 절대 경로를 상대 경로로 변환 - $relativePath = str_replace(BASE_PATH . '/', '', $itemPath); + $relativePath = str_replace(BASE_PATH.'/', '', $itemPath); $relativePath = str_replace('\\', '/', $relativePath); // 쓰기 권한 체크 $isWritable = is_writable($itemPath); - if (!$isWritable) { + if (! $isWritable) { // 권한 코드 가져오기 $perms = fileperms($itemPath); $permissions = substr(sprintf('%o', $perms), -3); @@ -988,11 +997,15 @@ function checkSubdirectoriesRecursive(string $path): array } // 재귀적으로 하위 디렉토리 체크 (권한 없어도 계속 진행) - try { - $subFailed = checkSubdirectoriesRecursive($itemPath); - $failedPaths = array_merge($failedPaths, $subFailed); - } catch (Exception $e) { - // 하위 디렉토리 체크 실패해도 계속 진행 + // 깊이 제한 도달 시 더 내려가지 않는다 — storage/framework/testing 등에 누적된 + // 수만 개 하위 디렉토리를 순회해 인스톨러 2단계가 지연되던 문제 차단 (dev-g7#445 후속). + if ($currentDepth < $maxDepth) { + try { + $subFailed = checkSubdirectoriesRecursive($itemPath, $maxDepth, $currentDepth + 1); + $failedPaths = array_merge($failedPaths, $subFailed); + } catch (Exception $e) { + // 하위 디렉토리 체크 실패해도 계속 진행 + } } } @@ -1004,12 +1017,12 @@ function checkSubdirectoriesRecursive(string $path): array * * 루트 LICENSE 파일을 읽습니다. (한국어 번역 + 영문 원문 통합) * - * @param string $lang 언어 코드 (미사용, 하위 호환성 유지) + * @param string $lang 언어 코드 (미사용, 하위 호환성 유지) * @return string 라이선스 파일 내용 */ function loadLicenseFile(string $lang): string { - $licenseFile = __DIR__ . '/../../../LICENSE'; + $licenseFile = __DIR__.'/../../../LICENSE'; if (file_exists($licenseFile)) { return file_get_contents($licenseFile); @@ -1024,7 +1037,7 @@ function loadLicenseFile(string $lang): string * 특수 문자가 포함된 값을 .env 파일에 안전하게 기록할 수 있도록 큰따옴표로 감싸고 * 내부 큰따옴표와 백슬래시를 이스케이프합니다. * - * @param string $value 이스케이프할 값 + * @param string $value 이스케이프할 값 * @return string 큰따옴표로 감싸고 내부 큰따옴표와 백슬래시를 이스케이프한 값 */ function escapeEnvValue(string $value): string @@ -1044,7 +1057,7 @@ function escapeEnvValue(string $value): string $escaped = str_replace(['\\', '"'], ['\\\\', '\\"'], $value); // 큰따옴표로 감싸기 - return '"' . $escaped . '"'; + return '"'.$escaped.'"'; } /** @@ -1057,8 +1070,8 @@ function escapeEnvValue(string $value): string */ function generateEnvContent(): ?string { - $envExamplePath = BASE_PATH . '/.env.example'; - if (!file_exists($envExamplePath)) { + $envExamplePath = BASE_PATH.'/.env.example'; + if (! file_exists($envExamplePath)) { return null; } @@ -1069,39 +1082,41 @@ function generateEnvContent(): ?string // 데이터베이스 설정 치환 $replacements = [ 'DB_CONNECTION=mysql' => 'DB_CONNECTION=mysql', - 'DB_WRITE_HOST=127.0.0.1' => 'DB_WRITE_HOST=' . ($config['db_write_host'] ?? '127.0.0.1'), - 'DB_WRITE_PORT=3306' => 'DB_WRITE_PORT=' . ($config['db_write_port'] ?? '3306'), - 'DB_WRITE_DATABASE=g7' => 'DB_WRITE_DATABASE=' . ($config['db_write_database'] ?? 'g7'), - 'DB_WRITE_USERNAME=root' => 'DB_WRITE_USERNAME=' . ($config['db_write_username'] ?? 'root'), - 'DB_WRITE_PASSWORD=' => 'DB_WRITE_PASSWORD=' . escapeEnvValue($config['db_write_password'] ?? ''), - 'DB_PREFIX=g7_' => 'DB_PREFIX=' . ($config['db_prefix'] ?? 'g7_'), + 'DB_WRITE_HOST=127.0.0.1' => 'DB_WRITE_HOST='.($config['db_write_host'] ?? '127.0.0.1'), + 'DB_WRITE_PORT=3306' => 'DB_WRITE_PORT='.($config['db_write_port'] ?? '3306'), + 'DB_WRITE_DATABASE=g7' => 'DB_WRITE_DATABASE='.($config['db_write_database'] ?? 'g7'), + 'DB_WRITE_USERNAME=root' => 'DB_WRITE_USERNAME='.($config['db_write_username'] ?? 'root'), + 'DB_WRITE_PASSWORD=' => 'DB_WRITE_PASSWORD='.escapeEnvValue($config['db_write_password'] ?? ''), + 'DB_PREFIX=g7_' => 'DB_PREFIX='.($config['db_prefix'] ?? 'g7_'), ]; // Read DB 설정 - if (!empty($config['use_read_db']) && $config['use_read_db']) { - $replacements['DB_READ_HOST='] = 'DB_READ_HOST=' . ($config['db_read_host'] ?? '127.0.0.1'); - $replacements['DB_READ_PORT='] = 'DB_READ_PORT=' . ($config['db_read_port'] ?? '3306'); - $replacements['DB_READ_DATABASE='] = 'DB_READ_DATABASE=' . ($config['db_read_database'] ?? 'g7'); - $replacements['DB_READ_USERNAME='] = 'DB_READ_USERNAME=' . ($config['db_read_username'] ?? 'root'); - $replacements['DB_READ_PASSWORD='] = 'DB_READ_PASSWORD=' . escapeEnvValue($config['db_read_password'] ?? ''); + if (! empty($config['use_read_db']) && $config['use_read_db']) { + $replacements['DB_READ_HOST='] = 'DB_READ_HOST='.($config['db_read_host'] ?? '127.0.0.1'); + $replacements['DB_READ_PORT='] = 'DB_READ_PORT='.($config['db_read_port'] ?? '3306'); + $replacements['DB_READ_DATABASE='] = 'DB_READ_DATABASE='.($config['db_read_database'] ?? 'g7'); + $replacements['DB_READ_USERNAME='] = 'DB_READ_USERNAME='.($config['db_read_username'] ?? 'root'); + $replacements['DB_READ_PASSWORD='] = 'DB_READ_PASSWORD='.escapeEnvValue($config['db_read_password'] ?? ''); } else { - // Read DB를 사용하지 않는 경우 Write DB 정보와 동일하게 설정 - $replacements['DB_READ_HOST='] = 'DB_READ_HOST=' . ($config['db_write_host'] ?? '127.0.0.1'); - $replacements['DB_READ_PORT='] = 'DB_READ_PORT=' . ($config['db_write_port'] ?? '3306'); - $replacements['DB_READ_DATABASE='] = 'DB_READ_DATABASE=' . ($config['db_write_database'] ?? 'g7'); - $replacements['DB_READ_USERNAME='] = 'DB_READ_USERNAME=' . ($config['db_write_username'] ?? 'root'); - $replacements['DB_READ_PASSWORD='] = 'DB_READ_PASSWORD=' . escapeEnvValue($config['db_write_password'] ?? ''); + // Read DB를 사용하지 않는 경우 DB_READ_* 를 빈 값으로 둔다. + // config/database.php 의 write fallback(Elvis) 이 SELECT 를 write DB 로 넘기므로 + // .env 에 write 값을 중복 기록하지 않는다 (write 변경 시 read stale 방지). (이슈 #63) + $replacements['DB_READ_HOST='] = 'DB_READ_HOST='; + $replacements['DB_READ_PORT='] = 'DB_READ_PORT='; + $replacements['DB_READ_DATABASE='] = 'DB_READ_DATABASE='; + $replacements['DB_READ_USERNAME='] = 'DB_READ_USERNAME='; + $replacements['DB_READ_PASSWORD='] = 'DB_READ_PASSWORD='; } // 앱 설정 치환 - $replacements['APP_NAME=그누보드7'] = 'APP_NAME="' . ($config['app_name'] ?? '그누보드7') . '"'; - $replacements['APP_ENV=production'] = 'APP_ENV=' . ($config['app_env'] ?? 'production'); - $replacements['APP_URL=http://localhost'] = 'APP_URL=' . ($config['app_url'] ?? 'http://localhost'); + $replacements['APP_NAME=그누보드7'] = 'APP_NAME="'.($config['app_name'] ?? '그누보드7').'"'; + $replacements['APP_ENV=production'] = 'APP_ENV='.($config['app_env'] ?? 'production'); + $replacements['APP_URL=http://localhost'] = 'APP_URL='.($config['app_url'] ?? 'http://localhost'); // 언어 설정 $currentLang = getCurrentLanguage(); - $replacements['APP_LOCALE=ko'] = 'APP_LOCALE=' . $currentLang; - $replacements['APP_FAKER_LOCALE=ko_KR'] = 'APP_FAKER_LOCALE=' . ($currentLang === 'ko' ? 'ko_KR' : 'en_US'); + $replacements['APP_LOCALE=ko'] = 'APP_LOCALE='.$currentLang; + $replacements['APP_FAKER_LOCALE=ko_KR'] = 'APP_FAKER_LOCALE='.($currentLang === 'ko' ? 'ko_KR' : 'en_US'); if (isset($config['app_env']) && $config['app_env'] !== 'production') { $replacements['APP_DEBUG=false'] = 'APP_DEBUG=true'; @@ -1112,15 +1127,15 @@ function generateEnvContent(): ?string $coreGithubUrl = $config['core_update_github_url'] ?? 'https://github.com/gnuboard/g7'; $coreGithubToken = $config['core_update_github_token'] ?? ''; - $replacements['G7_UPDATE_PENDING_PATH='] = 'G7_UPDATE_PENDING_PATH=' . escapeEnvValue($corePendingPath); - $replacements['G7_UPDATE_GITHUB_URL=https://github.com/gnuboard/g7'] = 'G7_UPDATE_GITHUB_URL=' . $coreGithubUrl; - $replacements['G7_UPDATE_GITHUB_TOKEN='] = 'G7_UPDATE_GITHUB_TOKEN=' . escapeEnvValue($coreGithubToken); + $replacements['G7_UPDATE_PENDING_PATH='] = 'G7_UPDATE_PENDING_PATH='.escapeEnvValue($corePendingPath); + $replacements['G7_UPDATE_GITHUB_URL=https://github.com/gnuboard/g7'] = 'G7_UPDATE_GITHUB_URL='.$coreGithubUrl; + $replacements['G7_UPDATE_GITHUB_TOKEN='] = 'G7_UPDATE_GITHUB_TOKEN='.escapeEnvValue($coreGithubToken); // PHP CLI / Composer 바이너리 경로 치환 $phpBinary = $config['php_binary'] ?? 'php'; $composerBinary = $config['composer_binary'] ?? ''; - $replacements['PHP_BINARY=php'] = 'PHP_BINARY=' . escapeEnvValue($phpBinary); - $replacements['COMPOSER_BINARY='] = 'COMPOSER_BINARY=' . escapeEnvValue($composerBinary); + $replacements['PHP_BINARY=php'] = 'PHP_BINARY='.escapeEnvValue($phpBinary); + $replacements['COMPOSER_BINARY='] = 'COMPOSER_BINARY='.escapeEnvValue($composerBinary); foreach ($replacements as $search => $replace) { $envContent = str_replace($search, $replace, $envContent); @@ -1142,22 +1157,22 @@ function isWindows(): bool /** * OS에 맞는 .env 파일 복사 명령어를 반환합니다. * - * @param string $basePath 프로젝트 루트 경로 (빈 문자열이면 상대 경로 사용) + * @param string $basePath 프로젝트 루트 경로 (빈 문자열이면 상대 경로 사용) * @return string 복사 명령어 */ function getEnvCopyCommand(string $basePath = ''): string { if (isWindows()) { - $source = $basePath ? $basePath . '\\.env.example' : '.env.example'; - $dest = $basePath ? $basePath . '\\.env' : '.env'; + $source = $basePath ? $basePath.'\\.env.example' : '.env.example'; + $dest = $basePath ? $basePath.'\\.env' : '.env'; - return 'copy ' . str_replace('/', '\\', $source) . ' ' . str_replace('/', '\\', $dest); + return 'copy '.str_replace('/', '\\', $source).' '.str_replace('/', '\\', $dest); } - $source = $basePath ? $basePath . '/.env.example' : '.env.example'; - $dest = $basePath ? $basePath . '/.env' : '.env'; + $source = $basePath ? $basePath.'/.env.example' : '.env.example'; + $dest = $basePath ? $basePath.'/.env' : '.env'; - return 'cp ' . $source . ' ' . $dest; + return 'cp '.$source.' '.$dest; } /** @@ -1167,8 +1182,8 @@ function getEnvCopyCommand(string $basePath = ''): string * chown/setgid 의존성을 제거하여 공유호스팅 호환성 확보. * 실제 통과 기준은 is_writable() && is_readable()이므로 비트 값은 참고용. * - * @param string $pathList 대상 경로 (공백 구분) - * @param string $mode 'ownership' (디렉토리) 또는 'file' (파일) + * @param string $pathList 대상 경로 (공백 구분) + * @param string $mode 'ownership' (디렉토리) 또는 'file' (파일) * @return string 권한 수정 명령어 */ function getPermissionFixCommand(string $pathList, string $mode = 'ownership'): string @@ -1176,20 +1191,19 @@ function getPermissionFixCommand(string $pathList, string $mode = 'ownership'): if (isWindows()) { $winPath = str_replace('/', '\\', $pathList); if ($mode === 'file') { - return 'icacls ' . $winPath . ' /grant Everyone:F'; + return 'icacls '.$winPath.' /grant Everyone:F'; } - return 'icacls ' . $winPath . ' /grant Everyone:(OI)(CI)F /T'; + return 'icacls '.$winPath.' /grant Everyone:(OI)(CI)F /T'; } if ($mode === 'file') { - return 'chmod 644 ' . $pathList; + return 'chmod 644 '.$pathList; } - return 'chmod -R 755 ' . $pathList; + return 'chmod -R 755 '.$pathList; } - /** * 기존 DB 테이블 감지. * @@ -1202,9 +1216,8 @@ function getPermissionFixCommand(string $pathList, string $mode = 'ownership'): * - 'mixed' : G7 일부 + 기타 혼재 * - 'foreign_data' : G7 시그니처 없음 + 기타 테이블 존재 * - * @param PDO $pdo 연결된 PDO 인스턴스 - * @param string $database 대상 데이터베이스명 - * @return array + * @param PDO $pdo 연결된 PDO 인스턴스 + * @param string $database 대상 데이터베이스명 */ function checkExistingTables(PDO $pdo, string $database, string $tablePrefix = ''): array { @@ -1237,7 +1250,7 @@ function checkExistingTables(PDO $pdo, string $database, string $tablePrefix = ' // G7 핵심 시그니처 테이블 — 정책 결정: 4개 모두 일치 시 "G7 설치됨"으로 판단 // 테이블 prefix를 적용하여 비교 (예: prefix='g7_'이면 'g7_users', 'g7_migrations' 등) $coreSignatures = ['users', 'migrations', 'roles', 'permissions']; - $g7Signatures = array_map(fn ($t) => $tablePrefix . $t, $coreSignatures); + $g7Signatures = array_map(fn ($t) => $tablePrefix.$t, $coreSignatures); $g7TablesFound = array_values(array_intersect($g7Signatures, $tables)); $severity = 'foreign_data'; @@ -1257,7 +1270,7 @@ function checkExistingTables(PDO $pdo, string $database, string $tablePrefix = ' ]; } -if (!function_exists('filterTablesByPrefix')) { +if (! function_exists('filterTablesByPrefix')) { /** * 기존 테이블 목록을 db_prefix 로 필터링합니다. * @@ -1268,8 +1281,8 @@ if (!function_exists('filterTablesByPrefix')) { * 빈 prefix 는 전체 일치가 되어 모든 테이블이 삭제되는 위험이 있으므로, * 데이터 손실 방어를 위해 빈 목록(삭제 대상 없음)을 반환합니다. * - * @param array $tables SHOW TABLES 로 조회한 전체 테이블 목록 - * @param string $prefix 사용자가 입력한 테이블 prefix (예: 'g7_') + * @param array $tables SHOW TABLES 로 조회한 전체 테이블 목록 + * @param string $prefix 사용자가 입력한 테이블 prefix (예: 'g7_') * @return array prefix 로 시작하는 테이블만 담은 목록 */ function filterTablesByPrefix(array $tables, string $prefix): array diff --git a/public/install/includes/installer-runtime.php b/public/install/includes/installer-runtime.php index 02134496..b2f80317 100644 --- a/public/install/includes/installer-runtime.php +++ b/public/install/includes/installer-runtime.php @@ -15,13 +15,12 @@ * * @see https://github.com/gnuboard/g7/issues/23 */ - if (! defined('BASE_PATH')) { throw new RuntimeException('installer-runtime.php requires BASE_PATH constant.'); } if (! defined('INSTALLER_RUNTIME_PATH')) { - define('INSTALLER_RUNTIME_PATH', BASE_PATH . '/storage/installer/runtime.php'); + define('INSTALLER_RUNTIME_PATH', BASE_PATH.'/storage/installer/runtime.php'); } if (! function_exists('readInstallerRuntime')) { @@ -59,9 +58,9 @@ if (! function_exists('writeInstallerRuntime')) { return false; } - $php = " date('c'), ]; - // Read 커넥션이 별도로 지정된 경우만 포함 (그렇지 않으면 Laravel 이 write 사용) - if (! empty($stateConfig['db_read_host']) && $stateConfig['db_read_host'] !== ($stateConfig['db_write_host'] ?? null)) { + // Read 커넥션은 use_read_db 플래그가 켜진 경우에만 포함한다 (판정 SSoT). + // 플래그가 꺼져 있으면 db_read_host 에 잔존 값이 있어도 무시 → runtime 에 read 키 + // 미생성 → 하류(mergeRuntimeIntoEnv / InstallerRuntimeServiceProvider)가 write 로 + // 자동 동기화. (이슈 #63: use_read_db=false 인데 db_read_host 를 참조하던 회귀 차단) + if (! empty($stateConfig['use_read_db']) + && ! empty($stateConfig['db_read_host']) + && $stateConfig['db_read_host'] !== ($stateConfig['db_write_host'] ?? null)) { $runtime['db']['read'] = [ 'host' => $stateConfig['db_read_host'], 'port' => $stateConfig['db_read_port'] ?? $runtime['db']['write']['port'], diff --git a/public/install/includes/installer-state.php b/public/install/includes/installer-state.php index 20d8a6f0..1984b4e7 100644 --- a/public/install/includes/installer-state.php +++ b/public/install/includes/installer-state.php @@ -5,16 +5,15 @@ * * 설치 진행 상태를 storage/installer-state.json에 저장하고 조회합니다. */ - -if (!defined('BASE_PATH')) { +if (! defined('BASE_PATH')) { define('BASE_PATH', realpath(dirname(__DIR__, 3)) ?: dirname(__DIR__, 3)); // public/install/includes에서 프로젝트 루트로 } if (! defined('STATE_PATH')) { - define('STATE_PATH', BASE_PATH . '/storage/installer-state.json'); + define('STATE_PATH', BASE_PATH.'/storage/installer-state.json'); } if (! defined('INSTALLER_DIR')) { - define('INSTALLER_DIR', BASE_PATH . '/storage/installer'); + define('INSTALLER_DIR', BASE_PATH.'/storage/installer'); } /** @@ -36,15 +35,16 @@ function getInstallationState(): array // state.json 파일이 없으면 기본 상태 반환 // (설치 완료 후 워커가 DELETE_INSTALLER_AFTER_COMPLETE로 정상 삭제하는 경우가 있으므로 // 부재 자체는 에러가 아님. 호출자가 g7_installed 플래그 등으로 완료 여부 판정) - if (!file_exists(STATE_PATH)) { + if (! file_exists(STATE_PATH)) { return $defaultState; } // 파일 읽기 권한 체크 - if (!is_readable(STATE_PATH)) { - $msg = "[installer-state] State file is not readable: " . STATE_PATH; + if (! is_readable(STATE_PATH)) { + $msg = '[installer-state] State file is not readable: '.STATE_PATH; error_log($msg); addLog($msg); + return $defaultState; } @@ -53,9 +53,10 @@ function getInstallationState(): array // 파일 읽기 실패 시 기본 상태 반환 if ($content === false) { - $msg = "[installer-state] Failed to read state file: " . STATE_PATH; + $msg = '[installer-state] Failed to read state file: '.STATE_PATH; error_log($msg); addLog($msg); + return $defaultState; } @@ -65,9 +66,10 @@ function getInstallationState(): array if (json_last_error() !== JSON_ERROR_NONE) { $contentLen = strlen($content); $preview = substr($content, 0, 200); - $msg = "[installer-state] Failed to parse state file JSON (length={$contentLen}): " . json_last_error_msg() . " / preview: " . $preview; + $msg = "[installer-state] Failed to parse state file JSON (length={$contentLen}): ".json_last_error_msg().' / preview: '.$preview; error_log($msg); addLog($msg); + return $defaultState; } @@ -77,25 +79,27 @@ function getInstallationState(): array /** * 설치 상태 저장 * - * @param array $state 저장할 상태 배열 + * @param array $state 저장할 상태 배열 * @return bool 저장 성공 여부 */ function saveInstallationState(array $state): bool { // storage 디렉토리 존재 여부 확인 (생성하지 않음) - $storageDir = BASE_PATH . '/storage'; - if (!is_dir($storageDir)) { + $storageDir = BASE_PATH.'/storage'; + if (! is_dir($storageDir)) { $msg = "[installer-state] Storage directory does not exist: {$storageDir}"; error_log($msg); addLog($msg); + return false; } // 디렉토리 쓰기 권한 확인 - if (!is_writable($storageDir)) { + if (! is_writable($storageDir)) { $msg = "[installer-state] Storage directory is not writable: {$storageDir}"; error_log($msg); addLog($msg); + return false; } @@ -106,33 +110,36 @@ function saveInstallationState(array $state): bool $content = json_encode($state, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES); if ($content === false) { - $msg = "[installer-state] Failed to encode state as JSON: " . json_last_error_msg(); + $msg = '[installer-state] Failed to encode state as JSON: '.json_last_error_msg(); error_log($msg); addLog($msg); + return false; } // 원자적 쓰기: tmp 파일에 쓰고 rename으로 교체 // 동시 쓰기 경쟁 상황에서 부분 쓰기(half-written file)로 인한 JSON 손상 방지. // Linux에서 rename()은 atomic syscall이므로 다른 리더가 항상 완전한 파일만 읽는다. - $tmpPath = STATE_PATH . '.tmp.' . getmypid() . '.' . uniqid(); + $tmpPath = STATE_PATH.'.tmp.'.getmypid().'.'.uniqid(); $result = @file_put_contents($tmpPath, $content, LOCK_EX); if ($result === false || $result !== strlen($content)) { - $msg = "[installer-state] Failed to write state tmp file: " . $tmpPath; + $msg = '[installer-state] Failed to write state tmp file: '.$tmpPath; error_log($msg); addLog($msg); @unlink($tmpPath); + return false; } @chmod($tmpPath, 0664); - if (!@rename($tmpPath, STATE_PATH)) { - $msg = "[installer-state] Failed to rename state tmp file: " . $tmpPath . ' → ' . STATE_PATH; + if (! @rename($tmpPath, STATE_PATH)) { + $msg = '[installer-state] Failed to rename state tmp file: '.$tmpPath.' → '.STATE_PATH; error_log($msg); addLog($msg); @unlink($tmpPath); + return false; } @@ -161,13 +168,13 @@ function isInstallationCompleted(): bool } // g7_installed 파일 존재 여부 확인 (추가 안전장치) - $installedFlagPath = BASE_PATH . '/storage/app/g7_installed'; + $installedFlagPath = BASE_PATH.'/storage/app/g7_installed'; if (file_exists($installedFlagPath)) { return true; } // .env 파일의 INSTALLER_COMPLETED 플래그 확인 - $envPath = BASE_PATH . '/.env'; + $envPath = BASE_PATH.'/.env'; if (file_exists($envPath)) { $envContent = file_get_contents($envPath); if (strpos($envContent, 'INSTALLER_COMPLETED=true') !== false) { @@ -181,7 +188,7 @@ function isInstallationCompleted(): bool /** * 특정 작업을 완료로 표시 * - * @param string $task 작업 식별자 + * @param string $task 작업 식별자 * @return bool 업데이트 성공 여부 */ function markTaskCompleted(string $task): bool @@ -189,7 +196,7 @@ function markTaskCompleted(string $task): bool $state = getInstallationState(); // completed_tasks 배열에 추가 (중복 방지) - if (!in_array($task, $state['completed_tasks'])) { + if (! in_array($task, $state['completed_tasks'])) { $state['completed_tasks'][] = $task; } @@ -205,7 +212,7 @@ function markTaskCompleted(string $task): bool /** * 특정 작업을 완료 목록에서 제거 * - * @param string $task 작업 식별자 + * @param string $task 작업 식별자 * @return bool 업데이트 성공 여부 */ function removeTaskCompleted(string $task): bool @@ -213,7 +220,7 @@ function removeTaskCompleted(string $task): bool $state = getInstallationState(); $state['completed_tasks'] = array_values( - array_filter($state['completed_tasks'], fn($t) => $t !== $task) + array_filter($state['completed_tasks'], fn ($t) => $t !== $task) ); return saveInstallationState($state); @@ -251,7 +258,7 @@ function removeTaskCompleted(string $task): bool * * @param int $staleSeconds heartbeat 가 이 시간 이상 갱신 안 되면 stale 판정 (default 15초) * @return array{acquired: bool, worker_id: string|null, reason: string} - * reason: 'available' | 'takeover_stale' | 'busy' + * reason: 'available' | 'takeover_stale' | 'busy' */ function acquireWorkerLock(int $staleSeconds = 15): array { @@ -337,7 +344,7 @@ function applyExistingDbActionStateGuard(array $state, string $newAction): array $resetTasks = ['db_cleanup', 'db_migrate', 'db_seed']; $state['completed_tasks'] = array_values(array_filter( $state['completed_tasks'] ?? [], - fn($t) => !in_array($t, $resetTasks, true) + fn ($t) => ! in_array($t, $resetTasks, true) )); } else { // 키 정규화 — completed_tasks 가 부재인 경우 빈 배열 보장 @@ -350,7 +357,7 @@ function applyExistingDbActionStateGuard(array $state, string $newAction): array /** * 현재 진행 중인 작업 업데이트 * - * @param string $task 작업 식별자 + * @param string $task 작업 식별자 * @return bool 업데이트 성공 여부 */ function updateCurrentTask(string $task): bool @@ -369,7 +376,7 @@ function updateCurrentTask(string $task): bool * 페이지 새로고침/재시작 시 로그가 즉시 표시되도록 * fflush() + clearstatcache()를 적용합니다. * - * @param string $message 로그 메시지 + * @param string $message 로그 메시지 * @return bool 저장 성공 여부 */ /** @@ -389,23 +396,25 @@ function addLogBatch(array $messages): bool return true; } - $logDir = BASE_PATH . '/storage/logs'; - $logFile = $logDir . '/installation.log'; + $logDir = BASE_PATH.'/storage/logs'; + $logFile = $logDir.'/installation.log'; - if (!is_dir($logDir)) { + if (! is_dir($logDir)) { $created = @mkdir($logDir, 0775, true); - if (!$created) { + if (! $created) { $msg = "[addLogBatch] Failed to create log directory: {$logDir}"; error_log($msg); addLog($msg); // 재귀 가드가 차단하므로 안전 — error_log fallback 만 수행 + return false; } } - if (!is_writable($logDir)) { + if (! is_writable($logDir)) { $msg = "[addLogBatch] Log directory is not writable: {$logDir}"; error_log($msg); addLog($msg); // 재귀 가드가 차단 + return false; } @@ -425,9 +434,9 @@ function addLogBatch(array $messages): bool } clearstatcache(true, $logFile); - $isNewFile = !file_exists($logFile) || filesize($logFile) === 0; + $isNewFile = ! file_exists($logFile) || filesize($logFile) === 0; if ($isNewFile) { - $entries = "\xEF\xBB\xBF" . $entries; + $entries = "\xEF\xBB\xBF".$entries; } $handle = @fopen($logFile, 'a'); @@ -435,6 +444,7 @@ function addLogBatch(array $messages): bool $msg = "[addLogBatch] Failed to open log file: {$logFile}"; error_log($msg); addLog($msg); // 재귀 가드가 차단 + return false; } flock($handle, LOCK_EX); @@ -455,7 +465,8 @@ function addLog(string $message): bool static $inAddLog = false; if ($inAddLog) { // 재진입: installation.log 시도 skip, PHP error_log 만 호출하고 즉시 종료 - error_log("[addLog reentrant] " . $message); + error_log('[addLog reentrant] '.$message); + return false; } $inAddLog = true; @@ -478,25 +489,27 @@ function addLog(string $message): bool */ function _addLogInternal(string $message): bool { - $logDir = BASE_PATH . '/storage/logs'; - $logFile = $logDir . '/installation.log'; + $logDir = BASE_PATH.'/storage/logs'; + $logFile = $logDir.'/installation.log'; // 로그 디렉토리 확인 및 생성 시도 - if (!is_dir($logDir)) { + if (! is_dir($logDir)) { $created = @mkdir($logDir, 0775, true); - if (!$created) { + if (! $created) { $msg = "[addLog] Failed to create log directory: {$logDir} (storage 권한 확인 필요)"; error_log($msg); addLog($msg); // 재귀 가드가 차단 (본 함수는 이미 가드 안) + return false; } } // 로그 디렉토리 쓰기 권한 확인 - if (!is_writable($logDir)) { + if (! is_writable($logDir)) { $msg = "[addLog] Log directory is not writable: {$logDir}"; error_log($msg); addLog($msg); // 재귀 가드가 차단 + return false; } @@ -508,6 +521,17 @@ function _addLogInternal(string $message): bool } } + // OS 무관 최종 방어 — 항상 유효 UTF-8 만 로그에 저장한다 (gnuboard/g7#62). + // composer install 등 외부 프로세스 stdout 이 시스템 코드페이지로 출력되거나 + // 진행바(\r 갱신)가 임의 바이트 경계에서 잘려 mb_detect_encoding 이 확정 감지에 + // 실패한 경우(위 분기 미적용), invalid 바이트가 그대로 로그에 남으면 + // 폴링 응답 state-management.php 의 json_encode 가 false 를 반환해 빈 본문(HTTP 200) + // → 프론트 res.json() 이 "Unexpected end of JSON input" 으로 폭주한다. + // mb_scrub 은 invalid 바이트를 U+FFFD 로 치환해 응답 무력화를 원천 차단한다. + if (! mb_check_encoding($message, 'UTF-8')) { + $message = mb_scrub($message, 'UTF-8'); + } + // 타임스탬프와 함께 로그 작성 — millisecond 정밀도 (hang 진단 시 정확한 timing 필요) $microtime = microtime(true); $ms = sprintf('%03d', (int) (($microtime - floor($microtime)) * 1000)); @@ -518,10 +542,10 @@ function _addLogInternal(string $message): bool clearstatcache(true, $logFile); // 파일이 없거나 빈 파일이면 UTF-8 BOM 추가 (Windows 텍스트 편집기 호환성) - $isNewFile = !file_exists($logFile) || filesize($logFile) === 0; + $isNewFile = ! file_exists($logFile) || filesize($logFile) === 0; if ($isNewFile) { $utf8Bom = "\xEF\xBB\xBF"; - $logEntry = $utf8Bom . $logEntry; + $logEntry = $utf8Bom.$logEntry; } // 파일 핸들 열기 (append 모드) @@ -530,6 +554,7 @@ function _addLogInternal(string $message): bool $msg = "[addLog] Failed to open log file: {$logFile}"; error_log($msg); addLog($msg); // 재귀 가드가 차단 + return false; } @@ -553,6 +578,7 @@ function _addLogInternal(string $message): bool $msg = "[addLog] Failed to write log file: {$logFile}"; error_log($msg); addLog($msg); // 재귀 가드가 차단 + return false; } @@ -565,16 +591,16 @@ function _addLogInternal(string $message): bool * 페이지 새로고침 시 최신 로그를 즉시 표시하기 위해 * clearstatcache()를 적용합니다. * - * @param int $offset 건너뛸 로그 줄 수 (폴링 모드 증분 조회용, 기본 0) + * @param int $offset 건너뛸 로그 줄 수 (폴링 모드 증분 조회용, 기본 0) * @return array 로그 배열 [{timestamp, message}, ...] */ function getInstallationLogs(int $offset = 0): array { - $logFile = BASE_PATH . '/storage/logs/installation.log'; + $logFile = BASE_PATH.'/storage/logs/installation.log'; clearstatcache(true, $logFile); - if (!file_exists($logFile)) { + if (! file_exists($logFile)) { return []; } @@ -621,11 +647,11 @@ function getInstallationLogs(int $offset = 0): array */ function getInstallationLogCount(): int { - $logFile = BASE_PATH . '/storage/logs/installation.log'; + $logFile = BASE_PATH.'/storage/logs/installation.log'; clearstatcache(true, $logFile); - if (!file_exists($logFile)) { + if (! file_exists($logFile)) { return 0; } @@ -637,10 +663,11 @@ function getInstallationLogCount(): int $lines = explode("\n", trim($content)); $count = 0; foreach ($lines as $line) { - if (!empty($line)) { + if (! empty($line)) { $count++; } } + return $count; } @@ -655,7 +682,7 @@ function getLastCompletedStep(): int // step_status를 역순으로 확인 for ($step = 5; $step >= 0; $step--) { - $stepKey = (string)$step; + $stepKey = (string) $step; if (isset($state['step_status'][$stepKey]) && $state['step_status'][$stepKey] === 'completed') { return $step; } diff --git a/public/install/includes/progress-emitter.php b/public/install/includes/progress-emitter.php index c1dc5a4d..aff29289 100644 --- a/public/install/includes/progress-emitter.php +++ b/public/install/includes/progress-emitter.php @@ -6,11 +6,8 @@ * SSE/폴링 듀얼 모드 지원을 위한 진행 상황 보고 인터페이스. * - SseEmitter: 실시간 SSE 스트리밍 + addLog * - NullEmitter: addLog만 수행 (폴링 모드, state.json 기반 조회) - * - * @package G7\Installer */ - -if (!defined('BASE_PATH')) { +if (! defined('BASE_PATH')) { define('BASE_PATH', realpath(dirname(__DIR__, 3)) ?: dirname(__DIR__, 3)); } @@ -19,8 +16,8 @@ interface ProgressEmitter /** * 임의 이벤트 송출 (SSE 이벤트 타입과 데이터 배열). * - * @param string $event 이벤트 타입 (connected, task_start, task_complete, log, completed, error, aborted, rollback_failed) - * @param array $data 이벤트 데이터 + * @param string $event 이벤트 타입 (connected, task_start, task_complete, log, completed, error, aborted, rollback_failed) + * @param array $data 이벤트 데이터 */ public function emit(string $event, array $data): void; @@ -57,8 +54,22 @@ class SseEmitter implements ProgressEmitter public function emit(string $event, array $data): void { + // SSE data 라인은 항상 유효 JSON 이어야 한다 (gnuboard/g7#62). + // composer install 등 외부 프로세스 로그에 invalid UTF-8 바이트가 섞이면 + // json_encode 가 false 를 반환해 "data: \n\n" (빈 값) 이 송출되고, + // 프론트 EventSource 리스너의 JSON.parse(e.data) 가 throw 되어 로그 이벤트가 유실된다. + // 폴링 응답(state-management)과 동일하게 JSON_INVALID_UTF8_SUBSTITUTE 로 치환하고 + // false 를 가드한다. (task-runner 의 스트림 scrub 과 이중 안전망) + $payload = json_encode($data, JSON_UNESCAPED_UNICODE | JSON_INVALID_UTF8_SUBSTITUTE); + if ($payload === false) { + $payload = json_encode( + ['message' => '(log line dropped: encoding error)'], + JSON_UNESCAPED_UNICODE + ); + } + echo "event: {$event}\n"; - echo "data: " . json_encode($data, JSON_UNESCAPED_UNICODE) . "\n\n"; + echo 'data: '.$payload."\n\n"; if (ob_get_level()) { @ob_flush(); } @@ -195,9 +206,10 @@ class NullEmitter implements ProgressEmitter */ function getProgressEmitter(): ProgressEmitter { - if (!isset($GLOBALS['g7_progress_emitter']) || !($GLOBALS['g7_progress_emitter'] instanceof ProgressEmitter)) { - $GLOBALS['g7_progress_emitter'] = new SseEmitter(); + if (! isset($GLOBALS['g7_progress_emitter']) || ! ($GLOBALS['g7_progress_emitter'] instanceof ProgressEmitter)) { + $GLOBALS['g7_progress_emitter'] = new SseEmitter; } + return $GLOBALS['g7_progress_emitter']; } diff --git a/public/install/includes/request-handler.php b/public/install/includes/request-handler.php index c2395a10..2e7394d0 100644 --- a/public/install/includes/request-handler.php +++ b/public/install/includes/request-handler.php @@ -4,15 +4,13 @@ * 그누보드7 웹 인스톨러 요청 처리 핸들러 * * 모든 POST 요청 및 비즈니스 로직을 처리합니다. - * - * @package G7\Installer */ /** * 설치 흐름 검증 및 리다이렉트 * - * @param int $currentStep 현재 단계 - * @param array $state 설치 상태 + * @param int $currentStep 현재 단계 + * @param array $state 설치 상태 */ function validateInstallationFlow(int $currentStep, array $state): void { @@ -42,14 +40,14 @@ function validateInstallationFlow(int $currentStep, array $state): void /** * 잘못된 단계 접근 시 알림 표시 * - * @param int $correctStep 올바른 단계 번호 + * @param int $correctStep 올바른 단계 번호 */ function showInvalidStepAccessAlert(int $correctStep): void { global $translations; // 번역이 로드되지 않은 경우 로드 - if (!isset($translations)) { + if (! isset($translations)) { $translations = loadTranslations(getCurrentLanguage()); } @@ -59,7 +57,7 @@ function showInvalidStepAccessAlert(int $correctStep): void showAlertAndRedirect( lang('error_invalid_step_access'), lang('error_invalid_step_access_message'), - INSTALLER_BASE_URL . '/' + INSTALLER_BASE_URL.'/' ); } @@ -73,7 +71,7 @@ function handleStep0Post(): void } // 다음 버튼 클릭 시 (언어 선택 변경이 아닌 경우) - if (!isset($_POST['language_change_only'])) { + if (! isset($_POST['language_change_only'])) { unset($_SESSION['license_agreed']); updateStepStatus(0, 1); redirectToStep(1); @@ -85,14 +83,14 @@ function handleStep0Post(): void /** * Step 1 POST 처리 (라이선스 동의) * - * @param string $currentLang 현재 언어 - * @param string|null &$error 에러 메시지 (참조) + * @param string $currentLang 현재 언어 + * @param string|null &$error 에러 메시지 (참조) */ function handleStep1Post(string $currentLang, ?string &$error = null): void { $translations = loadTranslations($currentLang); - if (!isset($_POST['agree']) || $_POST['agree'] !== '1') { + if (! isset($_POST['agree']) || $_POST['agree'] !== '1') { $error = lang('must_agree'); } else { $_SESSION['license_agreed'] = true; @@ -115,9 +113,9 @@ function handleStep2Post(): void /** * Step 3 POST 처리 (데이터베이스 및 사이트 설정) * - * @param string $currentLang 현재 언어 - * @param array &$formData 폼 데이터 (참조) - * @param array &$errors 에러 배열 (참조) + * @param string $currentLang 현재 언어 + * @param array &$formData 폼 데이터 (참조) + * @param array &$errors 에러 배열 (참조) */ function handleStep3Post(string $currentLang, array &$formData, array &$errors): void { @@ -135,7 +133,7 @@ function handleStep3Post(string $currentLang, array &$formData, array &$errors): } // Read DB 검증 (사용하는 경우) - if (!empty($formData['use_read_db'])) { + if (! empty($formData['use_read_db'])) { if (empty($formData['db_read_host'])) { $errors['db_read_host'] = lang('error_db_host_required'); } @@ -145,10 +143,10 @@ function handleStep3Post(string $currentLang, array &$formData, array &$errors): } // 관리자 정보 검증 - if (empty($formData['admin_email']) || !filter_var($formData['admin_email'], FILTER_VALIDATE_EMAIL)) { + if (empty($formData['admin_email']) || ! filter_var($formData['admin_email'], FILTER_VALIDATE_EMAIL)) { $errors['admin_email'] = lang('error_admin_email_invalid'); } - if (!array_key_exists($formData['admin_language'] ?? '', SUPPORTED_LANGUAGES)) { + if (! array_key_exists($formData['admin_language'] ?? '', SUPPORTED_LANGUAGES)) { $errors['admin_language'] = lang('error_admin_language_invalid'); } if (empty($formData['admin_password']) || strlen($formData['admin_password']) < 8) { @@ -176,19 +174,19 @@ function handleStep3Post(string $currentLang, array &$formData, array &$errors): // 절대 경로 변환 $absolutePath = str_starts_with($corePendingPath, '/') ? $corePendingPath - : BASE_PATH . '/' . $corePendingPath; + : BASE_PATH.'/'.$corePendingPath; - if (file_exists($absolutePath) && !is_dir($absolutePath)) { + if (file_exists($absolutePath) && ! is_dir($absolutePath)) { $errors['core_update_pending_path'] = lang('error_core_pending_not_directory'); } } // DB 테스트 완료 확인 - if (empty($errors) && !isset($_SESSION['db_write_tested'])) { + if (empty($errors) && ! isset($_SESSION['db_write_tested'])) { $errors['db_test'] = lang('error_db_not_tested'); } - if (empty($errors) && !empty($formData['use_read_db']) && !isset($_SESSION['db_read_tested'])) { + if (empty($errors) && ! empty($formData['use_read_db']) && ! isset($_SESSION['db_read_tested'])) { $errors['db_test'] = lang('error_db_not_tested'); } @@ -200,9 +198,21 @@ function handleStep3Post(string $currentLang, array &$formData, array &$errors): $safeFormData = $formData; unset($safeFormData['db_write_password'], $safeFormData['db_read_password']); + // Read DB 미사용 시 read 필드 잔존값을 제거한다 (이슈 #63 2단계 방어). + // use_read_db=false 인데 db_read_host 등이 남아 있으면 하류(installer-runtime.php) + // 로 유입되어 잘못된 read 커넥션을 만들 수 있으므로 원천 차단한다. + if (empty($safeFormData['use_read_db'])) { + unset( + $safeFormData['db_read_host'], + $safeFormData['db_read_port'], + $safeFormData['db_read_database'], + $safeFormData['db_read_username'] + ); + } + updateStepStatus(3, 4, [ 'config' => $safeFormData, - 'installation_status' => 'ready' + 'installation_status' => 'ready', ]); redirectToStep(4); @@ -212,21 +222,21 @@ function handleStep3Post(string $currentLang, array &$formData, array &$errors): /** * POST 요청 라우팅 * - * @param int $currentStep 현재 단계 - * @param string $currentLang 현재 언어 - * @param array &$formData 폼 데이터 (참조) - * @param array &$errors 에러 배열 (참조) - * @param string|null &$error 에러 메시지 (참조) + * @param int $currentStep 현재 단계 + * @param string $currentLang 현재 언어 + * @param array &$formData 폼 데이터 (참조) + * @param array &$errors 에러 배열 (참조) + * @param string|null &$error 에러 메시지 (참조) */ function handlePostRequest(int $currentStep, string $currentLang, array &$formData = [], array &$errors = [], ?string &$error = null): void { // 단계 이동 처리 (go_to_step POST 파라미터) if (isset($_POST['go_to_step'])) { - $step = (int)$_POST['go_to_step']; + $step = (int) $_POST['go_to_step']; if ($step >= 0 && $step <= 5) { $_SESSION['installer_current_step'] = $step; } - header('Location: ' . INSTALLER_BASE_URL . '/'); + header('Location: '.INSTALLER_BASE_URL.'/'); exit; } @@ -238,7 +248,7 @@ function handlePostRequest(int $currentStep, string $currentLang, array &$formDa } // Step별 POST 처리 - match($currentStep) { + match ($currentStep) { 0 => handleStep0Post(), 1 => handleStep1Post($currentLang, $error), 2 => handleStep2Post(), diff --git a/public/install/includes/task-runner.php b/public/install/includes/task-runner.php index cbe25bb5..2caa6948 100644 --- a/public/install/includes/task-runner.php +++ b/public/install/includes/task-runner.php @@ -6,28 +6,26 @@ * 설치 task 정의와 실행 로직을 모드와 무관하게 제공합니다. * 진입점(install-worker.php SSE 모드, install-process.php 폴링 모드)이 * ProgressEmitter를 등록한 뒤 runInstallationTasks()를 호출합니다. - * - * @package G7\Installer */ -require_once __DIR__ . '/config.php'; -require_once __DIR__ . '/functions.php'; -require_once __DIR__ . '/installer-state.php'; -require_once __DIR__ . '/installer-runtime.php'; -require_once __DIR__ . '/progress-emitter.php'; -require_once __DIR__ . '/../api/rollback-functions.php'; +require_once __DIR__.'/config.php'; +require_once __DIR__.'/functions.php'; +require_once __DIR__.'/installer-state.php'; +require_once __DIR__.'/installer-runtime.php'; +require_once __DIR__.'/progress-emitter.php'; +require_once __DIR__.'/../api/rollback-functions.php'; // ============================================================================ // Emitter 호환 래퍼 — 기존 task 함수의 sendSSEEvent() 호출을 그대로 유지하면서 // 내부적으로 현재 등록된 ProgressEmitter로 delegate합니다. // ============================================================================ -if (!function_exists('sendSSEEvent')) { +if (! function_exists('sendSSEEvent')) { /** * 이벤트 송출 (SSE 모드/폴링 모드 공통). * - * @param string $event 이벤트 타입 - * @param array $data 이벤트 데이터 + * @param string $event 이벤트 타입 + * @param array $data 이벤트 데이터 */ function sendSSEEvent(string $event, array $data): void { @@ -35,17 +33,17 @@ if (!function_exists('sendSSEEvent')) { } } -if (!function_exists('sendRollbackOutputSSE')) { +if (! function_exists('sendRollbackOutputSSE')) { /** * 롤백 실행 결과를 로그 이벤트로 출력합니다. * - * @param array $rollbackResult rollbackDbMigrate() 등의 반환값 + * @param array $rollbackResult rollbackDbMigrate() 등의 반환값 */ function sendRollbackOutputSSE(array $rollbackResult): void { - if (!empty($rollbackResult['output']) && is_array($rollbackResult['output'])) { + if (! empty($rollbackResult['output']) && is_array($rollbackResult['output'])) { foreach ($rollbackResult['output'] as $line) { - if (!empty(trim($line))) { + if (! empty(trim($line))) { sendSSEEvent('log', ['message' => $line]); } } @@ -53,7 +51,7 @@ if (!function_exists('sendRollbackOutputSSE')) { } } -if (!function_exists('checkAbortStatusSSE')) { +if (! function_exists('checkAbortStatusSSE')) { /** * 설치 중단 여부 확인 (SSE/폴링 공용). * @@ -68,12 +66,12 @@ if (!function_exists('checkAbortStatusSSE')) { $state = getInstallationState(); $currentTask = $state['current_task'] ?? null; - if ($currentTask && !in_array($currentTask, $state['completed_tasks'] ?? [])) { + if ($currentTask && ! in_array($currentTask, $state['completed_tasks'] ?? [])) { addLog(lang('abort_rollback_start', ['task' => $currentTask])); $rollbackResult = rollbackTask($currentTask, $state); - if (!empty($rollbackResult['output']) && is_array($rollbackResult['output'])) { + if (! empty($rollbackResult['output']) && is_array($rollbackResult['output'])) { $outputStr = implode("\n", $rollbackResult['output']); addLog($outputStr); } @@ -101,7 +99,7 @@ if (!function_exists('checkAbortStatusSSE')) { $state['abort_reason'] = 'Connection aborted unexpectedly'; $state['aborted_at'] = date('Y-m-d H:i:s'); - if (isset($rollbackResult) && !$rollbackResult['success']) { + if (isset($rollbackResult) && ! $rollbackResult['success']) { $state['rollback_failure'] = [ 'task' => $currentTask, 'message' => $rollbackResult['message'] ?? null, @@ -111,6 +109,7 @@ if (!function_exists('checkAbortStatusSSE')) { } saveInstallationState($state); + return true; } @@ -119,6 +118,7 @@ if (!function_exists('checkAbortStatusSSE')) { if (isset($state['installation_status']) && $state['installation_status'] === 'aborted') { $currentTask = $state['current_task'] ?? 'unknown'; addLog(lang('abort_by_user', ['task' => $currentTask])); + return true; } @@ -130,15 +130,16 @@ if (!function_exists('checkAbortStatusSSE')) { // Task 함수 정의 (install-worker.php에서 이관됨 — 동작 동일) // ============================================================================ -if (!function_exists('getPhpBinary')) { +if (! function_exists('getPhpBinary')) { function getPhpBinary(): string { $state = getInstallationState(); + return $state['config']['php_binary'] ?? 'php' ?: 'php'; } } -if (!function_exists('isInstallerExecutablePath')) { +if (! function_exists('isInstallerExecutablePath')) { /** * 인스톨러가 exec 에 전달하기 안전한 단일 토큰 경로인지 검증한다. * @@ -157,11 +158,12 @@ if (!function_exists('isInstallerExecutablePath')) { if (preg_match('/[\s;`$|<>"\'&\x00-\x1F]/', $path)) { return false; } + return true; } } -if (!function_exists('splitInstallerPhpComposerTokens')) { +if (! function_exists('splitInstallerPhpComposerTokens')) { /** * 공백 분리 입력을 "PHP 인터프리터 절대경로 + Composer 바이너리 절대경로" 두 토큰으로 분해. * @@ -169,16 +171,16 @@ if (!function_exists('splitInstallerPhpComposerTokens')) { * 운영 의도를 지원한다. 두 토큰 모두 isInstallerExecutablePath 통과해야 * 정상 입력으로 간주. * - * @return array{php: string, composer: string}|null 분해 실패 시 null + * @return array{php: string, composer: string}|null 분해 실패 시 null */ function splitInstallerPhpComposerTokens(string $path): ?array { - if (!str_contains($path, ' ')) { + if (! str_contains($path, ' ')) { return null; } $tokens = preg_split('/\s+/', trim($path), 2); - if (!is_array($tokens) || count($tokens) !== 2) { + if (! is_array($tokens) || count($tokens) !== 2) { return null; } @@ -191,7 +193,7 @@ if (!function_exists('splitInstallerPhpComposerTokens')) { } } -if (!function_exists('getComposerCommand')) { +if (! function_exists('getComposerCommand')) { function getComposerCommand(): string { $state = getInstallationState(); @@ -206,17 +208,18 @@ if (!function_exists('getComposerCommand')) { if (str_contains($composerBinary, ' ')) { $tokens = splitInstallerPhpComposerTokens($composerBinary); if ($tokens === null - || !isInstallerExecutablePath($tokens['php']) - || !isInstallerExecutablePath($tokens['composer']) + || ! isInstallerExecutablePath($tokens['php']) + || ! isInstallerExecutablePath($tokens['composer']) ) { return 'composer'; } - return escapeshellarg($tokens['php']) . ' ' . escapeshellarg($tokens['composer']); + + return escapeshellarg($tokens['php']).' '.escapeshellarg($tokens['composer']); } // 검증 실패 시 시스템 기본 'composer' 로 폴백 — 설치 흐름은 유지하되 // 사용자 입력이 셸 명령으로 흘러가지 않도록 차단. - if (!isInstallerExecutablePath($composerBinary)) { + if (! isInstallerExecutablePath($composerBinary)) { return 'composer'; } @@ -225,14 +228,15 @@ if (!function_exists('getComposerCommand')) { $phpArg = ($phpBinary !== 'php' && isInstallerExecutablePath($phpBinary)) ? escapeshellarg($phpBinary) : escapeshellarg('php'); - return $phpArg . ' ' . escapeshellarg($composerBinary); + + return $phpArg.' '.escapeshellarg($composerBinary); } return escapeshellarg($composerBinary); } } -if (!function_exists('getComposerCommandForDisplay')) { +if (! function_exists('getComposerCommandForDisplay')) { function getComposerCommandForDisplay(): string { $state = getInstallationState(); @@ -246,34 +250,35 @@ if (!function_exists('getComposerCommandForDisplay')) { if (str_contains($composerBinary, ' ')) { $tokens = splitInstallerPhpComposerTokens($composerBinary); if ($tokens === null - || !isInstallerExecutablePath($tokens['php']) - || !isInstallerExecutablePath($tokens['composer']) + || ! isInstallerExecutablePath($tokens['php']) + || ! isInstallerExecutablePath($tokens['composer']) ) { return 'composer'; } - return $tokens['php'] . ' ' . $tokens['composer']; + + return $tokens['php'].' '.$tokens['composer']; } - if (!isInstallerExecutablePath($composerBinary)) { + if (! isInstallerExecutablePath($composerBinary)) { return 'composer'; } if (str_ends_with($composerBinary, '.phar')) { - return getPhpBinary() . ' ' . $composerBinary; + return getPhpBinary().' '.$composerBinary; } return $composerBinary; } } -if (!function_exists('vendorModeOptionFromState')) { +if (! function_exists('vendorModeOptionFromState')) { /** * 인스톨러 state 의 vendor_mode 를 artisan 옵션 문자열로 변환합니다. * * 사용자가 Step 3 에서 선택한 vendor_mode 를 module:install/plugin:install * 등 확장 설치 커맨드로 일관되게 전파하기 위함. * - * @return string ' --vendor-mode=bundled' 같은 문자열 (선행 공백 포함). 미설정 시 빈 문자열. + * @return string ' --vendor-mode=bundled' 같은 문자열 (선행 공백 포함). 미설정 시 빈 문자열. */ function vendorModeOptionFromState(): string { @@ -288,7 +293,7 @@ if (!function_exists('vendorModeOptionFromState')) { } } -if (!function_exists('checkComposerSSE')) { +if (! function_exists('checkComposerSSE')) { /** * Composer 가용성 확인. * @@ -323,24 +328,24 @@ if (!function_exists('checkComposerSSE')) { sendSSEEvent('log', ['message' => lang('log_task_in_progress', ['task' => $taskName])]); - $composerHome = BASE_PATH . '/storage/composer'; - if (!is_dir($composerHome)) { + $composerHome = BASE_PATH.'/storage/composer'; + if (! is_dir($composerHome)) { @mkdir($composerHome, 0755, true); } - putenv('COMPOSER_HOME=' . $composerHome); - putenv('HOME=' . $composerHome); + putenv('COMPOSER_HOME='.$composerHome); + putenv('HOME='.$composerHome); applyInstallerComposerEnvVars(); $output = []; $returnCode = 0; $composerCmd = getComposerCommand(); - exec($composerCmd . ' --version 2>&1', $output, $returnCode); + exec($composerCmd.' --version 2>&1', $output, $returnCode); if ($returnCode !== 0) { $errorMessage = implode("\n", $output); // auto 모드: composer 미설치 시 번들 폴백 가능하면 비치명적 처리 - if ($vendorMode === 'auto' && file_exists(BASE_PATH . '/vendor-bundle.zip')) { + if ($vendorMode === 'auto' && file_exists(BASE_PATH.'/vendor-bundle.zip')) { sendSSEEvent('log', ['message' => lang('log_composer_check_auto_fallback')]); sendSSEEvent('log', ['message' => lang('log_separator')]); markTaskCompleted('composer_check'); @@ -351,6 +356,7 @@ if (!function_exists('checkComposerSSE')) { sendSSEEvent('log', ['message' => lang('log_error_occurred', ['error' => $errorMessage])]); logInstallationError(lang('error_composer_not_installed')); + return [ 'success' => false, 'message' => lang('error_composer_not_installed'), @@ -373,13 +379,13 @@ if (!function_exists('checkComposerSSE')) { } } -if (!function_exists('installVendorBundleSSE')) { +if (! function_exists('installVendorBundleSSE')) { /** * vendor-bundle.zip 을 추출하여 vendor/ 를 구성합니다 (bundled 모드용). */ function installVendorBundleSSE(): array { - require_once __DIR__ . '/vendor-bundle-installer.php'; + require_once __DIR__.'/vendor-bundle-installer.php'; if (checkAbortStatusSSE()) { return ['success' => false, 'aborted' => true]; @@ -391,10 +397,11 @@ if (!function_exists('installVendorBundleSSE')) { sendSSEEvent('log', ['message' => 'Vendor 번들 추출을 시작합니다...']); $integrity = verifyVendorBundle(BASE_PATH); - if (!$integrity['valid']) { + if (! $integrity['valid']) { $errorList = implode(', ', $integrity['errors']); sendSSEEvent('log', ['message' => "번들 무결성 검증 실패: {$errorList}"]); logInstallationError("vendor-bundle.zip 무결성 검증 실패: {$errorList}"); + return [ 'success' => false, 'message' => "vendor-bundle.zip 무결성 검증 실패: {$errorList}", @@ -407,10 +414,11 @@ if (!function_exists('installVendorBundleSSE')) { $result = extractVendorBundle(BASE_PATH, BASE_PATH); - if (!$result['success']) { + if (! $result['success']) { $error = $result['error'] ?? 'unknown'; sendSSEEvent('log', ['message' => "vendor 번들 추출 실패: {$error}"]); logInstallationError("vendor 번들 추출 실패: {$error}"); + return [ 'success' => false, 'message' => "vendor 번들 추출 실패: {$error}", @@ -435,11 +443,11 @@ if (!function_exists('installVendorBundleSSE')) { } } -if (!function_exists('installComposerDependenciesSSE')) { +if (! function_exists('installComposerDependenciesSSE')) { function installComposerDependenciesSSE(): array { // Laravel compiled cache 정리 헬퍼(clearLaravelCompiledCache)가 정의된 shim - require_once __DIR__ . '/vendor-bundle-installer.php'; + require_once __DIR__.'/vendor-bundle-installer.php'; // Vendor 모드에 따라 분기: bundled → vendor-bundle.zip 추출 $state = getInstallationState(); @@ -454,10 +462,11 @@ if (!function_exists('installComposerDependenciesSSE')) { $composerBinary = $state['config']['composer_binary'] ?? ''; $phpBinary = $state['config']['php_binary'] ?? 'php'; - if (!canExecuteComposerForInstall($composerBinary, $phpBinary)) { + if (! canExecuteComposerForInstall($composerBinary, $phpBinary)) { // composer 사용 불가 → 번들 zip 존재 여부 확인 후 폴백 - if (file_exists(BASE_PATH . '/vendor-bundle.zip')) { + if (file_exists(BASE_PATH.'/vendor-bundle.zip')) { sendSSEEvent('log', ['message' => 'Composer 실행 불가 환경 감지 → 번들 vendor 모드로 자동 전환']); + return installVendorBundleSSE(); } } @@ -473,8 +482,8 @@ if (!function_exists('installComposerDependenciesSSE')) { sendSSEEvent('task_start', ['task' => 'composer_install', 'name' => $taskName]); sendSSEEvent('log', ['message' => lang('log_task_in_progress', ['task' => $taskName])]); - $vendorExists = is_dir(BASE_PATH . '/vendor') && file_exists(BASE_PATH . '/vendor/autoload.php'); - $lockExists = file_exists(BASE_PATH . '/composer.lock'); + $vendorExists = is_dir(BASE_PATH.'/vendor') && file_exists(BASE_PATH.'/vendor/autoload.php'); + $lockExists = file_exists(BASE_PATH.'/composer.lock'); if ($vendorExists && $lockExists) { sendSSEEvent('log', ['message' => lang('log_composer_already_installed')]); @@ -483,26 +492,27 @@ if (!function_exists('installComposerDependenciesSSE')) { markTaskCompleted('composer_install'); sendSSEEvent('task_complete', ['task' => 'composer_install', 'message' => lang('log_composer_already_installed')]); + return ['success' => true]; } - if ($vendorExists && !$lockExists) { + if ($vendorExists && ! $lockExists) { sendSSEEvent('log', ['message' => lang('log_composer_vendor_without_lock')]); sendSSEEvent('log', ['message' => lang('log_composer_removing_vendor')]); - $deleted = deleteDirectory(BASE_PATH . '/vendor'); - if (!$deleted) { + $deleted = deleteDirectory(BASE_PATH.'/vendor'); + if (! $deleted) { sendSSEEvent('log', ['message' => lang('log_composer_vendor_delete_failed')]); } else { sendSSEEvent('log', ['message' => lang('log_composer_vendor_deleted')]); } } - if (!$vendorExists && $lockExists) { + if (! $vendorExists && $lockExists) { sendSSEEvent('log', ['message' => lang('log_composer_installing_from_lock')]); } - if (!$vendorExists && !$lockExists) { + if (! $vendorExists && ! $lockExists) { sendSSEEvent('log', ['message' => lang('log_composer_fresh_install')]); } @@ -516,8 +526,8 @@ if (!function_exists('installComposerDependenciesSSE')) { chdir(BASE_PATH); - $composerHome = BASE_PATH . '/storage/composer'; - if (!is_dir($composerHome)) { + $composerHome = BASE_PATH.'/storage/composer'; + if (! is_dir($composerHome)) { @mkdir($composerHome, 0755, true); } @@ -535,9 +545,9 @@ if (!function_exists('installComposerDependenciesSSE')) { $env = array_merge($env, buildInstallerComposerEnv()); if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') { - if (!isset($env['TEMP']) || !is_dir($env['TEMP']) || !is_writable($env['TEMP'])) { - $tempDir = BASE_PATH . '/storage/temp'; - if (!is_dir($tempDir)) { + if (! isset($env['TEMP']) || ! is_dir($env['TEMP']) || ! is_writable($env['TEMP'])) { + $tempDir = BASE_PATH.'/storage/temp'; + if (! is_dir($tempDir)) { @mkdir($tempDir, 0755, true); } $env['TEMP'] = $tempDir; @@ -553,15 +563,16 @@ if (!function_exists('installComposerDependenciesSSE')) { $composerCmd = getComposerCommand(); $process = proc_open( - $composerCmd . ' install --no-interaction --no-dev --optimize-autoloader --no-ansi 2>&1', + $composerCmd.' install --no-interaction --no-dev --optimize-autoloader --no-ansi 2>&1', $descriptorspec, $pipes, BASE_PATH, $env ); - if (!is_resource($process)) { + if (! is_resource($process)) { logInstallationError(lang('error_composer_install_failed')); + return [ 'success' => false, 'message' => lang('error_composer_install_failed'), @@ -573,17 +584,26 @@ if (!function_exists('installComposerDependenciesSSE')) { fclose($pipes[0]); stream_set_blocking($pipes[1], false); - while (!feof($pipes[1])) { + while (! feof($pipes[1])) { if (checkAbortStatusSSE()) { proc_terminate($process); proc_close($process); + return ['success' => false, 'aborted' => true]; } $line = fgets($pipes[1]); if ($line !== false) { $line = trim($line); - if (!empty($line)) { + // composer stdout 이 시스템 코드페이지(Windows CP949 등)로 출력하거나 + // 진행바(\r 갱신)가 non-blocking 읽기와 겹쳐 임의 바이트 경계에서 잘리면 + // invalid UTF-8 바이트가 섞인다. SSE 응답(progress-emitter 의 json_encode)과 + // 폴링 응답(state-management) 양쪽이 무력화되지 않도록 로그 전송 전 정규화한다. + // (gnuboard/g7#62 — addLog 최종 방어와 이중 안전망) + if ($line !== '' && ! mb_check_encoding($line, 'UTF-8')) { + $line = mb_scrub($line, 'UTF-8'); + } + if (! empty($line)) { sendSSEEvent('log', ['message' => $line]); } } @@ -596,6 +616,7 @@ if (!function_exists('installComposerDependenciesSSE')) { if ($returnCode !== 0) { logInstallationError(lang('error_composer_install_failed')); + return [ 'success' => false, 'message' => lang('error_composer_install_failed'), @@ -614,7 +635,7 @@ if (!function_exists('installComposerDependenciesSSE')) { } } -if (!function_exists('updateEnvFileSSE')) { +if (! function_exists('updateEnvFileSSE')) { /** * 동적 설정(DB 자격증명) 을 storage/installer/runtime.php 에 작성한다. * @@ -640,9 +661,10 @@ if (!function_exists('updateEnvFileSSE')) { sendSSEEvent('log', ['message' => lang('log_task_in_progress', ['task' => $taskName])]); // .env.example 존재 여부만 확인 — finalize 단계에서 generateEnvContent() 가 사용 - $envExamplePath = BASE_PATH . '/.env.example'; - if (!file_exists($envExamplePath)) { + $envExamplePath = BASE_PATH.'/.env.example'; + if (! file_exists($envExamplePath)) { logInstallationError(lang('error_env_example_not_found')); + return [ 'success' => false, 'message' => lang('error_env_example_not_found'), @@ -655,8 +677,9 @@ if (!function_exists('updateEnvFileSSE')) { $runtime = buildInstallerRuntimeFromState($stateConfig); - if (!writeInstallerRuntime($runtime)) { + if (! writeInstallerRuntime($runtime)) { logInstallationError(lang('error_env_write_failed', ['path' => INSTALLER_RUNTIME_PATH])); + return [ 'success' => false, 'message' => lang('error_env_write_failed', ['path' => INSTALLER_RUNTIME_PATH]), @@ -675,7 +698,7 @@ if (!function_exists('updateEnvFileSSE')) { } } -if (!function_exists('generateApplicationKeySSE')) { +if (! function_exists('generateApplicationKeySSE')) { /** * APP_KEY 를 pure PHP 로 생성하여 runtime.php 에 기록한다. * @@ -694,7 +717,7 @@ if (!function_exists('generateApplicationKeySSE')) { } // 재시도 경로 방어 — composer_install 재진입 시 stale bootstrap/cache 정리 - require_once __DIR__ . '/vendor-bundle-installer.php'; + require_once __DIR__.'/vendor-bundle-installer.php'; clearLaravelCompiledCache(BASE_PATH); $taskName = lang('task_key_generate'); @@ -725,8 +748,9 @@ if (!function_exists('generateApplicationKeySSE')) { $runtime['app']['key'] = $key; $runtime['created_at'] = $runtime['created_at'] ?? date('c'); - if (!writeInstallerRuntime($runtime)) { + if (! writeInstallerRuntime($runtime)) { logInstallationError(lang('error_key_generate_failed')); + return [ 'success' => false, 'message' => lang('error_key_generate_failed'), @@ -745,7 +769,7 @@ if (!function_exists('generateApplicationKeySSE')) { } } -if (!function_exists('dependencyPrecheckSSE')) { +if (! function_exists('dependencyPrecheckSSE')) { /** * 의존성 사전 검증 (백엔드 안전망). * @@ -777,13 +801,13 @@ if (!function_exists('dependencyPrecheckSSE')) { // 확장 매니페스트 읽기 (모듈/플러그인 — 템플릿은 dependencies 사용 빈도 낮음) $scanTargets = [ - 'modules' => BASE_PATH . '/modules/_bundled', - 'plugins' => BASE_PATH . '/plugins/_bundled', - 'templates' => BASE_PATH . '/templates/_bundled', + 'modules' => BASE_PATH.'/modules/_bundled', + 'plugins' => BASE_PATH.'/plugins/_bundled', + 'templates' => BASE_PATH.'/templates/_bundled', ]; foreach ($scanTargets as $type => $baseDir) { - if (!is_dir($baseDir)) { + if (! is_dir($baseDir)) { continue; } $dirs = scandir($baseDir) ?: []; @@ -799,23 +823,23 @@ if (!function_exists('dependencyPrecheckSSE')) { } elseif ($type === 'templates' && file_exists("{$baseDir}/{$dir}/template.json")) { $manifestFile = "{$baseDir}/{$dir}/template.json"; } - if (!$manifestFile) { + if (! $manifestFile) { continue; } $data = json_decode((string) @file_get_contents($manifestFile), true); - if (!is_array($data)) { + if (! is_array($data)) { continue; } $identifier = $data['identifier'] ?? $dir; // 선택된 확장만 검증 대상 - if (!isset($selectedIdSet[$identifier])) { + if (! isset($selectedIdSet[$identifier])) { continue; } $deps = $data['dependencies'] ?? []; - if (!is_array($deps)) { + if (! is_array($deps)) { continue; } @@ -831,7 +855,7 @@ if (!function_exists('dependencyPrecheckSSE')) { $check[] = is_int($depId) ? $_ : $depId; } } - if (!isset($deps['modules']) && !isset($deps['plugins'])) { + if (! isset($deps['modules']) && ! isset($deps['plugins'])) { foreach ($deps as $depId) { if (is_string($depId)) { $check[] = $depId; @@ -840,19 +864,20 @@ if (!function_exists('dependencyPrecheckSSE')) { } foreach ($check as $depId) { - if (!isset($selectedIdSet[$depId])) { + if (! isset($selectedIdSet[$depId])) { $missing[] = "{$identifier} → {$depId}"; } } } } - if (!empty($missing)) { + if (! empty($missing)) { $errorMessage = lang('dependency_precheck_failed'); foreach ($missing as $line) { - sendSSEEvent('log', ['message' => ' - ' . $line]); + sendSSEEvent('log', ['message' => ' - '.$line]); } logInstallationError($errorMessage); + return [ 'success' => false, 'message' => $errorMessage, @@ -871,7 +896,7 @@ if (!function_exists('dependencyPrecheckSSE')) { } } -if (!function_exists('cleanupExistingTablesSSE')) { +if (! function_exists('cleanupExistingTablesSSE')) { /** * 기존 DB 테이블 정리. * @@ -902,6 +927,7 @@ if (!function_exists('cleanupExistingTablesSSE')) { sendSSEEvent('log', ['message' => lang('log_separator')]); markTaskCompleted('db_cleanup'); sendSSEEvent('task_complete', ['task' => 'db_cleanup', 'message' => lang('log_db_cleanup_skipped')]); + return ['success' => true]; } @@ -926,7 +952,7 @@ if (!function_exists('cleanupExistingTablesSSE')) { $pdo->exec('SET FOREIGN_KEY_CHECKS = 0'); foreach ($tables as $table) { - $quoted = '`' . str_replace('`', '``', $table) . '`'; + $quoted = '`'.str_replace('`', '``', $table).'`'; $pdo->exec("DROP TABLE IF EXISTS {$quoted}"); sendSSEEvent('log', ['message' => " - DROP TABLE {$table}"]); } @@ -944,6 +970,7 @@ if (!function_exists('cleanupExistingTablesSSE')) { return ['success' => true]; } catch (Exception $e) { logInstallationError(lang('error_db_cleanup_failed'), $e); + return [ 'success' => false, 'message' => lang('error_db_cleanup_failed'), @@ -954,7 +981,7 @@ if (!function_exists('cleanupExistingTablesSSE')) { } } -if (!function_exists('runDatabaseMigrationSSE')) { +if (! function_exists('runDatabaseMigrationSSE')) { function runDatabaseMigrationSSE(): array { return executeDbCommandSSE( @@ -967,7 +994,7 @@ if (!function_exists('runDatabaseMigrationSSE')) { } } -if (!function_exists('runDatabaseSeedingSSE')) { +if (! function_exists('runDatabaseSeedingSSE')) { function runDatabaseSeedingSSE(): array { $state = getInstallationState(); @@ -977,10 +1004,10 @@ if (!function_exists('runDatabaseSeedingSSE')) { return ['success' => false, 'error' => '관리자 이메일과 비밀번호가 설정되지 않았습니다.']; } - putenv('INSTALLER_ADMIN_NAME=' . ($config['admin_name'] ?? 'Administrator')); - putenv('INSTALLER_ADMIN_EMAIL=' . $config['admin_email']); - putenv('INSTALLER_ADMIN_PASSWORD=' . $config['admin_password']); - putenv('INSTALLER_ADMIN_LANGUAGE=' . ($config['admin_language'] ?? $state['g7_locale'] ?? 'ko')); + putenv('INSTALLER_ADMIN_NAME='.($config['admin_name'] ?? 'Administrator')); + putenv('INSTALLER_ADMIN_EMAIL='.$config['admin_email']); + putenv('INSTALLER_ADMIN_PASSWORD='.$config['admin_password']); + putenv('INSTALLER_ADMIN_LANGUAGE='.($config['admin_language'] ?? $state['g7_locale'] ?? 'ko')); return executeDbCommandSSE( artisanCommand: 'db:seed --force', @@ -992,10 +1019,11 @@ if (!function_exists('runDatabaseSeedingSSE')) { } } -if (!function_exists('getSelectedExtensions')) { +if (! function_exists('getSelectedExtensions')) { function getSelectedExtensions(): array { $state = getInstallationState(); + return $state['selected_extensions'] ?? [ 'admin_templates' => [], 'user_templates' => [], @@ -1006,7 +1034,7 @@ if (!function_exists('getSelectedExtensions')) { } } -if (!function_exists('reserveCommandOutputFile')) { +if (! function_exists('reserveCommandOutputFile')) { /** * artisan 명령 stdout/stderr redirect 용 임시 로그 파일 경로 예약. * @@ -1027,7 +1055,7 @@ if (!function_exists('reserveCommandOutputFile')) { ]; foreach ($candidates as $dir) { - if (!is_dir($dir)) { + if (! is_dir($dir)) { @mkdir($dir, 0755, true); } if (is_dir($dir) && is_writable($dir)) { @@ -1041,7 +1069,7 @@ if (!function_exists('reserveCommandOutputFile')) { } } -if (!function_exists('executeArtisanCommandSSE')) { +if (! function_exists('executeArtisanCommandSSE')) { function executeArtisanCommandSSE( string $artisanCommand, string $taskId, @@ -1066,7 +1094,7 @@ if (!function_exists('executeArtisanCommandSSE')) { $cmdLogFile = reserveCommandOutputFile(); $fullCommand = "{$phpBin} -d memory_limit=512M artisan {$artisanCommand} > " - . escapeshellarg($cmdLogFile) . " 2>&1"; + .escapeshellarg($cmdLogFile).' 2>&1'; exec($fullCommand, $_ignored, $returnCode); if (file_exists($cmdLogFile)) { @@ -1075,7 +1103,7 @@ if (!function_exists('executeArtisanCommandSSE')) { } foreach ($output as $line) { - if (!empty(trim($line))) { + if (! empty(trim($line))) { sendSSEEvent('log', ['message' => $line]); } } @@ -1083,6 +1111,7 @@ if (!function_exists('executeArtisanCommandSSE')) { if ($returnCode !== 0) { $errorMessage = implode("\n", $output); logInstallationError(lang($errorMsgKey), new Exception($errorMessage)); + return [ 'success' => false, 'message' => lang($errorMsgKey), @@ -1101,7 +1130,7 @@ if (!function_exists('executeArtisanCommandSSE')) { } } -if (!function_exists('executeDbCommandSSE')) { +if (! function_exists('executeDbCommandSSE')) { function executeDbCommandSSE( string $artisanCommand, string $taskId, @@ -1114,6 +1143,7 @@ if (!function_exists('executeDbCommandSSE')) { if ($wasAborted) { addLog(lang('db_task_abort_detected_before_start')); + return ['success' => false, 'aborted' => true]; } @@ -1130,7 +1160,7 @@ if (!function_exists('executeDbCommandSSE')) { $cmdLogFile = reserveCommandOutputFile(); $fullCommand = "{$phpBin} -d memory_limit=512M artisan {$artisanCommand} > " - . escapeshellarg($cmdLogFile) . " 2>&1"; + .escapeshellarg($cmdLogFile).' 2>&1'; exec($fullCommand, $_ignored, $returnCode); @@ -1140,7 +1170,7 @@ if (!function_exists('executeDbCommandSSE')) { } foreach ($output as $line) { - if (!empty(trim($line))) { + if (! empty(trim($line))) { sendSSEEvent('log', ['message' => $line]); } } @@ -1220,7 +1250,7 @@ if (!function_exists('executeDbCommandSSE')) { } } -if (!function_exists('executeExtensionCommandSSE')) { +if (! function_exists('executeExtensionCommandSSE')) { function executeExtensionCommandSSE( string $artisanCommand, string $taskId, @@ -1263,7 +1293,7 @@ if (!function_exists('executeExtensionCommandSSE')) { $cmdLogFile = reserveCommandOutputFile(); $fullCommand = "{$phpBin} -d memory_limit=512M artisan {$artisanCommand} > " - . escapeshellarg($cmdLogFile) . " 2>&1"; + .escapeshellarg($cmdLogFile).' 2>&1'; exec($fullCommand, $_ignored, $returnCode); @@ -1289,7 +1319,7 @@ if (!function_exists('executeExtensionCommandSSE')) { $emitter->emit('heartbeat', []); } else { foreach ($output as $line) { - if (!empty(trim($line))) { + if (! empty(trim($line))) { sendSSEEvent('log', ['message' => $line]); } } @@ -1306,9 +1336,10 @@ if (!function_exists('executeExtensionCommandSSE')) { } } - if ($returnCode !== 0 && !$isAlreadyExists) { + if ($returnCode !== 0 && ! $isAlreadyExists) { $errorMessage = $outputText; logInstallationError(lang($errorMsgKey), new Exception($errorMessage)); + return [ 'success' => false, 'message' => lang($errorMsgKey), @@ -1338,7 +1369,7 @@ if (!function_exists('executeExtensionCommandSSE')) { } } -if (!function_exists('installAdminTemplateSSE')) { +if (! function_exists('installAdminTemplateSSE')) { function installAdminTemplateSSE(string $templateId): array { return executeExtensionCommandSSE( @@ -1352,7 +1383,7 @@ if (!function_exists('installAdminTemplateSSE')) { } } -if (!function_exists('activateAdminTemplateSSE')) { +if (! function_exists('activateAdminTemplateSSE')) { function activateAdminTemplateSSE(string $templateId): array { return executeExtensionCommandSSE( @@ -1366,7 +1397,7 @@ if (!function_exists('activateAdminTemplateSSE')) { } } -if (!function_exists('installModuleSSE')) { +if (! function_exists('installModuleSSE')) { function installModuleSSE(string $moduleId): array { $vendorModeOpt = vendorModeOptionFromState(); @@ -1382,7 +1413,7 @@ if (!function_exists('installModuleSSE')) { } } -if (!function_exists('activateModuleSSE')) { +if (! function_exists('activateModuleSSE')) { function activateModuleSSE(string $moduleId): array { return executeExtensionCommandSSE( @@ -1396,7 +1427,7 @@ if (!function_exists('activateModuleSSE')) { } } -if (!function_exists('installPluginSSE')) { +if (! function_exists('installPluginSSE')) { function installPluginSSE(string $pluginId): array { $vendorModeOpt = vendorModeOptionFromState(); @@ -1412,7 +1443,7 @@ if (!function_exists('installPluginSSE')) { } } -if (!function_exists('activatePluginSSE')) { +if (! function_exists('activatePluginSSE')) { function activatePluginSSE(string $pluginId): array { return executeExtensionCommandSSE( @@ -1426,7 +1457,7 @@ if (!function_exists('activatePluginSSE')) { } } -if (!function_exists('installUserTemplateSSE')) { +if (! function_exists('installUserTemplateSSE')) { function installUserTemplateSSE(string $templateId): array { return executeExtensionCommandSSE( @@ -1440,7 +1471,7 @@ if (!function_exists('installUserTemplateSSE')) { } } -if (!function_exists('activateUserTemplateSSE')) { +if (! function_exists('activateUserTemplateSSE')) { function activateUserTemplateSSE(string $templateId): array { return executeExtensionCommandSSE( @@ -1454,7 +1485,7 @@ if (!function_exists('activateUserTemplateSSE')) { } } -if (!function_exists('installLanguagePackSSE')) { +if (! function_exists('installLanguagePackSSE')) { /** * 번들 언어팩 설치 (best-effort). * @@ -1478,7 +1509,7 @@ if (!function_exists('installLanguagePackSSE')) { } } -if (!function_exists('clearCacheSSE')) { +if (! function_exists('clearCacheSSE')) { function clearCacheSSE(): array { return executeArtisanCommandSSE( @@ -1491,7 +1522,7 @@ if (!function_exists('clearCacheSSE')) { } } -if (!function_exists('optimizeConfigCacheSSE')) { +if (! function_exists('optimizeConfigCacheSSE')) { /** * 설치 완료 직후 config 캐시를 최초 생성한다. * @@ -1513,7 +1544,7 @@ if (!function_exists('optimizeConfigCacheSSE')) { } } -if (!function_exists('createSettingsJsonSSE')) { +if (! function_exists('createSettingsJsonSSE')) { function createSettingsJsonSSE(): array { if (checkAbortStatusSSE()) { @@ -1528,22 +1559,22 @@ if (!function_exists('createSettingsJsonSSE')) { sendSSEEvent('log', ['message' => lang('log_creating_settings')]); try { - $settingsDir = BASE_PATH . '/storage/app/settings'; + $settingsDir = BASE_PATH.'/storage/app/settings'; - if (!is_dir($settingsDir)) { + if (! is_dir($settingsDir)) { mkdir($settingsDir, 0755, true); } - $defaultsFile = BASE_PATH . '/config/settings/defaults.json'; - if (!file_exists($defaultsFile)) { - throw new Exception('defaults.json file not found: ' . $defaultsFile); + $defaultsFile = BASE_PATH.'/config/settings/defaults.json'; + if (! file_exists($defaultsFile)) { + throw new Exception('defaults.json file not found: '.$defaultsFile); } $defaultsContent = file_get_contents($defaultsFile); $defaultsData = json_decode($defaultsContent, true); if (json_last_error() !== JSON_ERROR_NONE) { - throw new Exception('defaults.json JSON parsing failed: ' . json_last_error_msg()); + throw new Exception('defaults.json JSON parsing failed: '.json_last_error_msg()); } $defaults = $defaultsData['defaults'] ?? []; @@ -1556,30 +1587,31 @@ if (!function_exists('createSettingsJsonSSE')) { $state = getInstallationState(); $config = $state['config'] ?? []; - if (!empty($config['app_name'])) { + if (! empty($config['app_name'])) { $defaults['general']['site_name'] = $config['app_name']; $defaults['mail']['from_name'] = $config['app_name']; } - if (!empty($config['app_url'])) { + if (! empty($config['app_url'])) { $defaults['general']['site_url'] = $config['app_url']; } - if (!empty($config['admin_email'])) { + if (! empty($config['admin_email'])) { $defaults['general']['admin_email'] = $config['admin_email']; $defaults['mail']['from_address'] = $config['admin_email']; } - if (!empty($config['core_update_github_url'])) { + if (! empty($config['core_update_github_url'])) { $defaults['core_update']['github_url'] = $config['core_update_github_url']; } - if (!empty($config['core_update_github_token'])) { + if (! empty($config['core_update_github_token'])) { $defaults['core_update']['github_token'] = $config['core_update_github_token']; } $defaults['general']['language'] = getCurrentLanguage(); foreach ($categories as $category) { - if (!isset($defaults[$category])) { + if (! isset($defaults[$category])) { sendSSEEvent('log', ['message' => " - {$category}.json skipped (no defaults)"]); + continue; } @@ -1593,7 +1625,7 @@ if (!function_exists('createSettingsJsonSSE')) { $data = array_merge($data, $settings); $json = json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE); - $filePath = $settingsDir . '/' . $category . '.json'; + $filePath = $settingsDir.'/'.$category.'.json'; file_put_contents($filePath, $json, LOCK_EX); sendSSEEvent('log', ['message' => " - {$category}.json created"]); @@ -1609,6 +1641,7 @@ if (!function_exists('createSettingsJsonSSE')) { return ['success' => true]; } catch (Exception $e) { logInstallationError(lang('error_settings_json_failed'), $e); + return [ 'success' => false, 'message' => lang('error_settings_json_failed'), @@ -1619,7 +1652,7 @@ if (!function_exists('createSettingsJsonSSE')) { } } -if (!function_exists('setInstallationCompleteSSE')) { +if (! function_exists('setInstallationCompleteSSE')) { function setInstallationCompleteSSE(): array { if (checkAbortStatusSSE()) { @@ -1638,10 +1671,10 @@ if (!function_exists('setInstallationCompleteSSE')) { // 진행 중 재시작을 일으키지 않도록 한다. g7_installed 파일과 state.json // 의 completed 마커만으로 "Step 5 완료" 시점을 보장. - $installedFlagPath = BASE_PATH . '/storage/app/g7_installed'; + $installedFlagPath = BASE_PATH.'/storage/app/g7_installed'; $installedFlagDir = dirname($installedFlagPath); - if (!is_dir($installedFlagDir)) { + if (! is_dir($installedFlagDir)) { @mkdir($installedFlagDir, 0775, true); } @@ -1651,7 +1684,7 @@ if (!function_exists('setInstallationCompleteSSE')) { // 인스톨러 작업 중 composer install 등이 storage/temp 에 남긴 Symfony Process // sf_proc_*.{out,err,lock} 잔여 파일 정리. 디렉토리 자체는 보존 (다음 사용 대비). - $tempDir = BASE_PATH . '/storage/temp'; + $tempDir = BASE_PATH.'/storage/temp'; if (is_dir($tempDir)) { $entries = @scandir($tempDir); if (is_array($entries)) { @@ -1659,7 +1692,7 @@ if (!function_exists('setInstallationCompleteSSE')) { if ($entry === '.' || $entry === '..') { continue; } - $entryPath = $tempDir . '/' . $entry; + $entryPath = $tempDir.'/'.$entry; if (is_file($entryPath)) { @unlink($entryPath); } @@ -1689,6 +1722,7 @@ if (!function_exists('setInstallationCompleteSSE')) { return ['success' => true]; } catch (Exception $e) { logInstallationError(lang('error_complete_flag_failed'), $e); + return [ 'success' => false, 'message' => lang('error_complete_flag_failed'), @@ -1703,7 +1737,7 @@ if (!function_exists('setInstallationCompleteSSE')) { // 메인 실행 로직 // ============================================================================ -if (!function_exists('runInstallationTasks')) { +if (! function_exists('runInstallationTasks')) { /** * 설치 작업 전체 실행. * @@ -1791,6 +1825,7 @@ if (!function_exists('runInstallationTasks')) { 'target' => $task['target'] ?? null, ]); addLog(lang('abort_installation_stopped')); + return; } @@ -1812,6 +1847,7 @@ if (!function_exists('runInstallationTasks')) { 'target' => $target, 'message' => lang('log_already_completed', ['task' => $displayName]), ]); + continue; } @@ -1824,15 +1860,17 @@ if (!function_exists('runInstallationTasks')) { 'target' => $target, ]); addLog(lang('abort_installation_stopped')); + return; } - if (!$result['success']) { + if (! $result['success']) { // best-effort task (예: 번들 언어팩 설치) — 실패 시 경고 로그만 남기고 계속 진행 if ($bestEffort) { $warnMsg = lang('warning_language_pack_install_partial', ['identifier' => (string) $target]); sendSSEEvent('log', ['message' => $warnMsg]); addLog($warnMsg); + // task_complete 이벤트는 보내지 않고 다음 task 로 진행 (재시도 시 다시 시도 가능) continue; } @@ -1891,7 +1929,7 @@ if (!function_exists('runInstallationTasks')) { $state['error_message_key'] = $result['message_key'] ?? null; $state['error_detail'] = $result['detail'] ?? null; - if (!empty($result['rollback_done'])) { + if (! empty($result['rollback_done'])) { $state['rollback_failure'] = $result['rollback_failure'] ?? null; } else { $state['rollback_failure'] = $rollbackFailure ?? null; @@ -1907,7 +1945,7 @@ if (!function_exists('runInstallationTasks')) { 'message' => $result['message'] ?? lang('log_installation_failed'), ])); - if (!empty($manualCommands)) { + if (! empty($manualCommands)) { sendSSEEvent('log', ['message' => lang('log_separator')]); sendSSEEvent('log', ['message' => lang('manual_commands_guide')]); foreach ($manualCommands as $cmd) { @@ -1924,6 +1962,7 @@ if (!function_exists('runInstallationTasks')) { 'target' => $target, 'manual_commands' => $manualCommands, ]); + return; } } diff --git a/resources/js/core/TemplateApp.ts b/resources/js/core/TemplateApp.ts index 0e5099e0..e2b5729e 100644 --- a/resources/js/core/TemplateApp.ts +++ b/resources/js/core/TemplateApp.ts @@ -26,7 +26,7 @@ import { getErrorHandlingResolver } from './error'; import type { ErrorHandlingMap } from './types/ErrorHandling'; import { createLogger, Logger } from './utils/Logger'; import { webSocketManager } from './websocket/WebSocketManager'; -import { getModuleAssetLoader, parseModuleAssetsFromConfig, parsePluginAssetsFromConfig } from './modules'; +import { getModuleAssetLoader, parseModuleAssetsFromConfig, parsePluginAssetsFromConfig, parseBundleUrlsFromConfig } from './modules'; import { SystemBannerManager } from './template-engine/SystemBannerManager'; /** * DevTools 추적 - G7DevToolsCore.getInstance() 직접 호출 대신 G7Core.devTools를 사용합니다. @@ -722,41 +722,64 @@ export class TemplateApp { } /** - * 모듈/플러그인 에셋 로드 + * 모듈/플러그인 에셋 로드 (서버측 병합 번들) * - * window.G7Config.moduleAssets 및 pluginAssets에서 에셋 정보를 읽어 - * 동적으로 JS/CSS를 로드합니다. + * window.G7Config.bundleUrls 에서 병합 번들 URL 을 읽어 모듈 번들 → + * 플러그인 번들 순으로 로드한다. 각 번들은 활성 확장 IIFE 를 priority 순으로 + * 이어붙인 단일 파일이며, 로드 즉시 각 IIFE 가 자가등록(핸들러/리스너)을 + * 실행한다. 개별 로딩(loadActiveExtensionAssets)과 실행 계약은 동일하다. * - * 모듈 JS는 IIFE 형태로 빌드되어 로드 즉시 initModule()이 실행되고, - * ActionDispatcher에 핸들러가 등록됩니다. + * 모듈 → 플러그인 순서를 유지하는 이유: gdpr preblocker 등 인터셉터가 + * 플러그인 번들 내 priority 최상단으로 오되 모듈보다는 뒤에 실행된다 + * (2번들 구조). bundleUrls 가 없으면(구버전 blade) 개별 로딩으로 폴백한다. + * + * @since engine-v1.52.0 (서버측 번들 로딩으로 전환) */ private async loadExtensionAssets(): Promise { try { const moduleAssetLoader = getModuleAssetLoader(); + const bundleUrls = parseBundleUrlsFromConfig(); - // 모듈 에셋 로드 - const moduleAssets = parseModuleAssetsFromConfig(); - if (moduleAssets.length > 0) { - logger.log('Loading module assets:', moduleAssets.map(m => m.identifier)); - await moduleAssetLoader.loadActiveExtensionAssets(moduleAssets); + // bundleUrls 부재 시 개별 로딩 폴백 (회귀 안전) + if (!bundleUrls) { + await this.loadExtensionAssetsIndividually(); + return; } - // 플러그인 에셋 로드 - const pluginAssets = parsePluginAssetsFromConfig(); - if (pluginAssets.length > 0) { - logger.log('Loading plugin assets:', pluginAssets.map(p => p.identifier)); - await moduleAssetLoader.loadActiveExtensionAssets(pluginAssets); - } + // 모듈 번들 → 플러그인 번들 순서 (gdpr 는 플러그인 번들 내 최상단) + await moduleAssetLoader.loadBundle('module', bundleUrls.moduleJs, bundleUrls.moduleCss); + await moduleAssetLoader.loadBundle('plugin', bundleUrls.pluginJs, bundleUrls.pluginCss); - if (moduleAssets.length > 0 || pluginAssets.length > 0) { - logger.log('Extension assets loaded successfully'); - } + logger.log('Extension bundle assets loaded successfully'); } catch (error) { // 에셋 로드 실패는 경고만 출력하고 앱 계속 진행 logger.warn('Failed to load extension assets:', error); } } + /** + * 개별 확장 에셋 로드 (bundleUrls 부재 시 폴백) + * + * window.G7Config.moduleAssets/pluginAssets 에서 확장별 개별 URL 을 읽어 + * priority 순으로 각각 로드한다. 서버측 번들이 준비되지 않은 구버전 blade + * 환경 회귀 안전용. + */ + private async loadExtensionAssetsIndividually(): Promise { + const moduleAssetLoader = getModuleAssetLoader(); + + const moduleAssets = parseModuleAssetsFromConfig(); + if (moduleAssets.length > 0) { + logger.log('Loading module assets (individual fallback):', moduleAssets.map(m => m.identifier)); + await moduleAssetLoader.loadActiveExtensionAssets(moduleAssets); + } + + const pluginAssets = parsePluginAssetsFromConfig(); + if (pluginAssets.length > 0) { + logger.log('Loading plugin assets (individual fallback):', pluginAssets.map(p => p.identifier)); + await moduleAssetLoader.loadActiveExtensionAssets(pluginAssets); + } + } + /** * 라우트 변경 핸들러 */ diff --git a/resources/js/core/modules/ModuleAssetLoader.ts b/resources/js/core/modules/ModuleAssetLoader.ts index 87e359f2..f538f3ef 100644 --- a/resources/js/core/modules/ModuleAssetLoader.ts +++ b/resources/js/core/modules/ModuleAssetLoader.ts @@ -96,6 +96,121 @@ export class ModuleAssetLoader { logger.log('All module assets loaded successfully'); } + /** + * 서버측에서 병합된 확장 번들(JS/CSS)을 로드합니다. + * + * 활성 모듈/플러그인 IIFE 를 priority 순으로 이어붙인 단일 파일을 하나의 + * `