Docs

Author: dereuromark

docs/Authorization.md

@@ -306,6 +306,12 @@ if ($this->AuthUser->hasAccess(['action' => 'secretArea'])) {
 }
 ```
 
+### Named Routes
+With 1.12.0+ named routes are also supported now:
+```php
+<?= $this->AuthUser->link('Change Password', ['_name' => 'admin:account:password']); ?>  
+```
+
 ## Including Authentication
 Please note that by default `hasAccess()` only checks the ACL INI, not the allow auth INI.
 Those links and access checks are meant to be used for logged in users.

src/View/Helper/AuthUserHelper.php

@@ -3,10 +3,10 @@
 namespace TinyAuth\View\Helper;
 
 use Cake\Core\Exception\Exception;
-use Cake\View\Helper;
-use Cake\View\View;
 use Cake\Routing\Exception\MissingRouteException;
 use Cake\Routing\Router;
+use Cake\View\Helper;
+use Cake\View\View;
 use TinyAuth\Auth\AclTrait;
 use TinyAuth\Auth\AuthUserTrait;
 
@@ -45,8 +45,8 @@ public function __construct(View $View, array $config = []) {
 	 */
 	public function hasAccess(array $url) {
 		if (isset($url['_name'])) {
-            $routes = Router::getRouteCollection()->named();
-            if (isset($routes[$url['_name']])) {
+			$routes = Router::getRouteCollection()->named();
+			if (isset($routes[$url['_name']])) {
 				$defaults = $routes[$url['_name']]->defaults;
 				if (!isset($defaults['action']) || !isset($defaults['controller'])) {
 					throw new Exception('Controller or action name could not be null.');
@@ -57,10 +57,10 @@ public function hasAccess(array $url) {
 					'controller' => $defaults['controller'],
 					'action' => $defaults['action'],
 				];
-            } else {
+			} else {
 				throw new MissingRouteException(['url' => $url['_name']]);
 			}
-        } else {
+		} else {
 			$params = $this->_View->getRequest()->getAttribute('params');
 			$url += [
 				'prefix' => !empty($params['prefix']) ? $params['prefix'] : null,

tests/TestCase/View/Helper/AuthUserHelperTest.php

@@ -4,7 +4,9 @@
 
 use Cake\Cache\Cache;
 use Cake\Core\Configure;
+use Cake\Core\Exception\Exception;
 use Cake\Core\Plugin;
+use Cake\Routing\Exception\MissingRouteException;
 use Cake\Routing\Router;
 use Cake\TestSuite\TestCase;
 use Cake\View\View;
@@ -52,8 +54,7 @@ public function setUp() {
 	 *
 	 * @return void
 	 */
-	public function tearDown()
-	{
+	public function tearDown() {
 		parent::tearDown();
 		Router::reload();
 	}
@@ -159,7 +160,7 @@ public function testNamedRouteMissingControllerActionException() {
 		);
 
 		$request = ['_name' => 'Tags::edit'];
-		$this->expectException(\Cake\Core\Exception\Exception::class);
+		$this->expectException(Exception::class);
 		$this->expectExceptionMessage('Controller or action name could not be null.');
 		$result = $this->AuthUserHelper->hasAccess($request);
 	}
@@ -184,7 +185,7 @@ public function testInvalidNamedRouteException() {
 
 		$request = ['_name' => 'InvalidName'];
 
-		$this->expectException(\Cake\Routing\Exception\MissingRouteException::class);
+		$this->expectException(MissingRouteException::class);
 
 		$this->AuthUserHelper->hasAccess($request);
 	}