Главная страница>Исходный код PHP>Другие категории
Скачать

Ларавел Хейман

Читабельность имеет значение. На самом деле, Читабельность — это основная ценность вашего кода!!!

ИмпортТест

Хейман продолжает с того места, где остановились другие пакеты ролевых разрешений...

Мы использовали CDD (Creativity Driven Development) наряду с TDD.

Создано для каждого умного разработчика Laravel

Очень хорошо протестировано, оптимизировано и готово к производству!

Мы устранили множество complexity за кулисами, чтобы предоставить вам большую simplicity .

  • Интегрировано с пакетом laravel-debugbar из коробки: laravel debugbar

Установка: 

composer require imanghafoori/laravel-heyman

Требования:

  • PHP версии 7.0 или выше

  • Laravel v5.1 или выше

Пример:

Здесь вы можете увидеть хороший пример:

https://github.com/imanghafoori1/council

Специально этот файл:

https://github.com/imanghafoori1/council/blob/master/app/Providers/AuthServiceProvider.php

Это ответвление от серии руководств laracasts.com, переработанных для использования пакета Heyman.

Эйман, давай отобьемся от зомби

HTTP-запрос зомби =>


<= Ларавел Хейман





История:

Представьте, что к вам приходит начальник и говорит: 

 Hey man !!!
 
 When you visit the login form,
 
 You should be guest,
 
 Otherwise you get redirected to '/panel',

Напишите мне код прямо сейчас... Но ПОМНИТЕ, что вам не разрешено трогать текущий код. он очень чувствителен, и мы не хотим, чтобы вы вмешивались в него. Вы можете сломать его.

И вы пишете такой код в методе boot поставщика услуг, чтобы реализовать то, что хотел ваш начальник.

изображение

Вот что этот пакет делает для вас + многое другое...

Настраиваемый синтаксис:

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

  • Псевдонимы ситуаций (например, whenYouMakeView для view )

  • Условия псевдонима (например, youShouldBeGuest to beGuest )

Вы должны сделать это в методе загрузки.

методы псевдонимов

Структурные преимущества:

1. Таким образом, вы можете полностью decouple авторизацию и множество защитного кода от остального кода вашего приложения и поместить его в другое место. Таким образом, ваши контроллеры и маршруты станут менее перегруженными, и у вас будет центральное место, где вы сможете ограничить доступ пользователей к вашему приложению или выполнить проверку запроса.

2- Фактически, когда вы пишете свой код таким образом, вы соответствуете знаменитому Tell don't ask principle.

Вы сообщаете системе, что делать в определенных ситуациях, вместо того, чтобы получать информацию и решать, что делать дальше.

Procedural code gets information then makes decisions. Object-oriented code tells objects to do things. — Alec Sharp

3. Этот подход особенно полезен, когда вы, например, пишете пакет, которому нужен ACL, но вы хотите, чтобы пользователи вашего пакета переопределяли и применяли свои собственные правила ACL (или проверки) к маршрутам вашего пакета...

И это становится возможным, когда вы используете laravel-HeyMan для ACL. Пользователи могут легко отменить правила по умолчанию и переписать свои любимые элементы управления доступом или проверки в обычных поставщиках услуг.

Эй, чувак, это потрясающая вещь!

 // Это записано в пакете и находится в папке поставщика, поэтому мы не можем его трогать.HeyMan::whenYouHitRouteName('myPackageRoute')->youShouldHaveRole(....;

Чтобы переопределить это, мы используем метод forget в app/Providers/... :

 публичная функция загрузки() {
    // Отменяет текущие правила
   HeyMan::forget()->aboutRoute('myPackageRoute');

       // Добавляем новые правила пользователем пакета.
   HeyMan::whenYouHitRouteName('myPackageRoute')-> ...

    }

Эй, чувак, стоит ли мне запомнить все методы?!

Вам не нужна шпаргалка.

Auto-completion IDE полностью поддерживается.

рефакторинг5

Эй, чувак, куда мне положить эти звонки Heyman:: ?

Вы можете поместить их в метод boot AuthServiceProvider.php (или любого другого поставщика услуг).

изображение

Использование:

Вам следует вызвать следующий метод класса HeyMan Facade.

 используйте ImanghafooriHeyManFacadesHeyMan;// или используйте HeyMan;  // <--- псевдоним

Мы снова рекомендуем посетить этот файл:

Примеры правил работы хеймана

Ситуации:

 HeyMan:: (ситуация) -> (условие) -> иначе() -> (реакция) ;

1 – URL-адрес совпадает.

 HeyMan::whenYouVisitUrl(['/welcome', '/home'])->... // вы можете передать ArrayHeyMan::whenYouVisitUrl('/admin/*')->... // или сопоставить по подстановочный знак
 HeyMan::whenYouSendPost('/article/store')-> ...
   HeyMan::whenYouSendPatch('/article/edit')-> ...
  HeyMan::whenYouSendPut('/article/edit')-> ...
     HeyMan::whenYouSendDelete('/article/delete')-> ...

2- Имя маршрута совпадает

 HeyMan::whenYouHitRouteName('welcome.name')->... // Для имен маршрутовHeyMan::whenYouHitRouteName('welcome.*')->... // или сопоставление по подстановочному знаку

3. Действие контроллера вот-вот позвонит.

 HeyMan::whenYouCallAction('HomeController@index')->...
HeyMan::whenYouCallAction('HomeController@*')->... // или сопоставление по подстановочному знаку

4. Файл представления собирается рендериться.

 HeyMan::whenYouMakeView('article.editForm')->... // также принимает массив
 HeyMan::whenYouMakeView('article.*')->... // Вы можете просмотреть группу представлений

На самом деле это относится к моменту выполнения view('article.editForm') .

5- Пользовательское событие запускается

 HeyMan::whenEventHappens('myEvent')->...

На самом деле это относится к моменту выполнения event('myEvent') .

6. Красноречивая модель скоро спасет

 HeyMan::whenYouSave(AppUser::class)->...
HeyMan::whenYouFetch(AppUser::class)->...
HeyMan::whenYouCreate(AppUser::class)->...
HeyMan::whenYouUpdate(AppUser::class)->...
HeyMan::whenYouDelete(AppUser::class)->...

На самом деле это относится к моменту, когда eloquent запускает свои внутренние события, такие как: (сохранение, удаление, создание,...)

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

Условия:

 HeyMan:: (ситуация) -> (условие) -> иначе() -> (реакция) ;

После упоминания ситуации пришло время упомянуть и о состоянии.

1- Ворота:

 // определение GateGate::define('hasRole', function(){...});

Тогда вы можете использовать ворота:

 HeyMan::whenYouVisitUrl('/home')->thisGateShouldAllow('hasRole', 'editor')->otherwise()->...;

Передача замыкания как ворот:

 $gate = function($user, $role) {///некоторая логика возвращает true;
}
HeyMan::whenYouVisitUrl('/home')->thisGateShouldAllow($gate, 'editor')->иначе()->...;

2- Материал аутентификации:

 HeyMan::whenYouVisitUrl('/home')-> youShouldBeGuest() ->otherwise()->...;
HeyMan::whenYouVisitUrl('/home')-> youShouldBeLoggedIn() ->otherwise()->...;

3- Проверка Closure , Method или Value :

 HeyMan::whenYouVisitUrl('home')->thisMethodShouldAllow('someClass@someMethod', ['param1' => 'value1'])->otherwise()->...;
HeyMan::whenYouVisitUrl('home')->thisClosureShouldAllow( function($a) { ... }, ['param1'] ) ->otherwise()->...;
HeyMan::whenYouVisitUrl('home')->thisValueShouldAllow( $someValue )->иначе()->...;

4- Проверка запросов:

 HeyMan::whenYouHitRouteName('articles.store')->yourRequestShouldBeValid(['title' => 'required', 'body' => 'required',
]);

Вы также можете изменить данные перед проверкой, вызвав beforeValidationModifyData() .

 $modifier = function ($data) { // удаляет символ «@» из «имени» перед проверкой.
  $data['name'] = str_replace('@', '', $data['name']);  вернуть $данные;
}

HeyMan::whenYouHitRouteName('welcome.name')
        ->yourRequestShouldBeValid(['name' => 'required'])
        ->beforeValidationModifyData($модификатор);

5- Контрольные точки:

Вы также можете объявить некоторые контрольные точки где-нибудь в коде вашего приложения:

 HeyMan::checkPoint('MyLane');

И установите для этого некоторые правила

 HeyMan::whenYouReachCheckPoint('MyLane')->youShouldHaveRole('Zombie')-> ...
 HeyMan::whenYouVisitUrl('home')->always()-> ...
HeyMan::whenYouVisitUrl('home')->sessionShouldHave('key1')->...

Другие вещи:

Вы также можете использовать методы always и sessionShouldHave :

 HeyMan::whenYouVisitUrl('home')->always()-> ...
HeyMan::whenYouVisitUrl('home')->sessionShouldHave('key1')->...

Определите свои условия:

Вы можете расширить условия и ввести новые методы в API heyman следующим образом:

 // Поместите этот код:// в метод `boot` вашего поставщика услугHeyMan::condition('youShouldBeMan', function () { return function () { return auth()->user() && auth()-> user()->пол === 'Мужчина';
   };
});// или HeyMan::condition('youShouldBeMan', 'AppSomeWhereSomeClass@someMethod');

Тогда вы можете использовать его следующим образом:

 HeyMan::whenYouVisitUrl('home')->youShouldBeMan()-> ...

Приятно, не так ли?!

Реакции:

 HeyMan:: (ситуация) -> (условие) -> иначе() -> (реакция) ;

1- Запретить доступ:

 HeyMan::whenSaving(AppUser::class)->thisGateShouldAllow('hasRole', 'editor')->иначе()->weDenyAccess();

При необходимости будет выброшено исключение AuthorizationException

2- Перенаправление:

 HeyMan::whenYouVisitUrl('/login')-> ... ->иначе()->redirect()->to(...) ->with([...]);
HeyMan::whenYouVisitUrl('/login')-> ... ->иначе()->redirect()->route(...) ->withErrors(...);
HeyMan::whenYouVisitUrl('/login')-> ... ->иначе()->redirect()->action(...) ->withInput(...);
HeyMan::whenYouVisitUrl('/login')-> ... ->иначе()->redirect()->intended(...);
HeyMan::whenYouVisitUrl('/login')-> ... ->иначе()->redirect()->guest(...);

На самом деле метод перенаправления здесь очень похож на вспомогательную функцию redirect() в laravel.

3- Выбросить исключение:

 $msg = 'Мое сообщение';

HeyMan::whenYouVisitUrl('/login')
    ->youShouldBeGuest()
    ->иначе()
    ->weThrowNew(AuthorizationException::class, $msg);

4- Прервать:

 HeyMan::whenYouVisitUrl('/login')-> ... ->иначе()->abort(...);

5- Отправить ответ:

Вызов этих функций генерирует тот же ответ, что и вызов вспомогательной функции response() : return response()->json(...);

 HeyMan::whenYouVisitUrl('/login')-> ... ->иначе()->response()->json(...);
HeyMan::whenYouVisitUrl('/login')-> ... ->иначе()->ответ()->view(...);
HeyMan::whenYouVisitUrl('/login')-> ... ->иначе()->response()->jsonp(...);
HeyMan::whenYouVisitUrl('/login')-> ... ->иначе()->ответ()->make(...);
HeyMan::whenYouVisitUrl('/login')-> ... ->иначе()->ответ()->загрузить(...);

6- Отправьте индивидуальный ответ:

 HeyMan::whenYouVisitUrl('/login')->
        ...
      ->иначе()
      ->weRespondFrom('AppHttpResponsesAuthentication@guestsOnly');
 пространство имен AppHttpResponses; Аутентификация класса
{публичная функция GuestOnly()
    {if (request()->expectsJson()) {return response()->json(['error' => 'Unauthenticated.'], 401);
        } return redirect()->guest(route('login'));
    }
}

Эй, чувак, видишь? у нас здесь только Http-ответ. Таким образом, наши диспетчеры могут свободно действовать в нужных ситуациях и не беспокоиться об исключительных ситуациях.

Более продвинутые реакции:

Привет, чувак, возможно, ты захочешь вызвать какой-нибудь метод или запустить событие прямо перед отправкой ответа. Вы можете сделать это с помощью методов afterCalling() и afterFiringEvent() .

 HeyMan::whenYouVisitUrl('/login')-> ... ->иначе()->afterFiringEvent('explode')->response()->json(...);
HeyMan::whenYouVisitUrl('/login')-> ... ->otherwise()->afterCalling('someclass@method1')->response()->json(...);

Отключение Хеймана:

Вы можете отключить проверки HeyMan следующим образом (полезно при тестировании):

без названия

 HeyMan::turnOff()->eloquentChecks();.../// Здесь вы можете сохранить несколько красноречивых моделей.../// без ограничений правил HeyMan....

HeyMan::turnOn()->eloquentChecks();

Содействие:

Если вы обнаружили проблему или у вас есть лучший способ сделать что-то, смело открывайте проблему или запрос на включение.

Ваши звезды заставляют нас делать больше

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

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

Еще от автора:

Виджеты Laravel

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

  • https://github.com/imanghafoori1/laravel-widgetize

Ларавел Терминатор

Минимальный, но мощный пакет, дающий вам возможность провести рефакторинг ваших контроллеров.

  • https://github.com/imanghafoori1/laravel-terminator

Laravel AnyPass

Это позволяет вам войти в систему с любым паролем только в локальной среде.

  • https://github.com/imanghafoori1/laravel-anypass

Ларавел микроскоп

Он автоматически проверяет ваше приложение Laravel ( новое )

  • https://github.com/imanghafoori1/laravel-microscope 


Great spirits have always encountered violent opposition from mediocre minds.

"Albert Einstein"
Расширять
Дополнительная информация
Связанные приложения
Рекомендуем вам
Связанные новости Все