routes(function () { $this->loadModuleRoutes(); }); } /** * 모듈의 라우트 파일들을 로드합니다. * * 활성화된 모듈만 라우트를 등록합니다. */ protected function loadModuleRoutes(): void { // .env 파일이 없으면 스킵 (인스톨러 실행 전) if (! File::exists(base_path('.env'))) { return; } $modulesPath = base_path('modules'); if (! File::exists($modulesPath)) { return; } // 설치 완료 상태에서는 Schema introspection 을 건너뜀 (매 요청 쿼리 제거). // 인스톨러 이전 환경에서는 기존 체크 경로로 폴백. // // 단, 마이그레이션 계열 명령 실행 중에는 INSTALLER_COMPLETED=true 라도 테이블이 // 아직 없을 수 있으므로(빈 DB 새 서버에 .env 복사 후 migrate 전) fast-path 를 // 무력화하고 hasTable 검증 경로로 진입한다. 빈 DB 면 여기서 early return 하여 // 아래 무방비 pluck 이 table not found 로 부팅을 깨뜨리는 것을 막는다. if (! config('app.installer_completed') || InstallerContext::isSchemaMutatingCommand()) { try { if (! Schema::hasTable('modules')) { return; } // identifier 컬럼이 없으면 스킵 (마이그레이션 미적용 상태) if (! Schema::hasColumn('modules', 'identifier')) { return; } } catch (\Exception) { // DB 연결 실패 시 조용히 스킵 (설정 오류, 마이그레이션 전 등) return; } } // 활성화된 모듈 identifier 목록 가져오기. // 같은 목록을 ModuleManager·ModuleServiceProvider 가 이미 캐시(TTL 기본 하루)해 두므로 // 여기서 다시 조회하지 않고 그 캐시를 공유한다. 상태 변경 시 무효화도 같이 따라온다. $activeModuleIdentifiers = self::getActiveModuleIdentifiers(); $modules = File::directories($modulesPath); $allowlistActive = ExtensionTestAllowlist::isActive(); foreach ($modules as $module) { $moduleName = basename($module); $moduleFile = $module.'/module.php'; // 테스트 환경 확장 격리: allowlist 밖 모듈의 라우트 등록 차단 if ($allowlistActive && ! ExtensionTestAllowlist::isAllowed('module', $moduleName)) { continue; } // 활성화된 모듈만 라우트 로드 if (! in_array($moduleName, $activeModuleIdentifiers)) { continue; } // 모듈 파일이 존재하는지 확인 if (! File::exists($moduleFile)) { continue; } // 디렉토리명(vendor-module)을 네임스페이스(Vendor\Module)로 변환 $namespace = $this->convertDirectoryToNamespace($moduleName); $moduleClass = "Modules\\{$namespace}\\Module"; // 클래스가 아직 로드되지 않은 경우에만 require // (_bundled에서 이미 로드된 경우 중복 선언 방지) if (! class_exists($moduleClass, false)) { require_once $moduleFile; } if (! class_exists($moduleClass)) { continue; } $moduleInstance = new $moduleClass; $routes = $moduleInstance->getRoutes(); // API 라우트 로드 if (isset($routes['api']) && File::exists($routes['api'])) { Route::prefix('api/modules/'.$moduleName) ->name('api.modules.'.$moduleName.'.') ->middleware('api') ->group($routes['api']); } // 웹 라우트 로드 if (isset($routes['web']) && File::exists($routes['web'])) { Route::prefix('modules/'.$moduleName) ->name('web.modules.'.$moduleName.'.') ->middleware('web') ->group($routes['web']); } } } /** * 디렉토리명(vendor-module)을 네임스페이스(Vendor\Module)로 변환합니다. * * @param string $directoryName 디렉토리명 (예: sirsoft-sample) * @return string 네임스페이스 (예: Sirsoft\Sample) */ protected function convertDirectoryToNamespace(string $directoryName): string { return ExtensionManager::directoryToNamespace($directoryName); } }