argument('identifier'); $buildAll = $this->option('all'); $watchMode = $this->option('watch'); $productionMode = $this->option('production'); if (! $identifier && ! $buildAll) { $this->error('❌ 모듈 식별자를 지정하거나 --all 옵션을 사용하세요.'); $this->line(''); $this->line('사용법:'); $this->line(' php artisan module:build sirsoft-ecommerce'); $this->line(' php artisan module:build --all'); $this->line(' php artisan module:build sirsoft-ecommerce --watch'); $this->line(' php artisan module:build --all --production'); $this->line(' php artisan module:build sirsoft-ecommerce --active'); return Command::FAILURE; } try { // 모듈 로드 $this->moduleManager->loadModules(); if ($buildAll) { return $this->buildAllModules($productionMode); } return $this->buildModule($identifier, $watchMode, $productionMode); } catch (\Exception $e) { $this->error('❌ '.$e->getMessage()); Log::error('모듈 빌드 실패', [ 'module' => $identifier ?? 'all', 'error' => $e->getMessage(), ]); return Command::FAILURE; } } /** * 빌드 대상 경로를 결정합니다. * * 기본값: _bundled 디렉토리. --active 옵션 시 활성 디렉토리. * --watch 모드에서는 활성 디렉토리를 사용합니다 (실시간 개발용). * * @param string $identifier 모듈 식별자 * @return array|null ['path' => string, 'source' => 'bundled'|'active'] 또는 null */ private function resolveBuildPath(string $identifier): ?array { $bundledPath = base_path("modules/_bundled/{$identifier}"); $activePath = base_path("modules/{$identifier}"); // --active 명시 → 활성 디렉토리 if ($this->option('active')) { return is_dir($activePath) ? ['path' => $activePath, 'source' => 'active'] : null; } // --watch 모드 → 활성 디렉토리 (실시간 개발용) if ($this->option('watch')) { if (is_dir($activePath)) { return ['path' => $activePath, 'source' => 'active']; } } // 기본값: _bundled 우선 if (is_dir($bundledPath)) { return ['path' => $bundledPath, 'source' => 'bundled']; } // _bundled에 없으면 활성 디렉토리 폴백 if (is_dir($activePath)) { return ['path' => $activePath, 'source' => 'active']; } return null; } /** * 단일 모듈 빌드 * * @param string $identifier 모듈 식별자 * @param bool $watchMode 파일 감시 모드 * @param bool $productionMode 프로덕션 빌드 * @return int 명령 실행 결과 코드 */ private function buildModule(string $identifier, bool $watchMode, bool $productionMode): int { // 경로 결정 $resolved = $this->resolveBuildPath($identifier); if (! $resolved) { $this->error("❌ 모듈을 찾을 수 없습니다: {$identifier}"); $this->line(' _bundled 및 활성 디렉토리 모두 존재하지 않습니다.'); return Command::FAILURE; } $buildPath = $resolved['path']; $source = $resolved['source']; // 소스 표시 $sourceLabel = $source === 'bundled' ? '_bundled' : '활성'; $this->info("📂 빌드 소스: {$sourceLabel} ({$buildPath})"); // package.json 존재 확인 $packageJsonPath = $buildPath.'/package.json'; if (! file_exists($packageJsonPath)) { $this->error('❌ package.json 파일이 없습니다: '.$packageJsonPath); $this->line(' 모듈 프론트엔드 구조를 먼저 생성하세요.'); return Command::FAILURE; } // 에셋 빌드 가능 여부 확인 (활성 모듈 인스턴스가 있는 경우) $module = $this->moduleManager->getModule($identifier); if ($module && ! $module->canBuild() && ! $module->hasAssets()) { $this->warn('⚠️ 모듈에 빌드할 에셋이 없습니다: '.$identifier); return Command::SUCCESS; } // node_modules 확인 및 설치 if (! is_dir($buildPath.'/node_modules')) { $this->info('📦 의존성 설치 중...'); $installResult = $this->runNpmCommand(['npm', 'install'], $buildPath); if ($installResult !== Command::SUCCESS) { $this->error('❌ npm install 실패'); return Command::FAILURE; } } // 빌드 명령 결정 $buildCommand = ['npm', 'run']; if ($watchMode) { $buildCommand[] = 'dev'; $this->info("👀 파일 감시 모드로 빌드 시작: {$identifier}"); $this->line(' Ctrl+C로 종료할 수 있습니다.'); } else { $buildCommand[] = 'build'; $this->info("🔨 빌드 시작: {$identifier}".($productionMode ? ' (프로덕션)' : '')); } // 빌드 실행 (감시 모드에는 소스맵 억제를 주입하지 않는다 — 개발 중 디버깅 필요) $result = $this->runNpmCommand( $buildCommand, $buildPath, ! $watchMode, $watchMode ? [] : $this->buildEnv($productionMode) ); if ($result === Command::SUCCESS && ! $watchMode) { $this->info("✅ 빌드 완료: {$identifier}"); // 빌드 결과 파일 확인 $this->displayBuildResults($buildPath, $identifier); // 편집기 컴포넌트 매니페스트(components.json) 생성 $manifestResult = $this->generateComponentManifest($buildPath, $identifier); if ($manifestResult['written']) { $this->line(" - components.json 생성됨 (컴포넌트 {$manifestResult['count']}개)"); } else { $this->warn(' - components.json 생성 실패 (편집 모드 컨트롤 노출 제한)'); } // 캐시 버전 증가 (브라우저 캐시 무효화) $this->incrementExtensionCacheVersion(); $this->line(' - 캐시 버전 갱신됨'); // _bundled 빌드 시 활성 반영 안내 if ($source === 'bundled') { $this->line(''); $this->info("💡 활성 디렉토리에 반영하려면: php artisan module:update {$identifier}"); } } return $result; } /** * 빌드 결과 파일 정보를 출력합니다. * * @param string $buildPath 빌드된 경로 * @param string $identifier 모듈 식별자 */ private function displayBuildResults(string $buildPath, string $identifier): void { // 활성 모듈 인스턴스가 있으면 getBuiltAssetPaths 활용 $module = $this->moduleManager->getModule($identifier); if ($module) { $builtPaths = $module->getBuiltAssetPaths(); if (! empty($builtPaths['js'])) { $jsPath = $buildPath.'/'.$builtPaths['js']; if (file_exists($jsPath)) { $this->line(' - JS: '.$builtPaths['js'].' ('.number_format(filesize($jsPath) / 1024, 2).' KB)'); } } if (! empty($builtPaths['css'])) { $cssPath = $buildPath.'/'.$builtPaths['css']; if (file_exists($cssPath)) { $this->line(' - CSS: '.$builtPaths['css'].' ('.number_format(filesize($cssPath) / 1024, 2).' KB)'); } } return; } // 활성 인스턴스 없으면 manifest에서 직접 확인 $manifestPath = $buildPath.'/module.json'; if (file_exists($manifestPath)) { $manifest = json_decode(file_get_contents($manifestPath), true); $assets = $manifest['assets'] ?? []; if (! empty($assets['js']['output'])) { $jsPath = $buildPath.'/'.$assets['js']['output']; if (file_exists($jsPath)) { $this->line(' - JS: '.$assets['js']['output'].' ('.number_format(filesize($jsPath) / 1024, 2).' KB)'); } } if (! empty($assets['css']['output'])) { $cssPath = $buildPath.'/'.$assets['css']['output']; if (file_exists($cssPath)) { $this->line(' - CSS: '.$assets['css']['output'].' ('.number_format(filesize($cssPath) / 1024, 2).' KB)'); } } } } /** * 모든 모듈 빌드 * * @param bool $productionMode 프로덕션 빌드 * @return int 명령 실행 결과 코드 */ private function buildAllModules(bool $productionMode): int { $buildTargets = []; if ($this->option('active')) { // --active: 활성 디렉토리만 대상 $activeModules = $this->moduleManager->getAllModules(); foreach ($activeModules as $identifier => $module) { $activePath = base_path("modules/{$identifier}"); if (file_exists($activePath.'/package.json') && ($module->canBuild() || $module->hasAssets())) { $buildTargets[$identifier] = true; } } } else { // 기본값: _bundled 디렉토리 스캔 $bundledModules = $this->moduleManager->getBundledModules(); foreach ($bundledModules as $identifier => $metadata) { $bundledPath = $metadata['source_path']; if (file_exists($bundledPath.'/package.json')) { $assets = $metadata['assets'] ?? []; if (! empty($assets['js']['entry']) || ! empty($assets['css']['entry']) || ! empty($assets)) { $buildTargets[$identifier] = true; } } } } if (empty($buildTargets)) { $this->warn('⚠️ 빌드할 모듈이 없습니다.'); return Command::SUCCESS; } $sourceLabel = $this->option('active') ? '활성' : '_bundled'; $this->info("🔨 모든 모듈 빌드 시작 ({$sourceLabel})".($productionMode ? ' (프로덕션)' : '')); $this->line(' 대상 모듈: '.implode(', ', array_keys($buildTargets))); $this->line(''); $successCount = 0; $failCount = 0; foreach ($buildTargets as $identifier => $value) { $this->line(" [{$identifier}]"); $result = $this->buildModule($identifier, false, $productionMode); if ($result === Command::SUCCESS) { $successCount++; } else { $failCount++; } $this->line(''); } $this->info("📊 빌드 결과: 성공 {$successCount}개, 실패 {$failCount}개"); return $failCount > 0 ? Command::FAILURE : Command::SUCCESS; } /** * 빌드 프로세스에 주입할 환경변수를 구성합니다. * * 프로덕션 빌드에서는 소스맵을 생성하지 않습니다. 배포 산출물에 원본 코드가 * 포함되는 것을 막기 위함이며, 각 vite config 가 이 값을 읽습니다. * * @param bool $productionMode 프로덕션 빌드 여부 * @return array Process 에 주입할 환경변수 */ private function buildEnv(bool $productionMode): array { return $productionMode ? ['G7_BUILD_SOURCEMAP' => '0'] : []; } /** * npm 명령 실행 * * @param array $command 실행할 명령 * @param string $cwd 작업 디렉토리 * @param bool $waitForCompletion 완료 대기 여부 * @param array $env 추가로 주입할 환경변수 (부모 환경에 병합됨) * @return int 명령 실행 결과 코드 */ private function runNpmCommand(array $command, string $cwd, bool $waitForCompletion = true, array $env = []): int { // Windows 환경에서는 cmd /c 사용 if (PHP_OS_FAMILY === 'Windows') { $command = array_merge(['cmd', '/c'], $command); } $process = new Process($command); $process->setWorkingDirectory($cwd); // Symfony Process 는 지정한 env 를 부모 환경에 병합하므로(PATH 등 유지) 추가분만 넘긴다. if ($env !== []) { $process->setEnv($env); } $process->setTimeout(null); // 타임아웃 없음 if ($waitForCompletion) { $process->run(function ($type, $buffer) { $this->output->write($buffer); }); return $process->isSuccessful() ? Command::SUCCESS : Command::FAILURE; } // 감시 모드: 인터럽트까지 실행 $process->start(function ($type, $buffer) { $this->output->write($buffer); }); // 프로세스가 실행 중인 동안 대기 while ($process->isRunning()) { usleep(100000); // 100ms } return Command::SUCCESS; } }