shouldReceive('getActiveTemplate') ->with('user') ->andReturn($activeTemplate); // TemplateService 모킹 /** @var TemplateService|MockInterface $templateService */ $templateService = Mockery::mock(TemplateService::class); $templateService->shouldReceive('getRoutesDataWithModules') ->withAnyArgs() ->andReturn([ 'success' => $routesSuccess, 'data' => ['routes' => $routes], ]); // ModuleManagerInterface 모킹 /** @var ModuleManagerInterface|MockInterface $moduleManager */ $moduleManager = Mockery::mock(ModuleManagerInterface::class); $moduleManager->shouldReceive('getModule') ->andReturnUsing(function (string $id) use ($knownModules) { return in_array($id, $knownModules) ? Mockery::mock(ModuleInterface::class) : null; }); // PluginManagerInterface 모킹 /** @var PluginManagerInterface|MockInterface $pluginManager */ $pluginManager = Mockery::mock(PluginManagerInterface::class); $pluginManager->shouldReceive('getPlugin') ->andReturnUsing(function (string $id) use ($knownPlugins) { return in_array($id, $knownPlugins) ? Mockery::mock(PluginInterface::class) : null; }); return new TemplateRouteResolver($templateService, $templateManager, $moduleManager, $pluginManager); } /** * 기본 라우트 목록을 생성합니다. * * @return array 테스트용 라우트 배열 */ private function getDefaultRoutes(): array { return [ [ 'path' => '/', 'layout' => 'home', 'auth_required' => false, 'guest_only' => false, 'meta' => ['title' => '홈'], ], [ 'path' => '/shop/products', 'layout' => 'sirsoft-ecommerce.shop/index', 'auth_required' => false, 'guest_only' => false, 'meta' => [], ], [ 'path' => '/shop/products/:id', 'layout' => 'sirsoft-ecommerce.shop/show', 'auth_required' => false, 'guest_only' => false, 'meta' => [], ], [ 'path' => '/about', 'layout' => 'pages/about', 'auth_required' => false, 'guest_only' => false, 'meta' => ['seo' => true], ], ]; } /** * 루트 URL(/)이 home 레이아웃으로 매핑됩니다. */ public function test_root_url_resolves_to_home_layout(): void { $resolver = $this->createResolver( ['identifier' => 'sirsoft-user_basic'], $this->getDefaultRoutes(), knownModules: ['sirsoft-ecommerce'] ); $result = $resolver->resolve('/'); $this->assertNotNull($result); $this->assertSame('sirsoft-user_basic', $result['templateIdentifier']); $this->assertSame('home', $result['layoutName']); $this->assertNull($result['moduleIdentifier']); $this->assertNull($result['pluginIdentifier']); $this->assertSame([], $result['routeParams']); } /** * 모듈 레이아웃 경로가 moduleIdentifier와 layoutName으로 분리됩니다. */ public function test_shop_products_resolves_with_module_identifier(): void { $resolver = $this->createResolver( ['identifier' => 'sirsoft-user_basic'], $this->getDefaultRoutes(), knownModules: ['sirsoft-ecommerce'] ); $result = $resolver->resolve('/shop/products'); $this->assertNotNull($result); $this->assertSame('sirsoft-ecommerce', $result['moduleIdentifier']); $this->assertNull($result['pluginIdentifier']); $this->assertSame('shop/index', $result['layoutName']); } /** * 동적 라우트 파라미터(:id)가 routeParams로 추출됩니다. */ public function test_dynamic_route_params_extracted(): void { $resolver = $this->createResolver( ['identifier' => 'sirsoft-user_basic'], $this->getDefaultRoutes(), knownModules: ['sirsoft-ecommerce'] ); $result = $resolver->resolve('/shop/products/123'); $this->assertNotNull($result); $this->assertSame('sirsoft-ecommerce', $result['moduleIdentifier']); $this->assertSame('shop/show', $result['layoutName']); $this->assertSame(['id' => '123'], $result['routeParams']); } /** * auth_required 라우트는 null을 반환합니다. */ public function test_auth_required_route_returns_null(): void { $routes = [ [ 'path' => '/mypage', 'layout' => 'mypage/index', 'auth_required' => true, 'guest_only' => false, 'meta' => [], ], ]; $resolver = $this->createResolver( ['identifier' => 'sirsoft-user_basic'], $routes ); $result = $resolver->resolve('/mypage'); $this->assertNull($result); } /** * guest_only 라우트는 null을 반환합니다. */ public function test_guest_only_route_returns_null(): void { $routes = [ [ 'path' => '/login', 'layout' => 'auth/login', 'auth_required' => false, 'guest_only' => true, 'meta' => [], ], ]; $resolver = $this->createResolver( ['identifier' => 'sirsoft-user_basic'], $routes ); $result = $resolver->resolve('/login'); $this->assertNull($result); } /** * 활성 템플릿이 없으면 null을 반환합니다. */ public function test_no_active_template_returns_null(): void { $resolver = $this->createResolver(null); $result = $resolver->resolve('/'); $this->assertNull($result); } /** * 동적 route_path 표현식이 모듈 설정값으로 해석됩니다. */ public function test_dynamic_route_path_expression_resolved(): void { $routes = [ [ 'path' => "/{{_global.modules?.['sirsoft-ecommerce']?.basic_info?.route_path ?? 'shop'}}/products", 'layout' => 'sirsoft-ecommerce.shop/index', 'auth_required' => false, 'guest_only' => false, 'meta' => [], ], ]; // 현재 resolveRouteExpression의 정규식 [\w.]+ 은 optional chaining (?.)을 처리하지 못해 // 'basic_info?.route_path' 패턴에서 첫 번째 regex가 매칭 실패하고 // null coalescing fallback 핸들러로 이동하여 기본값 'shop'을 반환합니다. // 따라서 Config 설정과 무관하게 fallback 'shop'이 사용됩니다. $resolver = $this->createResolver( ['identifier' => 'sirsoft-user_basic'], $routes ); // fallback 'shop'이 사용되므로 /shop/products로 매칭 $result = $resolver->resolve('/shop/products'); $this->assertNotNull($result); $this->assertSame('sirsoft-ecommerce', $result['moduleIdentifier']); $this->assertSame('shop/index', $result['layoutName']); } /** * 존재하지 않는 URL은 null을 반환합니다. */ public function test_non_existent_url_returns_null(): void { $resolver = $this->createResolver( ['identifier' => 'sirsoft-user_basic'], $this->getDefaultRoutes(), knownModules: ['sirsoft-ecommerce'] ); $result = $resolver->resolve('/this/does/not/exist'); $this->assertNull($result); } /** * 라우트 데이터 조회 실패 시 null을 반환합니다. */ public function test_routes_data_failure_returns_null(): void { $resolver = $this->createResolver( ['identifier' => 'sirsoft-user_basic'], [], false ); $result = $resolver->resolve('/'); $this->assertNull($result); } /** * routeMeta가 결과에 포함됩니다. */ public function test_route_meta_included_in_result(): void { $routes = [ [ 'path' => '/about', 'layout' => 'pages/about', 'auth_required' => false, 'guest_only' => false, 'meta' => ['seo' => true, 'cache' => 3600], ], ]; $resolver = $this->createResolver( ['identifier' => 'sirsoft-user_basic'], $routes ); $result = $resolver->resolve('/about'); $this->assertNotNull($result); $this->assertSame(['seo' => true, 'cache' => 3600], $result['routeMeta']); } /** * 삼항 연산자 표현식이 포함된 라우트 경로를 정상 해석합니다. */ public function test_ternary_expression_route_path_resolved(): void { $routes = [ [ 'path' => "/{{_global.modules?.['sirsoft-ecommerce']?.basic_info?.no_route ? '' : (_global.modules?.['sirsoft-ecommerce']?.basic_info?.route_path ?? 'shop')}}/products/:id", 'layout' => 'sirsoft-ecommerce.shop/show', 'auth_required' => false, 'guest_only' => false, 'meta' => [], ], ]; Config::set('g7_settings.modules.sirsoft-ecommerce.basic_info.route_path', 'shop'); Config::set('g7_settings.modules.sirsoft-ecommerce.basic_info.no_route', false); $resolver = $this->createResolver( ['identifier' => 'sirsoft-user_basic'], $routes ); $result = $resolver->resolve('/shop/products/99'); $this->assertNotNull($result); $this->assertSame('sirsoft-ecommerce', $result['moduleIdentifier']); $this->assertSame('shop/show', $result['layoutName']); $this->assertSame(['id' => '99'], $result['routeParams']); } /** * no_route=true일 때 삼항 연산자 표현식이 빈 문자열을 반환합니다. */ public function test_ternary_expression_returns_empty_when_no_route_true(): void { $routes = [ [ 'path' => "/{{_global.modules?.['sirsoft-ecommerce']?.basic_info?.no_route ? '' : (_global.modules?.['sirsoft-ecommerce']?.basic_info?.route_path ?? 'shop')}}/products", 'layout' => 'sirsoft-ecommerce.shop/index', 'auth_required' => false, 'guest_only' => false, 'meta' => [], ], ]; Config::set('g7_settings.modules.sirsoft-ecommerce.basic_info.route_path', 'shop'); Config::set('g7_settings.modules.sirsoft-ecommerce.basic_info.no_route', true); $resolver = $this->createResolver( ['identifier' => 'sirsoft-user_basic'], $routes ); // no_route=true → 빈 prefix → /products로 매칭 $result = $resolver->resolve('/products'); $this->assertNotNull($result); $this->assertSame('shop/index', $result['layoutName']); } /** * 동적 표현식에서 모듈 설정이 없으면 기본값(fallback)을 사용합니다. */ public function test_dynamic_expression_uses_fallback_when_module_setting_missing(): void { $routes = [ [ 'path' => "/{{_global.modules?.['sirsoft-ecommerce']?.basic_info?.route_path ?? 'shop'}}/products", 'layout' => 'sirsoft-ecommerce.shop/index', 'auth_required' => false, 'guest_only' => false, 'meta' => [], ], ]; // 모듈 설정 없음 → fallback 'shop' 사용 Config::set('g7_settings.modules.sirsoft-ecommerce.basic_info.route_path', null); $resolver = $this->createResolver( ['identifier' => 'sirsoft-user_basic'], $routes, knownModules: ['sirsoft-ecommerce'] ); $result = $resolver->resolve('/shop/products'); $this->assertNotNull($result); $this->assertSame('shop/index', $result['layoutName']); } // ========================================================================= // 플러그인 식별자 판별 테스트 (3개) // ========================================================================= /** * 플러그인 dot notation에서 pluginIdentifier가 반환되고 moduleIdentifier는 null입니다. */ public function test_resolve_returns_plugin_identifier_for_plugin_layout(): void { $routes = [ [ 'path' => '/payment/checkout', 'layout' => 'sirsoft-payment.checkout', 'auth_required' => false, 'guest_only' => false, 'meta' => [], ], ]; $resolver = $this->createResolver( ['identifier' => 'sirsoft-user_basic'], $routes, knownPlugins: ['sirsoft-payment'] ); $result = $resolver->resolve('/payment/checkout'); $this->assertNotNull($result); $this->assertNull($result['moduleIdentifier']); $this->assertSame('sirsoft-payment', $result['pluginIdentifier']); $this->assertSame('checkout', $result['layoutName']); } /** * 모듈 dot notation에서 moduleIdentifier가 반환되고 pluginIdentifier는 null입니다. */ public function test_resolve_returns_module_identifier_for_module_layout(): void { $routes = [ [ 'path' => '/shop/products', 'layout' => 'sirsoft-ecommerce.shop/index', 'auth_required' => false, 'guest_only' => false, 'meta' => [], ], ]; $resolver = $this->createResolver( ['identifier' => 'sirsoft-user_basic'], $routes, knownModules: ['sirsoft-ecommerce'] ); $result = $resolver->resolve('/shop/products'); $this->assertNotNull($result); $this->assertSame('sirsoft-ecommerce', $result['moduleIdentifier']); $this->assertNull($result['pluginIdentifier']); } /** * dot notation 없는 코어 레이아웃은 moduleIdentifier, pluginIdentifier 모두 null입니다. */ public function test_resolve_returns_null_identifiers_for_core_layout(): void { $routes = [ [ 'path' => '/', 'layout' => 'home', 'auth_required' => false, 'guest_only' => false, 'meta' => [], ], ]; $resolver = $this->createResolver( ['identifier' => 'sirsoft-user_basic'], $routes ); $result = $resolver->resolve('/'); $this->assertNotNull($result); $this->assertNull($result['moduleIdentifier']); $this->assertNull($result['pluginIdentifier']); } // ======================================================================== // routeExists() — 미등록 경로 404 판별 (공개#47) // ======================================================================== /** * 지정한 템플릿 타입으로 routes 를 반환하는 resolver 를 생성합니다. * * @param string $type 템플릿 타입 ('user' | 'admin') * @param array|null $activeTemplate 활성 템플릿 (null 이면 미설치) * @param array $routes 라우트 배열 * @param bool $routesSuccess 라우트 조회 성공 여부 * @return TemplateRouteResolver 설정된 resolver */ private function createResolverForType(string $type, ?array $activeTemplate, array $routes = [], bool $routesSuccess = true): TemplateRouteResolver { /** @var TemplateManagerInterface|MockInterface $templateManager */ $templateManager = Mockery::mock(TemplateManagerInterface::class); $templateManager->shouldReceive('getActiveTemplate')->with($type)->andReturn($activeTemplate); /** @var TemplateService|MockInterface $templateService */ $templateService = Mockery::mock(TemplateService::class); $templateService->shouldReceive('getRoutesDataWithModules')->withAnyArgs()->andReturn([ 'success' => $routesSuccess, 'data' => ['routes' => $routes], ]); $moduleManager = Mockery::mock(ModuleManagerInterface::class); $moduleManager->shouldReceive('getModule')->andReturn(null); $pluginManager = Mockery::mock(PluginManagerInterface::class); $pluginManager->shouldReceive('getPlugin')->andReturn(null); return new TemplateRouteResolver($templateService, $templateManager, $moduleManager, $pluginManager); } /** * 등록된 정적/동적/auth_required/guest_only 라우트는 모두 routeExists=true 입니다. */ public function test_route_exists_true_for_registered_routes(): void { $routes = array_merge($this->getDefaultRoutes(), [ ['path' => '/mypage', 'layout' => 'mypage/index', 'auth_required' => true, 'guest_only' => false, 'meta' => []], ['path' => '/login', 'layout' => 'auth/login', 'auth_required' => false, 'guest_only' => true, 'meta' => []], ]); $resolver = $this->createResolver(['identifier' => 'sirsoft-user_basic'], $routes); $this->assertTrue($resolver->routeExists('/', 'user'), '정적 라우트'); $this->assertTrue($resolver->routeExists('/about', 'user'), '정적 라우트 about'); $this->assertTrue($resolver->routeExists('/shop/products/123', 'user'), '동적 라우트'); $this->assertTrue($resolver->routeExists('/mypage', 'user'), 'auth_required 도 존재로 인정 — 회귀 방지 핵심'); $this->assertTrue($resolver->routeExists('/login', 'user'), 'guest_only 도 존재로 인정'); } /** * 미등록 경로 / 초과 세그먼트는 routeExists=false 입니다. */ public function test_route_exists_false_for_unregistered_routes(): void { $resolver = $this->createResolver(['identifier' => 'sirsoft-user_basic'], $this->getDefaultRoutes()); $this->assertFalse($resolver->routeExists('/this/does/not/exist', 'user')); $this->assertFalse($resolver->routeExists('/shop/products/123/extra', 'user'), '초과 세그먼트는 ^...$ 전체 매칭 실패'); } /** * resolve()는 auth 라우트에서 null 이지만 routeExists()는 true — 차이 명시 검증. */ public function test_route_exists_differs_from_resolve_for_auth_routes(): void { $routes = [ ['path' => '/mypage', 'layout' => 'mypage/index', 'auth_required' => true, 'guest_only' => false, 'meta' => []], ]; $resolver = $this->createResolver(['identifier' => 'sirsoft-user_basic'], $routes); $this->assertNull($resolver->resolve('/mypage'), 'resolve()는 auth_required 를 SEO 비대상으로 스킵'); $this->assertTrue($resolver->routeExists('/mypage', 'user'), 'routeExists()는 존재로 인정'); } /** * 활성 템플릿 미설치 / routes 로드 실패 시 routeExists=true (404 억제, 안전측 폴백). */ public function test_route_exists_true_fallback_when_template_missing(): void { $noTemplate = $this->createResolverForType('user', null); $this->assertTrue($noTemplate->routeExists('/anything', 'user'), '템플릿 미설치 시 404 억제'); $loadFailure = $this->createResolverForType('user', ['identifier' => 'sirsoft-user_basic'], [], routesSuccess: false); $this->assertTrue($loadFailure->routeExists('/anything', 'user'), 'routes 로드 실패 시 404 억제'); } /** * admin 타입 라우트도 routeExists 로 판별됩니다 (admin 와일드카드 prefix → /admin/... 정규화). */ public function test_route_exists_for_admin_type(): void { $routes = [ ['path' => '*/admin/users', 'layout' => 'admin_user_list', 'auth_required' => true, 'guest_only' => false, 'meta' => []], ]; $resolver = $this->createResolverForType('admin', ['identifier' => 'sirsoft-admin_basic'], $routes); $this->assertTrue($resolver->routeExists('/admin/users', 'admin'), '*/admin/users → /admin/users 정규화 매칭'); $this->assertFalse($resolver->routeExists('/admin/nonexistent', 'admin')); } }