Переключение функций, объясненное с помощью переключателя Кандидата

 php artisan make : middleware APIToggleMiddleware 

В результате файл APIToggleMiddleware.php создается в каталоге app/Http/Middleware . Поскольку глобальное промежуточное ПО запускается раньше, чем для конкретного маршрута, мы будем использовать переключатель, который мы создали в нашем глобальном промежуточном ПО. Причина, по которой мы не определили переключатель внутри промежуточного программного обеспечения для конкретного маршрута, заключается в том, что нам могут понадобиться эти переключатели во всех контроллерах.

 <?php namespace App \ Http \ Middleware ; use Config ; use Closure ; class APIToggleMiddleware { /** * Handle an incoming request. * * @param \Illuminate\Http\Request $request * @param \Closure $next * @return mixed */ public function handle ( $request , Closure $next ) { if ( Config : : get ( 'toggles.newFeature' ) ) { abort ( 404 , 'Page Not Found!' ) ; } return $next ( $request ) ; } } 

В предыдущем коде мы использовали сервис Config для получения статуса переключателя newFeature . Если это ложь, мы просто выбрасываем ошибку 404 .

Чтобы зарегистрировать это промежуточное ПО, мы добавляем имя класса промежуточного ПО в свойство $routeMiddleware в app/Http/Kernel.php . $routeMiddleware — это ассоциативный массив, в котором $routeMiddleware все промежуточные программы, относящиеся к конкретному маршруту, поэтому нам также необходимо указать ключ для нашего промежуточного ПО. В нашем случае: api-toggle :

 <?php /** * The application's route middleware. * * @var array */ protected $routeMiddleware = [ 'auth' = > \ App \ Http \ Middleware \ Authenticate : : class , 'auth.basic' = > \ Illuminate \ Auth \ Middleware \ AuthenticateWithBasicAuth : : class , 'guest' = > \ App \ Http \ Middleware \ RedirectIfAuthenticated : : class , 'api-toggle' = > '\App\Http\MiddleWare\APIToggleMiddleware' , ] ; 

Теперь мы можем использовать промежуточное ПО внутри нашего файла app/http/routes.php как промежуточное ПО:

 <?php Route : : group ( 'new-feature/api' , [ 'middleware' = > 'api-toggle' ] , function ( ) { Route : : get ( 'new-feature/' , function ( ) { . . . } ) ; Route : : get ( 'new-feature/create' , function ( ) { . . . } ) ; Route : : put ( 'new-feature/{id}' , function ( ) { . . . } ) ; } ) ; 

В результате все маршруты в new-feature/api будут доступны только пользователям с идентификационными номерами ниже 100.

Стратегии переключения

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

Для этого нам нужно указать желаемую стратегию при создании объекта-переключателя:

 <?php // ... $toggle = new Toggle ( 'newFeature' , $conditions , Toggle : : STRATEGY_AFFIRMATIVE ) ; // ... 

утвердительный

Это стратегия по умолчанию, которую Toggle использует для проверки условий переключения. В этом случае должно быть выполнено хотя бы одно условие, чтобы переключатель был активным.

 <?php // ... $manager = new ToggleManager ( new InMemoryCollection ( ) ) ; $conditions = [ ] ; $conditions [ ] = new OperatorCondition ( 'user_id' , new LessThan ( 100 ) ) ; $conditions [ ] = new OperatorCondition ( 'age' , new GreaterThan ( 21 ) ) ; $toggle = new Toggle ( 'newFeature' , $conditions , Toggle : : STRATEGY_AFFIRMATIVE ) ; $manager - > add ( $toggle ) ; $context = new Context ( ) ; $context - > set ( 'user_id' , 100 ) - > set ( 'age' , 20 ) ; if ( $toggle - > activeFor ( $context ) ) { echo 'The toggle is active' ;  // Do something here } 

Вышеупомянутый переключатель будет включен, потому что одно из условий ( user_id ) выполнено.

большинство

В стратегии большинства необходимо выполнить большинство условий. Например, если у нас есть три условия для переключения, должно быть выполнено как минимум два из них.

 <?php // ... $manager = new ToggleManager ( new InMemoryCollection ( ) ) ; $conditions = [ ] ; $conditions [ ] = new OperatorCondition ( 'user_id' , new LessThan ( 42 ) ) ; $conditions [ ] = new OperatorCondition ( 'age' , new GreaterThan ( 24 ) ) ; $conditions [ ] = new OperatorCondition ( 'height' , new GreaterThan ( 5.7 ) ) ; $toggle = new Toggle ( 'newFeature' , $conditions , Toggle : : STRATEGY_MAJORITY ) ; $manager - > add ( $toggle ) ; $context = new Context ( ) ; $context - > set ( 'user_id' , 41 ) ; - > set ( 'age' , 25 ) ; - > set ( 'height' , 5.6 ) ; if ( $toggle - > activeFor ( $context ) ) { echo 'The toggle is active.'  // Do something special here } 

В предыдущем коде переключение будет включено, потому что два ( user_id и age ) из трех условий выполнены.

единодушное

При переключении на единодушную стратегию должны быть выполнены все условия:

 <?php // ... $manager = new ToggleManager ( new InMemoryCollection ( ) ) ; $conditions = [ ] ; $conditions [ ] = new OperatorCondition ( 'user_id' , new LessThan ( 42 ) ) ; $conditions [ ] = new OperatorCondition ( 'age' , new GreaterThan ( 24 ) ) ; $conditions [ ] = new OperatorCondition ( 'height' , new GreaterThan ( 5.7 ) ) ; $toggle = new Toggle ( 'newFeature' , $conditions , Toggle : : STRATEGY_MAJORITY ) ; $manager - > add ( $toggle ) ; $context = new Context ( ) ; $context - > set ( 'user_id' , 41 ) ; - > set ( 'age' , 25 ) ; - > set ( 'height' , 5.6 ) ; if ( $toggle - > activeFor ( $context ) ) { echo 'The toggle is active.'  // Do something special here } 

В приведенном выше примере переключение будет отключено, поскольку третье условие ( height ) не выполняется в зависимости от значения контекста.

 <?php // Conditions here $toggle - > activate ( Toggle : : CONDITIONALLY_ACTIVE ) ; $manager - > add ( $toggle ) ; $context = new Context ( ) ; $context - > set ( 'user_id' , 41 ) ; - > set ( 'age' , 25 ) ; - > set ( 'height' , 5.6 ) ; if ( $toggle - > activeFor ( $context ) ) { echo 'The toggle is active.'  // Do something special here } 

 <?php // ... // Array value $data = [ 'some-feature' = > [ 'name' = > 'newFeatureToggle' , 'conditions' = > [ [ 'name' = > 'operator-condition' , 'key' = > 'user_id' , 'operator' = > [ 'name' = > 'greater-than' , 'value' = > 41 ] , ] , ] , 'status' = > 'conditionally-active' , ] , ] ; 

 <?php use Qandidate \ Toggle \ Context ; use Qandidate \ Toggle \ ToggleManager ; use Qandidate \ Toggle \ Serializer \ InMemoryCollectionSerializer ; // $data array ( // ... // ); $serializer = new InMemoryCollectionSerializer ( ) ; $collection = $serializer - > deserialize ( $data ) ; $manager = new ToggleManager ( $collection ) ; $context = new Context ( ) ; $context - > set ( 'user_id' , 42 ) ; if ( $manager - > active ( 'some-feature' , $context ) ) { echo 'The toggle is Active' ;  // Do something special here }