Контролируйте доступ пользователей к классам и методам с помощью Rauth

Примечание по режимам: если у пользователя есть групповой атрибут «admin», он может получить доступ ко всем методам с помощью @auth-groups admin . Если mode установлен на @auth-mode OR (это значение по умолчанию и его можно опустить), то пользователь сможет получить доступ к методам с помощью @auth-groups admin, users, banana , потому что им нужен только один из группы определены. Когда режим AND ( @auth-mode AND ), они должны иметь ВСЕ группы. Если режим NONE как в методе banned() , пользователь НЕ ДОЛЖЕН иметь ЛЮБОЙ из групп.

Помните, что auth- может быть чем угодно — не обязательно должна быть groups . Вы можете использовать совершенно произвольные значения, такие как @auth-banana ripe и тогда пользователь с атрибутом 'banana' => 'ripe' сможет получить доступ к классу / методу.

Пример внедрения зависимости

Приведенный выше пример представляет собой элементарную демонстрацию потока авторизации. Теперь давайте настроим ситуацию, в которой маршрут разрешен, контроллер автоматически вызывается контейнером внедрения зависимостей, и проверка авторизации выполняется автоматически. Другими словами, основанный на передовом опыте подход к запуску нового приложения — один из них — фреймворк без фреймворка — основан на.

 composer require sitepoint / rauth php - di / php - di nikic / fast - route 

Давайте также Controllers папку Controllers и поместим туда два контроллера:

 <?php // Controllers/OneController.php namespace MyApp ; class OneController { public function homeAction ( ) { echo "This is the home screen!" ; } } 

 <?php namespace MyApp ; /** * Class AnotherController * @package MyApp */ class AnotherController { public function indexAction ( ) { echo "This is the second controller, index action, accessible to all" ; } /** * @auth-groups users */ public function onlyLoggedInAction ( ) { echo "This action can only be accessed by logged in users" ; } /** * @auth-groups users * @auth-mode NONE */ public function onlyLoggedOutAction ( ) { echo "This action can only be accessed by visitors who are not logged in" ; } } 

Нам также потребуется настроить автозагрузчик для загрузки этих контроллеров:

 "autoload" : { "psr-4" : { "MyApp\\" : "Controllers" } } 

И восстановите файлы автозагрузки с:

 composer du 

Следующим шагом является настройка маршрутов и контейнера внедрения зависимостей в соответствии с документацией PHP-DI. Наш файл index.php должен быть изменен так:

 <?php // index.php require_once 'vendor/autoload.php' ; use SitePoint \ Rauth ; use FastRoute \ RouteCollector ; use FastRoute \ Dispatcher ; use DI \ ContainerBuilder ; $containerBuilder = new ContainerBuilder ; $containerBuilder - > addDefinitions ( [ ] ) ; $container = $containerBuilder - > build ( ) ; $routeList = [ [ 'GET' , '/one-home' , [ 'MyApp\OneController' , 'homeAction' ] ] , [ 'GET' , '/another-index' , [ 'MyApp\AnotherController' , 'indexAction' ] ] , [ 'GET' , '/another/loggedin' , [ 'MyApp\AnotherController' , 'onlyLoggedInAction' ] ] , [ 'GET' , '/another/loggedout' , [ 'MyApp\AnotherController' , 'onlyLoggedOutAction' ] ] , ] ; /** @var Dispatcher $dispatcher */ $dispatcher = FastRoute\ simpleDispatcher ( function ( RouteCollector $r ) use ( $routeList ) { foreach ( $routeList as $routeDef ) { $r - > addRoute ( $routeDef [ 0 ] , $routeDef [ 1 ] , $routeDef [ 2 ] ) ; } } ) ; $route = $dispatcher - > dispatch ( $_SERVER [ 'REQUEST_METHOD' ] , $_SERVER [ 'REQUEST_URI' ] ) ; switch ( $route [ 0 ] ) { case FastRoute\ Dispatcher : : NOT_FOUND : die ( '404 not found!' ) ; case FastRoute\ Dispatcher : : METHOD_NOT_ALLOWED : die ( '405 method not allowed' ) ; case FastRoute\ Dispatcher : : FOUND : $controller = $route [ 1 ] ; $parameters = $route [ 2 ] ; $container - > call ( $controller , $parameters ) ; break ; } 

Сначала мы делаем новый пустой контейнер. Затем мы определяем некоторые маршруты (обычно это делается во внешнем файле, например routes.php ). Мы добавляем эти маршруты в диспетчер, чтобы он знал, что с ними делать, и, наконец, мы извлекаем элементы запускаемого маршрута и запускаем соответствующий контроллер. Достаточно просто, верно?

Теперь маршруты должны работать:

Пора добавить слой Rauth, чтобы фактически ограничить доступ к некоторым из этих маршрутов.

Сначала мы добавим определение User в контейнер:

 $containerBuilder - > addDefinitions ( [ 'User' = > function ( ) { return [ 'groups' = > 'users' , ] ; } , ] ) ; 

Обычно в этом есть какая-то логика, например, проверка базы данных для групп пользователей. Для целей данного руководства достаточно жесткого кодирования, поскольку фактическое управление пользователями выходит за рамки этой части.

 // [...] case FastRoute\ Dispatcher : : FOUND : $controller = $route [ 1 ] ; $parameters = $route [ 2 ] ; $rauth = new Rauth ( ) ; $attributes = $container - > get ( 'User' ) ? : [ 'groups' = > [ ] ] ; 

 try { $rauth - > authorize ( $controller [ 0 ] , $controller [ 1 ] , $attributes ) ; } catch ( Rauth \ Exception \ AuthException $e ) { die ( "Authorization failed" ) ; } 

 echo 'Failed due to: ' . $e - > getType ( ) . '. ' ; /** @var Rauth\Exception\Reason $reason */ foreach ( $e - > getReasons ( ) as $reason ) { echo 'Blocked by "' . $reason - > group . '" when comparing owned "' . implode ( ", " , $reason - > has ) . '" versus "' . implode ( ", " , $reason - > needs ) . '".' ; } die ( ) ; 

 @auth - groups users , admin @auth - ban - groups banned 

 @auth - groups users , admin @auth - ban - tags banana