RouteBlueprint::handle() - Code Metrics - htmlburger/wpemerge - Measure and Improve Code Quality continuously with Scrutinizer

RouteBlueprint::handle() A
last analyzed 2022-04-16 17:23 UTC

↳ Parent: RouteBlueprint

Complexity

Conditions	4
Paths	4

Size

Total Lines	14
Code Lines	7

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	8
CRAP Score	4

Importance

Changes

Metric	Value
eloc	7
c	0
b	0
f	0
dl	0
loc	14
rs	10
ccs	8
cts	8
cp	1
cc	4
nc	4
nop	1
crap	4

<?php
/**
 * @package   WPEmerge
 * @author    Atanas Angelov <[email protected]>
 * @copyright 2017-2019 Atanas Angelov
 * @license   https://www.gnu.org/licenses/gpl-2.0.html GPL-2.0
 * @link      https://wpemerge.com/
 */

namespace WPEmerge\Routing;

use Closure;
use WPEmerge\Helpers\HasAttributesTrait;
use WPEmerge\Routing\Conditions\ConditionInterface;
use WPEmerge\View\ViewService;

/**
 * Provide a fluent interface for registering routes with the router.
 */
class RouteBlueprint {
	use HasAttributesTrait;

	/**
	 * Router.
	 *
	 * @var Router
	 */
	protected $router = null;

	/**
	 * View service.
	 *
	 * @var ViewService
	 */
	protected $view_service = null;

	/**
	 * Constructor.
	 *
	 * @codeCoverageIgnore
	 * @param Router      $router
	 * @param ViewService $view_service
	 */
	public function __construct( Router $router, ViewService $view_service ) {
		$this->router = $router;
		$this->view_service = $view_service;
	}

	/**
	 * Match requests using one of the specified methods.
	 *
	 * @param  string[] $methods
	 * @return static   $this
	 */
	public function methods( $methods ) {
		$methods = $this->router->mergeMethodsAttribute(
			(array) $this->getAttribute( 'methods', [] ),
			(array) $methods
		);

		return $this->attribute( 'methods', $methods );
	}

	/**
	 * Set the condition attribute to a URL.
	 *
	 * @param  string                $url
	 * @param  array<string, string> $where
	 * @return static                $this
	 */
	public function url( $url, $where = [] ) {
		return $this->where( 'url', $url, $where );
	}

	/**
	 * Set the condition attribute.
	 *
	 * @param  string|array|ConditionInterface $condition
	 * @param  mixed                           ,...$arguments
	 * @return static                          $this
	 */
	public function where( $condition ) {
		if ( ! $condition instanceof ConditionInterface ) {
			$condition = func_get_args();
		}

		$condition = $this->router->mergeConditionAttribute(
			$this->getAttribute( 'condition', null ),
			$condition
		);

		return $this->attribute( 'condition', $condition );
	}

	/**
	 * Set the middleware attribute.
	 *
	 * @param  string|string[] $middleware
	 * @return static          $this
	 */
	public function middleware( $middleware ) {
		$middleware = $this->router->mergeMiddlewareAttribute(
			(array) $this->getAttribute( 'middleware', [] ),
			(array) $middleware
		);

		return $this->attribute( 'middleware', $middleware );
	}

	/**
	 * Set the namespace attribute.
	 * This should be renamed to namespace for consistency once minimum PHP
	 * version is increased to 7+.
	 *
	 * @param  string $namespace
	 * @return static $this
	 */
	public function setNamespace( $namespace ) {
		$namespace = $this->router->mergeNamespaceAttribute(
			$this->getAttribute( 'namespace', '' ),
			$namespace
		);

		return $this->attribute( 'namespace', $namespace );
	}

	/**
	 * Set the query attribute.
	 *
	 * @param  callable $query
	 * @return static   $this
	 */
	public function query( $query ) {
		$query = $this->router->mergeQueryAttribute(
			$this->getAttribute( 'query', null ),
			$query
		);

		return $this->attribute( 'query', $query );
	}

	/**
	 * Set the name attribute.
	 *
	 * @param  string $name
	 * @return static $this
	 */
	public function name( $name ) {
		return $this->attribute( 'name', $name );
	}

	/**
	 * Create a route group.
	 *
	 * @param  Closure|string $routes Closure or path to file.
	 * @return void
	 */
	public function group( $routes ) {
		$this->router->group( $this->getAttributes(), $routes );
	}

	/**
	 * Create a route.
	 *
	 * @param  string|Closure $handler
	 * @return void
	 */
	public function handle( $handler = '' ) {
		if ( ! empty( $handler ) ) {
			$this->attribute( 'handler', $handler );
		}

		$route = $this->router->route( $this->getAttributes() );

		$trace = debug_backtrace( DEBUG_BACKTRACE_IGNORE_ARGS, 1 );

		if ( ! empty( $trace ) && ! empty( $trace[0]['file'] ) ) {
			$route->attribute( '__definition', $trace[0]['file'] . ':' . $trace[0]['line'] );
		}

		$this->router->addRoute( $route );
	}

	/**
	 * Handle a request by directly rendering a view.
	 *
	 * @param  string|string[] $views
	 * @return void
	 */
	public function view( $views ) {
		$this->handle( function () use ( $views ) {
			return $this->view_service->make( $views );
		} );
	}

	/**
	 * Match ALL requests.
	 *
	 * @param  string|Closure $handler
	 * @return void
	 */
	public function all( $handler = '' ) {
		$this->any()->url( '*' )->handle( $handler );
	}

	/**
	 * Match requests with a method of GET or HEAD.
	 *
	 * @return static $this
	 */
	public function get() {
		return $this->methods( ['GET', 'HEAD'] );
	}

	/**
	 * Match requests with a method of POST.
	 *
	 * @return static $this
	 */
	public function post() {
		return $this->methods( ['POST'] );
	}

	/**
	 * Match requests with a method of PUT.
	 *
	 * @return static $this
	 */
	public function put() {
		return $this->methods( ['PUT'] );
	}

	/**
	 * Match requests with a method of PATCH.
	 *
	 * @return static $this
	 */
	public function patch() {
		return $this->methods( ['PATCH'] );
	}

	/**
	 * Match requests with a method of DELETE.
	 *
	 * @return static $this
	 */
	public function delete() {
		return $this->methods( ['DELETE'] );
	}

	/**
	 * Match requests with a method of OPTIONS.
	 *
	 * @return static $this
	 */
	public function options() {
		return $this->methods( ['OPTIONS'] );
	}

	/**
	 * Match requests with any method.
	 *
	 * @return static $this
	 */
	public function any() {
		return $this->methods( ['GET', 'HEAD', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS'] );
	}
}


1		<?php
2		/**
3		* @package WPEmerge
4		* @author Atanas Angelov <[email protected]>
5		* @copyright 2017-2019 Atanas Angelov
6		* @license https://www.gnu.org/licenses/gpl-2.0.html GPL-2.0
7		* @link https://wpemerge.com/
8		*/
9
10		namespace WPEmerge\Routing;
11
12		use Closure;
13		use WPEmerge\Helpers\HasAttributesTrait;
14		use WPEmerge\Routing\Conditions\ConditionInterface;
15		use WPEmerge\View\ViewService;
16
17		/**
18		* Provide a fluent interface for registering routes with the router.
19		*/
20		class RouteBlueprint {
21		use HasAttributesTrait;
22
23		/**
24		* Router.
25		*
26		* @var Router
27		*/
28		protected $router = null;
29
30		/**
31		* View service.
32		*
33		* @var ViewService
34		*/
35		protected $view_service = null;
36
37		/**
38		* Constructor.
39		*
40		* @codeCoverageIgnore
41		* @param Router $router
42		* @param ViewService $view_service
43		*/
44		public function __construct( Router $router, ViewService $view_service ) {
45		$this->router = $router;
46		$this->view_service = $view_service;
47		}
48
49		/**
50		* Match requests using one of the specified methods.
51		*
52		* @param string[] $methods
53		* @return static $this
54		*/
55	1	public function methods( $methods ) {
56	1	$methods = $this->router->mergeMethodsAttribute(
57	1	(array) $this->getAttribute( 'methods', [] ),
58	1	(array) $methods
59		);
60
61	1	return $this->attribute( 'methods', $methods );
62		}
63
64		/**
65		* Set the condition attribute to a URL.
66		*
67		* @param string $url
68		* @param array<string, string> $where
69		* @return static $this
70		*/
71	1	public function url( $url, $where = [] ) {
72	1	return $this->where( 'url', $url, $where );
73		}
74
75		/**
76		* Set the condition attribute.
77		*
78		* @param string\|array\|ConditionInterface $condition
79		* @param mixed ,...$arguments
80		* @return static $this
81		*/
82	3	public function where( $condition ) {
83	3	if ( ! $condition instanceof ConditionInterface ) {
84	3	$condition = func_get_args();
85		}
86
87	3	$condition = $this->router->mergeConditionAttribute(
88	3	$this->getAttribute( 'condition', null ),
89		$condition
90		);
91
92	3	return $this->attribute( 'condition', $condition );
93		}
94
95		/**
96		* Set the middleware attribute.
97		*
98		* @param string\|string[] $middleware
99		* @return static $this
100		*/
101	1	public function middleware( $middleware ) {
102	1	$middleware = $this->router->mergeMiddlewareAttribute(
103	1	(array) $this->getAttribute( 'middleware', [] ),
104	1	(array) $middleware
105		);
106
107	1	return $this->attribute( 'middleware', $middleware );
108		}
109
110		/**
111		* Set the namespace attribute.
112		* This should be renamed to namespace for consistency once minimum PHP
113		* version is increased to 7+.
114		*
115		* @param string $namespace
116		* @return static $this
117		*/
118	1	public function setNamespace( $namespace ) {
119	1	$namespace = $this->router->mergeNamespaceAttribute(
120	1	$this->getAttribute( 'namespace', '' ),
121		$namespace
122		);
123
124	1	return $this->attribute( 'namespace', $namespace );
125		}
126
127		/**
128		* Set the query attribute.
129		*
130		* @param callable $query
131		* @return static $this
132		*/
133	1	public function query( $query ) {
134	1	$query = $this->router->mergeQueryAttribute(
135	1	$this->getAttribute( 'query', null ),
136		$query
137		);
138
139	1	return $this->attribute( 'query', $query );
140		}
141
142		/**
143		* Set the name attribute.
144		*
145		* @param string $name
146		* @return static $this
147		*/
148	1	public function name( $name ) {
149	1	return $this->attribute( 'name', $name );
150		}
151
152		/**
153		* Create a route group.
154		*
155		* @param Closure\|string $routes Closure or path to file.
156		* @return void
157		*/
158	1	public function group( $routes ) {
159	1	$this->router->group( $this->getAttributes(), $routes );
160	1	}
161
162		/**
163		* Create a route.
164		*
165		* @param string\|Closure $handler
166		* @return void
167		*/
168	4	public function handle( $handler = '' ) {
169	4	if ( ! empty( $handler ) ) {
170	1	$this->attribute( 'handler', $handler );
171		}
172
173	4	$route = $this->router->route( $this->getAttributes() );
174
175	4	$trace = debug_backtrace( DEBUG_BACKTRACE_IGNORE_ARGS, 1 );
176
177	4	if ( ! empty( $trace ) && ! empty( $trace[0]['file'] ) ) {
178	4	$route->attribute( '__definition', $trace[0]['file'] . ':' . $trace[0]['line'] );
179		}
180
181	4	$this->router->addRoute( $route );
182	4	}
183
184		/**
185		* Handle a request by directly rendering a view.
186		*
187		* @param string\|string[] $views
188		* @return void
189		*/
190	1	public function view( $views ) {
191		$this->handle( function () use ( $views ) {
192	1	return $this->view_service->make( $views );
193	1	} );
194	1	}
195
196		/**
197		* Match ALL requests.
198		*
199		* @param string\|Closure $handler
200		* @return void
201		*/
202	1	public function all( $handler = '' ) {
203	1	$this->any()->url( '*' )->handle( $handler );
204	1	}
205
206		/**
207		* Match requests with a method of GET or HEAD.
208		*
209		* @return static $this
210		*/
211	1	public function get() {
212	1	return $this->methods( ['GET', 'HEAD'] );
213		}
214
215		/**
216		* Match requests with a method of POST.
217		*
218		* @return static $this
219		*/
220	1	public function post() {
221	1	return $this->methods( ['POST'] );
222		}
223
224		/**
225		* Match requests with a method of PUT.
226		*
227		* @return static $this
228		*/
229	1	public function put() {
230	1	return $this->methods( ['PUT'] );
231		}
232
233		/**
234		* Match requests with a method of PATCH.
235		*
236		* @return static $this
237		*/
238	1	public function patch() {
239	1	return $this->methods( ['PATCH'] );
240		}
241
242		/**
243		* Match requests with a method of DELETE.
244		*
245		* @return static $this
246		*/
247	1	public function delete() {
248	1	return $this->methods( ['DELETE'] );
249		}
250
251		/**
252		* Match requests with a method of OPTIONS.
253		*
254		* @return static $this
255		*/
256	1	public function options() {
257	1	return $this->methods( ['OPTIONS'] );
258		}
259
260		/**
261		* Match requests with any method.
262		*
263		* @return static $this
264		*/
265	1	public function any() {
266	1	return $this->methods( ['GET', 'HEAD', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS'] );
267		}
268		}
269

htmlburger / wpemerge

RouteBlueprint::handle() A last analyzed 2022-04-16 17:23 UTC

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like

RouteBlueprint::handle() A
last analyzed 2022-04-16 17:23 UTC