Router::url() - Code Metrics - Inspection of "[ci-tests] add _assertDisplayContains" - phpMv/ubiquity - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — master ( ff0e62...6ed64e )

by Jean-Christophe

created 2020-09-06 10:30 UTC

Router::url() A

↳ Parent: Router

Complexity

Conditions	1
Paths	1

Size

Total Lines	2
Code Lines	1

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	0
CRAP Score	2

Importance

Changes	2
Bugs	0	Features	0

Metric	Value
eloc	1
c	2
b	0
f	0
dl	0
loc	2
ccs	0
cts	2
cp	0
rs	10
cc	1
nc	1
nop	2
crap	2

<?php

namespace Ubiquity\controllers;

use Ubiquity\cache\CacheManager;
use Ubiquity\controllers\traits\RouterAdminTrait;
use Ubiquity\controllers\traits\RouterModifierTrait;
use Ubiquity\controllers\traits\RouterTestTrait;
use Ubiquity\log\Logger;
use Ubiquity\utils\http\URequest;

/**
 * Router manager.
 * Ubiquity\controllers$Router
 * This class is part of Ubiquity
 *
 * @author jcheron <[email protected]>
 * @version 1.0.13
 *
 */
class Router {
	use RouterModifierTrait,RouterAdminTrait,RouterTestTrait;
	protected static $routes;

	private static function cleanParam(string $param): string {
		if (\substr ( $param, - 1 ) === '/') {
			return \substr ( $param, 0, - 1 );
		}
		return $param;
	}

	private static function getRoute_(&$routeDetails, $routePath, $matches, $cachedResponse) {
		if (! isset ( $routeDetails ['controller'] )) {
			$method = \strtolower ( $_SERVER ['REQUEST_METHOD'] );
			if (isset ( $routeDetails [$method] )) {
				$routeDetailsMethod = $routeDetails [$method];
				return self::getRouteUrlParts ( [ 'path' => $routePath,'details' => $routeDetailsMethod ], $matches, $routeDetailsMethod ['cache'] ?? false, $routeDetailsMethod ['duration'] ?? null, $cachedResponse );
			}
		} else {
			return self::getRouteUrlParts ( [ 'path' => $routePath,'details' => $routeDetails ], $matches, $routeDetails ['cache'] ?? false, $routeDetails ['duration'] ?? null, $cachedResponse );
		}
		return false;
	}

	protected static function _getURL($routePath, $params) {
		$result = \preg_replace_callback ( '~\((.*?)\)~', function () use (&$params) {
			return \array_shift ( $params );
		}, $routePath );
		if (\sizeof ( $params ) > 0) {
			$result = \rtrim ( $result, '/' ) . '/' . \implode ( '/', $params );
		}
		return $result;
	}

	protected static function checkRouteName($routeDetails, $name) {
		if (! isset ( $routeDetails ['name'] )) {
			foreach ( $routeDetails as $methodRouteDetail ) {
				if (isset ( $methodRouteDetail ['name'] ) && $methodRouteDetail ['name'] == $name) {
					return true;
				}
			}
		}
		return isset ( $routeDetails ['name'] ) && $routeDetails ['name'] == $name;
	}

	protected static function setParamsInOrder(&$routeUrlParts, $paramsOrder, $params) {
		$index = 0;
		foreach ( $paramsOrder as $order ) {
			if ($order === '*') {
				if (isset ( $params [$index] )) {
					$routeUrlParts = \array_merge ( $routeUrlParts, \array_diff ( \explode ( '/', $params [$index] ), [ '' ] ) );
				}
				break;
			}
			if (($order [0] ?? '') === '~') {
				$order = \intval ( \substr ( $order, 1, 1 ) );
				if (isset ( $params [$order] )) {
					$routeUrlParts = \array_merge ( $routeUrlParts, \array_diff ( \explode ( '/', $params [$order] ), [ '' ] ) );
					break;
				}
			}
			$routeUrlParts [] = self::cleanParam ( $params [$order] );
			unset ( $params [$order] );
			$index ++;
		}
	}

	/**
	 * Starts the router by loading normal routes (not rest)
	 */
	public static function start(): void {
		self::$routes = CacheManager::getControllerCache ();
	}

	/**
	 * Starts the router by loading rest routes (not normal routes)
	 */
	public static function startRest(): void {
		self::$routes = CacheManager::getControllerCache ( true );
	}

	/**
	 * Starts the router by loading all routes (normal + rest routes)
	 */
	public static function startAll(): void {
		self::$routes = \array_merge ( CacheManager::getControllerCache (), CacheManager::getControllerCache ( true ) );
	}

	/**
	 * Returns the route corresponding to a path
	 *
	 * @param string $path The route path
	 * @param boolean $cachedResponse
	 * @return boolean|mixed[]|string
	 */
	public static function getRoute($path, $cachedResponse = true, $debug = false) {
		$path = self::slashPath ( $path );
		if (isset ( self::$routes [$path] ) && ! $debug) { // No direct access to route in debug mode (for maintenance mode activation)
			return self::getRoute_ ( self::$routes [$path], $path, [ $path ], $cachedResponse );
		}
		foreach ( self::$routes as $routePath => $routeDetails ) {
			if (\preg_match ( "@^{$routePath}\$@s", $path, $matches )) {
				if (($r = self::getRoute_ ( $routeDetails, $routePath, $matches, $cachedResponse )) !== false) {
					return $r;
				}
			}
		}
		return false;
	}

	/**
	 * Returns the generated path from a route
	 *
	 * @param string $name name of the route
	 * @param array $parameters array of the route parameters. default : []
	 * @param boolean $absolute
	 */
	public static function getRouteByName($name, $parameters = [ ], $absolute = true) {
		foreach ( self::$routes as $routePath => $routeDetails ) {
			if (self::checkRouteName ( $routeDetails, $name )) {
				if (\sizeof ( $parameters ) > 0) {
					$routePath = self::_getURL ( $routePath, $parameters );
				}
				if (trim ( $routePath, '/' ) == '_default') {
					$routePath = "/";
				}
				if (! $absolute) {
					return \ltrim ( $routePath, '/' );
				} else {
					return $routePath;
				}
			}
		}
		return false;
	}

	public static function getRouteInfoByName($name) {
		foreach ( self::$routes as $routeDetails ) {
			if (self::checkRouteName ( $routeDetails, $name )) {
				return $routeDetails;
			}
		}
		return false;
	}

	/**
	 * Returns the generated path from a route
	 *
	 * @param string $name The route name
	 * @param array $parameters default: []
	 * @param boolean $absolute true if the path is absolute (/ at first)
	 * @return boolean|string|array|mixed the generated path (/path/to/route)
	 */
	public static function path($name, $parameters = [ ], $absolute = false) {
		return self::getRouteByName ( $name, $parameters, $absolute );
	}

	/**
	 * Returns the generated url from a route
	 *
	 * @param string $name the route name
	 * @param array $parameters default: []
	 * @return string the generated url (http://myApp/path/to/route)
	 */
	public static function url($name, $parameters = [ ]): string {
		return URequest::getUrl ( self::getRouteByName ( $name, $parameters, false ) );
	}

	public static function getRouteUrlParts($routeArray, $params, $cached = false, $duration = NULL, $cachedResponse = true) {
		$realPath = \current ( $params );
		\array_shift ( $params );
		$routeDetails = $routeArray ['details'];
		if ($routeDetails ['controller'] instanceof \Closure) {
			$result = [ $routeDetails ['controller'] ];
			$resultStr = 'callable function';
		} else {
			$result = [ \str_replace ( "\\\\", "\\", $routeDetails ['controller'] ),$routeDetails ['action'] ];
			$resultStr = \implode ( '/', $result );
		}
		if (($paramsOrder = $routeDetails ['parameters']) && (\sizeof ( $paramsOrder ) > 0)) {
			self::setParamsInOrder ( $result, $paramsOrder, $params );
		}
		if (! $cached || ! $cachedResponse) {
			Logger::info ( 'Router', \sprintf ( 'Route found for %s : %s', $routeArray ['path'], $resultStr ), 'getRouteUrlParts' );
			if (isset ( $routeDetails ['callback'] )) {
				// Used for maintenance mode
				if ($routeDetails ['callback'] instanceof \Closure) {
					return $routeDetails ['callback'] ( $result );
				}
			}
			return $result;
		}
		Logger::info ( 'Router', sprintf ( 'Route found for %s (from cache) : %s', $realPath, $resultStr ), 'getRouteUrlParts' );
		return CacheManager::getRouteCache ( $realPath, $result, $duration );
	}

	/**
	 * Adds a slash before and after a path
	 *
	 * @param string $path The path to modify
	 * @return string The path with slashes
	 */
	public static function slashPath($path): string {
		if (\substr ( $path, 0, 1 ) !== '/') {
			$path = '/' . $path;
		}
		if (\substr ( $path, - 1 ) !== '/') {
			$path = $path . '/';
		}
		return $path;
	}

	/**
	 * Declare a route as expired
	 *
	 * @param string $routePath
	 */
	public static function setExpired($routePath): void {
		CacheManager::setExpired ( $routePath );
	}

	/**
	 * Returns the array of loaded routes
	 *
	 * @return array|mixed
	 */
	public static function getRoutes() {
		return self::$routes;
	}
}


1		<?php
2
3		namespace Ubiquity\controllers;
4
5		use Ubiquity\cache\CacheManager;
6		use Ubiquity\controllers\traits\RouterAdminTrait;
7		use Ubiquity\controllers\traits\RouterModifierTrait;
8		use Ubiquity\controllers\traits\RouterTestTrait;
9		use Ubiquity\log\Logger;
10		use Ubiquity\utils\http\URequest;
11
12		/**
13		* Router manager.
14		* Ubiquity\controllers$Router
15		* This class is part of Ubiquity
16		*
17		* @author jcheron <[email protected]>
18		* @version 1.0.13
19		*
20		*/
21		class Router {
22		use RouterModifierTrait,RouterAdminTrait,RouterTestTrait;
23		protected static $routes;
24
25	9	private static function cleanParam(string $param): string {
26	9	if (\substr ( $param, - 1 ) === '/') {
27		return \substr ( $param, 0, - 1 );
28		}
29	9	return $param;
30		}
31
32	20	private static function getRoute_(&$routeDetails, $routePath, $matches, $cachedResponse) {
33	20	if (! isset ( $routeDetails ['controller'] )) {
34	11	$method = \strtolower ( $_SERVER ['REQUEST_METHOD'] );
35	11	if (isset ( $routeDetails [$method] )) {
36	11	$routeDetailsMethod = $routeDetails [$method];
37	11	return self::getRouteUrlParts ( [ 'path' => $routePath,'details' => $routeDetailsMethod ], $matches, $routeDetailsMethod ['cache'] ?? false, $routeDetailsMethod ['duration'] ?? null, $cachedResponse );
38		}
39		} else {
40	10	return self::getRouteUrlParts ( [ 'path' => $routePath,'details' => $routeDetails ], $matches, $routeDetails ['cache'] ?? false, $routeDetails ['duration'] ?? null, $cachedResponse );
41		}
42	10	return false;
43		}
44
45		protected static function _getURL($routePath, $params) {
46		$result = \preg_replace_callback ( '~\((.*?)\)~', function () use (&$params) {
47		return \array_shift ( $params );
48		}, $routePath );
49		if (\sizeof ( $params ) > 0) {
50		$result = \rtrim ( $result, '/' ) . '/' . \implode ( '/', $params );
51		}
52		return $result;
53		}
54
55	1	protected static function checkRouteName($routeDetails, $name) {
56	1	if (! isset ( $routeDetails ['name'] )) {
57		foreach ( $routeDetails as $methodRouteDetail ) {
58		if (isset ( $methodRouteDetail ['name'] ) && $methodRouteDetail ['name'] == $name) {
59		return true;
60		}
61		}
62		}
63	1	return isset ( $routeDetails ['name'] ) && $routeDetails ['name'] == $name;
64		}
65
66	9	protected static function setParamsInOrder(&$routeUrlParts, $paramsOrder, $params) {
67	9	$index = 0;
68	9	foreach ( $paramsOrder as $order ) {
69	9	if ($order === '*') {
70		if (isset ( $params [$index] )) {
71		$routeUrlParts = \array_merge ( $routeUrlParts, \array_diff ( \explode ( '/', $params [$index] ), [ '' ] ) );
72		}
73		break;
74		}
75	9	if (($order [0] ?? '') === '~') {
76	5	$order = \intval ( \substr ( $order, 1, 1 ) );
77	5	if (isset ( $params [$order] )) {
78	5	$routeUrlParts = \array_merge ( $routeUrlParts, \array_diff ( \explode ( '/', $params [$order] ), [ '' ] ) );
79	5	break;
80		}
81		}
82	9	$routeUrlParts [] = self::cleanParam ( $params [$order] );
83	9	unset ( $params [$order] );
84	9	$index ++;
85		}
86	9	}
87
88		/**
89		* Starts the router by loading normal routes (not rest)
90		*/
91	21	public static function start(): void {
92	21	self::$routes = CacheManager::getControllerCache ();
93	21	}
94
95		/**
96		* Starts the router by loading rest routes (not normal routes)
97		*/
98	4	public static function startRest(): void {
99	4	self::$routes = CacheManager::getControllerCache ( true );
100	4	}
101
102		/**
103		* Starts the router by loading all routes (normal + rest routes)
104		*/
105	36	public static function startAll(): void {
106	36	self::$routes = \array_merge ( CacheManager::getControllerCache (), CacheManager::getControllerCache ( true ) );
107	36	}
108
109		/**
110		* Returns the route corresponding to a path
111		*
112		* @param string $path The route path
113		* @param boolean $cachedResponse
114		* @return boolean\|mixed[]\|string
115		*/
116	51	public static function getRoute($path, $cachedResponse = true, $debug = false) {
117	51	$path = self::slashPath ( $path );
118	51	if (isset ( self::$routes [$path] ) && ! $debug) { // No direct access to route in debug mode (for maintenance mode activation)
119		return self::getRoute_ ( self::$routes [$path], $path, [ $path ], $cachedResponse );
120		}
121	51	foreach ( self::$routes as $routePath => $routeDetails ) {
122	51	if (\preg_match ( "@^{$routePath}\$@s", $path, $matches )) {
123	20	if (($r = self::getRoute_ ( $routeDetails, $routePath, $matches, $cachedResponse )) !== false) {
124	20	return $r;
125		}
126		}
127		}
128	38	return false;
129		}
130
131		/**
132		* Returns the generated path from a route
133		*
134		* @param string $name name of the route
135		* @param array $parameters array of the route parameters. default : []
136		* @param boolean $absolute
137		*/
138		public static function getRouteByName($name, $parameters = [ ], $absolute = true) {
139		foreach ( self::$routes as $routePath => $routeDetails ) {
140		if (self::checkRouteName ( $routeDetails, $name )) {
141		if (\sizeof ( $parameters ) > 0) {
142		$routePath = self::_getURL ( $routePath, $parameters );
143		}
144		if (trim ( $routePath, '/' ) == '_default') {
145		$routePath = "/";
146		}
147		if (! $absolute) {
148		return \ltrim ( $routePath, '/' );
149		} else {
150		return $routePath;
151		}
152		}
153		}
154		return false;
155		}
156
157	1	public static function getRouteInfoByName($name) {
158	1	foreach ( self::$routes as $routeDetails ) {
159	1	if (self::checkRouteName ( $routeDetails, $name )) {
160	1	return $routeDetails;
161		}
162		}
163		return false;
164		}
165
166		/**
167		* Returns the generated path from a route
168		*
169		* @param string $name The route name
170		* @param array $parameters default: []
171		* @param boolean $absolute true if the path is absolute (/ at first)
172		* @return boolean\|string\|array\|mixed the generated path (/path/to/route)
173		*/
174		public static function path($name, $parameters = [ ], $absolute = false) {
175		return self::getRouteByName ( $name, $parameters, $absolute );
176		}
177
178		/**
179		* Returns the generated url from a route
180		*
181		* @param string $name the route name
182		* @param array $parameters default: []
183		* @return string the generated url (http://myApp/path/to/route)
184		*/
185		public static function url($name, $parameters = [ ]): string {
186		return URequest::getUrl ( self::getRouteByName ( $name, $parameters, false ) );
187		}
188
189	20	public static function getRouteUrlParts($routeArray, $params, $cached = false, $duration = NULL, $cachedResponse = true) {
190	20	$realPath = \current ( $params );
191	20	\array_shift ( $params );
192	20	$routeDetails = $routeArray ['details'];
193	20	if ($routeDetails ['controller'] instanceof \Closure) {
194		$result = [ $routeDetails ['controller'] ];
195		$resultStr = 'callable function';
196		} else {
197	20	$result = [ \str_replace ( "\\\\", "\\", $routeDetails ['controller'] ),$routeDetails ['action'] ];
198	20	$resultStr = \implode ( '/', $result );
199		}
200	20	if (($paramsOrder = $routeDetails ['parameters']) && (\sizeof ( $paramsOrder ) > 0)) {
201	9	self::setParamsInOrder ( $result, $paramsOrder, $params );
202		}
203	20	if (! $cached \|\| ! $cachedResponse) {
204	20	Logger::info ( 'Router', \sprintf ( 'Route found for %s : %s', $routeArray ['path'], $resultStr ), 'getRouteUrlParts' );
205	20	if (isset ( $routeDetails ['callback'] )) {
206		// Used for maintenance mode
207	1	if ($routeDetails ['callback'] instanceof \Closure) {
208	1	return $routeDetails ['callback'] ( $result );
209		}
210		}
211	19	return $result;
212		}
213		Logger::info ( 'Router', sprintf ( 'Route found for %s (from cache) : %s', $realPath, $resultStr ), 'getRouteUrlParts' );
214		return CacheManager::getRouteCache ( $realPath, $result, $duration );
215		}
216
217		/**
218		* Adds a slash before and after a path
219		*
220		* @param string $path The path to modify
221		* @return string The path with slashes
222		*/
223	51	public static function slashPath($path): string {
224	51	if (\substr ( $path, 0, 1 ) !== '/') {
225	51	$path = '/' . $path;
226		}
227	51	if (\substr ( $path, - 1 ) !== '/') {
228	43	$path = $path . '/';
229		}
230	51	return $path;
231		}
232
233		/**
234		* Declare a route as expired
235		*
236		* @param string $routePath
237		*/
238		public static function setExpired($routePath): void {
239		CacheManager::setExpired ( $routePath );
240		}
241
242		/**
243		* Returns the array of loaded routes
244		*
245		* @return array\|mixed
246		*/
247	51	public static function getRoutes() {
248	51	return self::$routes;
249		}
250		}
251

phpMv / ubiquity

Push — master ( ff0e62...6ed64e )

Router::url() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like