*/ private array $coreRoutes; /** @var list */ private array $corePublicPaths; /** * @param list $coreRoutes * @param list $corePublicPaths */ private function __construct(array $coreRoutes, array $corePublicPaths) { $this->coreRoutes = $coreRoutes; $this->corePublicPaths = $corePublicPaths; } public static function fromConfigFile(string $routesFile): self { if (!is_file($routesFile)) { throw new RuntimeException("Core route config not found: {$routesFile}"); } $loaded = include $routesFile; if (!is_array($loaded)) { throw new RuntimeException("Core route config '{$routesFile}' must return an array."); } return self::fromArray($loaded, $routesFile); } /** * @param array $routes */ public static function fromArray(array $routes, string $source = 'config/routes.php'): self { $normalized = []; $publicPaths = []; $seenPaths = []; foreach (array_values($routes) as $index => $route) { if (!is_array($route)) { throw new RuntimeException("Invalid route definition at {$source}[{$index}]: expected array."); } $path = trim((string) ($route['path'] ?? '')); $target = trim((string) ($route['target'] ?? '')); if ($path === '' || $target === '') { throw new RuntimeException("Invalid route definition at {$source}[{$index}]: non-empty path and target are required."); } if (isset($seenPaths[$path])) { throw new RuntimeException("Core route path conflict: '{$path}' is defined multiple times in {$source}."); } $seenPaths[$path] = true; $isPublic = (bool) ($route['public'] ?? false); $normalized[] = [ 'path' => $path, 'target' => $target, 'public' => $isPublic, ]; if ($isPublic) { $publicPaths[] = $path; } } $publicPaths = array_values(array_unique($publicPaths)); sort($publicPaths); return new self($normalized, $publicPaths); } /** * @return list */ public function coreRoutes(): array { return $this->coreRoutes; } /** * @return list */ public function corePublicPaths(): array { return $this->corePublicPaths; } }