RouteCollection::put() - Code Metrics - scrawler-labs/router - Measure and Improve Code Quality continuously with Scrutinizer

RouteCollection::put() A
last analyzed 2025-04-14 20:04 UTC

↳ Parent: RouteCollection

Complexity

Conditions	1
Paths	1

Size

Total Lines	3
Code Lines	1

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
cc	1
eloc	1
nc	1
nop	2
dl	0
loc	3
rs	10
c	0
b	0
f	0

<?php

declare(strict_types=1);

/*
 * This file is part of the Scrawler package.
 *
 * (c) Pranjal Pandey <[email protected]>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Scrawler\Router;

/**
 * Collection of all available controllers.
 */
final class RouteCollection
{
    /**
     * Stores all controller and corrosponding route.
     *
     * @var array<mixed>
     */
    private array $controllers = [];

    /**
     * Stores all manual route.
     *
     * @var array<mixed>
     */
    private array $route = [];

    /*
     * Stores the path of dirctory containing controllers
     * @var string
     */
    private string $directory;

    /*
     * Stores the namespace of controllers
     * @var string
     */
    private string $namespace;

    /**
     * Stores list of directories.
     *
     * @var array<mixed>
     */
    private array $dir = [];

    /**
     *  Stores caching engine.
     */
    private \Psr\SimpleCache\CacheInterface $cache;

    /**
     *  Check if caches is enable.
     */
    private bool $enableCache = false;

    /**
     *  Check if auto register is enable.
     */
    private bool $autoRegistered = false;

    public function register(string $directory, string $namespace): void
    {
        $this->autoRegistered = true;
        $this->directory = $directory;
        $this->namespace = $namespace;

        $this->autoRegister();
    }

    /**
     * Function returns the class of corrosponding controller.
     */
    public function getController(string $controller): false|string
    {
        if ($this->enableCache && $this->cache->has(str_replace('/', '_', $controller))) {
            return $this->cache->get(str_replace('/', '_', $controller));
        }

        foreach ($this->controllers as $key => $value) {
            if ($key === $controller) {
                return $value;
            }
        }

        return false;
    }

    /**
     * Returns cache engine.
     */
    public function getCache(): \Psr\SimpleCache\CacheInterface
    {
        return $this->cache;
    }

    /**
     * Register controller with route collection.
     */
    public function registerController(string $name, string $class): void
    {
        $this->controllers[$name] = $class;
        if ($this->enableCache) {
            $this->cache->set(str_replace('/', '_', $name), $class);
            $this->cache->set('collection', $this->controllers);
        }
    }

    /**
     * Automatically register all controllers in specified directory.
     */
    private function autoRegister(): void
    {
        $files = array_slice(\Safe\scandir($this->directory), 2);
        foreach ($files as $file) {
            if (is_dir($this->directory.'/'.$file)) {
                $this->registerDir($file);
                $dir = $this->directory.'/'.$file;
                $dir_files = array_slice(\Safe\scandir($dir), 2);
                foreach ($dir_files as $dir_file) {
                    if ('Main.php' !== $dir_file && !\is_dir($dir.'/'.$dir_file)) {
                        $this->registerController($file.'/'.\basename((string) $dir_file, '.php'), $this->namespace.'\\'.\ucfirst((string) $file).'\\'.\basename((string) $dir_file, '.php'));
                    }
                }
            }
            if ('Main.php' !== $file && !\is_dir($this->directory.'/'.$file)) {
                $this->registerController(\basename((string) $file, '.php'), $this->namespace.'\\'.\basename((string) $file, '.php'));
            }
        }
    }

    /**
     * Function to get the namespace of controllers.
     */
    public function getNamespace(): string
    {
        return $this->namespace;
    }

    /**
     * Function to return list of all controller currently registerd with route collction.
     *
     * @return array<mixed>
     */
    public function getControllers(): array
    {
        return $this->controllers;
    }

    /**
     * Function to add dir to list of dir.
     */
    public function registerDir(string $dir): void
    {
        $this->dir[] = $dir;

        if ($this->enableCache) {
            $this->cache->set('dir', $this->dir);
        }
    }

    /**
     * Function to check if cache is enabled.
     */
    public function isCacheEnabled(): bool
    {
        return $this->enableCache;
    }

    /**
     * Function to check if its a registered dir.
     */
    public function isDir(string $dir): bool
    {
        if ($this->enableCache && $this->cache->has('dir')) {
            $this->dir = $this->cache->get('dir');
        }

        return in_array($dir, $this->dir);
    }

    /**
     * Enable cache with custom cache engine.
     */
    public function enableCache(\Psr\SimpleCache\CacheInterface $cache): void
    {
        $this->cache = $cache;
        $this->enableCache = true;
        if ($this->cache->has('collection')) {
            $this->controllers = $this->cache->get('collection');
        }
    }

    /**
     * Register manual route in route collection.
     */
    private function registerManual(string $method, string $route, callable $callable): void
    {
        $this->route[$method][$route] = $callable;
    }

    /**
     * register manual get route.
     */
    public function get(string $route, callable $callable): void
    {
        $this->registerManual('get', $route, $callable);
    }

    /**
     * register manual post route.
     */
    public function post(string $route, callable $callable): void
    {
        $this->registerManual('post', $route, $callable);
    }

    /**
     * register manual put route.
     */
    public function put(string $route, callable $callable): void
    {
        $this->registerManual('put', $route, $callable);
    }

    /**
     * register manual delete route.
     */
    public function delete(string $route, callable $callable): void
    {
        $this->registerManual('delete', $route, $callable);
    }

    /**
     * register manual patch route.
     */
    public function all(string $route, callable $callable): void
    {
        $this->registerManual('all', $route, $callable);
    }

    /**
     * get callable using route and method.
     */
    public function getRoute(string $route, string $method): callable|bool
    {
        return $this->route[$method][$route] ?? $this->route['all'][$route] ?? false;
    }

    /**
     * get all routes.
     *
     * @return array<mixed>
     */
    public function getRoutes(): array
    {
        return $this->route;
    }

    /**
     * check if auto register is enable.
     */
    public function isAutoRegistered(): bool
    {
        return $this->autoRegistered;
    }
}


1			<?php
2
3			declare(strict_types=1);
4
5			/*
6			* This file is part of the Scrawler package.
7			*
8			* (c) Pranjal Pandey <[email protected]>
9			*
10			* For the full copyright and license information, please view the LICENSE
11			* file that was distributed with this source code.
12			*/
13
14			namespace Scrawler\Router;
15
16			/**
17			* Collection of all available controllers.
18			*/
19			final class RouteCollection
20			{
21			/**
22			* Stores all controller and corrosponding route.
23			*
24			* @var array<mixed>
25			*/
26			private array $controllers = [];
27
28			/**
29			* Stores all manual route.
30			*
31			* @var array<mixed>
32			*/
33			private array $route = [];
34
35			/*
36			* Stores the path of dirctory containing controllers
37			* @var string
38			*/
39			private string $directory;
40
41			/*
42			* Stores the namespace of controllers
43			* @var string
44			*/
45			private string $namespace;
46
47			/**
48			* Stores list of directories.
49			*
50			* @var array<mixed>
51			*/
52			private array $dir = [];
53
54			/**
55			* Stores caching engine.
56			*/
57			private \Psr\SimpleCache\CacheInterface $cache;
58
59			/**
60			* Check if caches is enable.
61			*/
62			private bool $enableCache = false;
63
64			/**
65			* Check if auto register is enable.
66			*/
67			private bool $autoRegistered = false;
68
69			public function register(string $directory, string $namespace): void
70			{
71			$this->autoRegistered = true;
72			$this->directory = $directory;
73			$this->namespace = $namespace;
74
75			$this->autoRegister();
76			}
77
78			/**
79			* Function returns the class of corrosponding controller.
80			*/
81			public function getController(string $controller): false\|string
82			{
83			if ($this->enableCache && $this->cache->has(str_replace('/', '_', $controller))) {
84			return $this->cache->get(str_replace('/', '_', $controller));
85			}
86
87			foreach ($this->controllers as $key => $value) {
88			if ($key === $controller) {
89			return $value;
90			}
91			}
92
93			return false;
94			}
95
96			/**
97			* Returns cache engine.
98			*/
99			public function getCache(): \Psr\SimpleCache\CacheInterface
100			{
101			return $this->cache;
102			}
103
104			/**
105			* Register controller with route collection.
106			*/
107			public function registerController(string $name, string $class): void
108			{
109			$this->controllers[$name] = $class;
110			if ($this->enableCache) {
111			$this->cache->set(str_replace('/', '_', $name), $class);
112			$this->cache->set('collection', $this->controllers);
113			}
114			}
115
116			/**
117			* Automatically register all controllers in specified directory.
118			*/
119			private function autoRegister(): void
120			{
121			$files = array_slice(\Safe\scandir($this->directory), 2);
122			foreach ($files as $file) {
123			if (is_dir($this->directory.'/'.$file)) {
124			$this->registerDir($file);
125			$dir = $this->directory.'/'.$file;
126			$dir_files = array_slice(\Safe\scandir($dir), 2);
127			foreach ($dir_files as $dir_file) {
128			if ('Main.php' !== $dir_file && !\is_dir($dir.'/'.$dir_file)) {
129			$this->registerController($file.'/'.\basename((string) $dir_file, '.php'), $this->namespace.'\\'.\ucfirst((string) $file).'\\'.\basename((string) $dir_file, '.php'));
130			}
131			}
132			}
133			if ('Main.php' !== $file && !\is_dir($this->directory.'/'.$file)) {
134			$this->registerController(\basename((string) $file, '.php'), $this->namespace.'\\'.\basename((string) $file, '.php'));
135			}
136			}
137			}
138
139			/**
140			* Function to get the namespace of controllers.
141			*/
142			public function getNamespace(): string
143			{
144			return $this->namespace;
145			}
146
147			/**
148			* Function to return list of all controller currently registerd with route collction.
149			*
150			* @return array<mixed>
151			*/
152			public function getControllers(): array
153			{
154			return $this->controllers;
155			}
156
157			/**
158			* Function to add dir to list of dir.
159			*/
160			public function registerDir(string $dir): void
161			{
162			$this->dir[] = $dir;
163
164			if ($this->enableCache) {
165			$this->cache->set('dir', $this->dir);
166			}
167			}
168
169			/**
170			* Function to check if cache is enabled.
171			*/
172			public function isCacheEnabled(): bool
173			{
174			return $this->enableCache;
175			}
176
177			/**
178			* Function to check if its a registered dir.
179			*/
180			public function isDir(string $dir): bool
181			{
182			if ($this->enableCache && $this->cache->has('dir')) {
183			$this->dir = $this->cache->get('dir');
184			}
185
186			return in_array($dir, $this->dir);
187			}
188
189			/**
190			* Enable cache with custom cache engine.
191			*/
192			public function enableCache(\Psr\SimpleCache\CacheInterface $cache): void
193			{
194			$this->cache = $cache;
195			$this->enableCache = true;
196			if ($this->cache->has('collection')) {
197			$this->controllers = $this->cache->get('collection');
198			}
199			}
200
201			/**
202			* Register manual route in route collection.
203			*/
204			private function registerManual(string $method, string $route, callable $callable): void
205			{
206			$this->route[$method][$route] = $callable;
207			}
208
209			/**
210			* register manual get route.
211			*/
212			public function get(string $route, callable $callable): void
213			{
214			$this->registerManual('get', $route, $callable);
215			}
216
217			/**
218			* register manual post route.
219			*/
220			public function post(string $route, callable $callable): void
221			{
222			$this->registerManual('post', $route, $callable);
223			}
224
225			/**
226			* register manual put route.
227			*/
228			public function put(string $route, callable $callable): void
229			{
230			$this->registerManual('put', $route, $callable);
231			}
232
233			/**
234			* register manual delete route.
235			*/
236			public function delete(string $route, callable $callable): void
237			{
238			$this->registerManual('delete', $route, $callable);
239			}
240
241			/**
242			* register manual patch route.
243			*/
244			public function all(string $route, callable $callable): void
245			{
246			$this->registerManual('all', $route, $callable);
247			}
248
249			/**
250			* get callable using route and method.
251			*/
252			public function getRoute(string $route, string $method): callable\|bool
253			{
254			return $this->route[$method][$route] ?? $this->route['all'][$route] ?? false;
255			}
256
257			/**
258			* get all routes.
259			*
260			* @return array<mixed>
261			*/
262			public function getRoutes(): array
263			{
264			return $this->route;
265			}
266
267			/**
268			* check if auto register is enable.
269			*/
270			public function isAutoRegistered(): bool
271			{
272			return $this->autoRegistered;
273			}
274			}
275

scrawler-labs / router

RouteCollection::put() A last analyzed 2025-04-14 20:04 UTC

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like

RouteCollection::put() A
last analyzed 2025-04-14 20:04 UTC