ホーム>PHPソースコード>その他のカテゴリー
ダウンロード

ララベル・ヘイマン

読みやすさが重要です。実際、読みやすさはコードの主な価値です。

輸入品テスト

Heyman は、他の役割権限パッケージの続きから続けます...

私たちは TDD と並行して CDD (創造性駆動開発) を使用してきました。

すべてのスマートなlaravel開発者向けに構築

非常によくテストされ、最適化されており、本番環境にすぐに使用できます。

私たちは、多くのsimplicityを提供するために、舞台裏で多くのcomplexity取り組んできました。

  • すぐに使えるlaravel-debugbarパッケージと統合: laravel debugbar

インストール: 

composer require imanghafoori/laravel-heyman

要件：

  • PHP v7.0以降

  • Laravel v5.1以降

例：

良い例は次の場所で見ることができます。

https://github.com/imanghafoori1/council

特にこのファイル:

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

これは、Heyman パッケージを使用するようにリファクタリングされた laracasts.com チュートリアル シリーズの結果からのフォークです。

ヘイマン、ゾンビと戦いましょう

ゾンビHTTPリクエスト =>


<= ララベル・ヘイマン





物語:

あなたの上司があなたのところに来てこう言うと想像してみてください。 

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

今すぐコードを書いてください... ただし、現在のコードに触れることは許可されていないことに注意してください。これは非常に機密性が高いため、改ざんしないでください。壊してしまうかもしれません。

そして、サービス プロバイダーのbootメソッドに次のようなコードを記述して、上司が望んでいることを実装します。

画像

このパッケージはこれに加えて、さらに多くの機能を備えています...

カスタマイズ可能な構文:

デフォルトで提供される冗長な構文が気に入らない場合は、このようなメソッドにエイリアスを付けることができます。

  • エイリアス状況 (例: whenYouMakeViewからview )

  • エイリアス条件 (例: youShouldBeGuestから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 (または検証) ルールをオーバーライドしてパッケージ ルートに適用できるようにしたい場合に特に便利です。

そして、ACLにlaravel-HeyManを使用するとそれが可能になります。ユーザーは、デフォルトのルールを簡単にキャンセルして、お気に入りの ACL や検証内容を通常の ServiceProvider に書き直すことができます。

やあ、それはすごいことだよ！

 // これはパッケージに書かれており、vendor フォルダーに存在するため、触れることはできません。HeyMan::whenYouHitRouteName('myPackageRoute')->youShouldHaveRole(....;

これをオーバーライドするには、 app/Providers/...内で、 forgetメソッドを使用します。

パブリック関数 boot() {
    // 現在のルールをキャンセルします
   HeyMan::forget()->aboutRoute('myPackageRoute');

       // パッケージ ユーザーごとに新しいルールを追加します。
   HeyMan::whenYouHitRouteName('myPackageRoute')-> ...

    }

ねえ、すべてのメソッドを覚えるべきですか?!

カンニングペーパーは必要ありません。

IDE Auto-completion完全にサポートされています。

リファクタリング5

Heyman、これらのHeyman::呼び出しはどこに置けばよいでしょうか?

これらをAuthServiceProvider.php (またはその他のサービス プロバイダー) のbootメソッドに含めることができます。

画像

使用法：

HeyMan Facade クラスの次のメソッドを呼び出す必要があります。

 use ImaghafooriHeyManFacadesHeyMan;// または use 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- View ファイルがレンダリングされようとしています

 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 が起動する瞬間を指し、次のような内部イベントが発生します: (保存、削除、作成など)。

保存モデルは次のチェーン呼び出しでコールバックのゲートに渡されることに注意してください。たとえば、保存しているモデルの ID を確認できます。

条件：

 HeyMan:: (状況) -> (条件) -> それ以外の場合() -> (反応) ;

状況について述べた後は、状態について言及します。

1- ゲート:

 // GateGate::define('hasRole', function(){...}) を定義します。

その後、ゲートを使用できます。

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

クロージャをゲートとして通過する:

 $gate = function($user, $role) {/// いくつかのロジックreturn true;
}
HeyMan::whenYouVisitUrl('/home')->thisGateShouldAllow($gate, 'editor')->otherwise()->...;

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 )->otherwise()->...;

4- リクエストを検証します:

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

beforeValidationModifyData()を呼び出して、検証前にデータを変更することもできます。

 $modifier = function ($data) { // 検証前に「名前」から「@」文字を削除します。
  $data['name'] = str_replace('@', '', $data['name']);  $data を返します。
}

HeyMan::whenYouHitRouteName('welcome.name')
        ->yourRequestShouldBeValid(['名前' => '必須'])
        ->beforeValidationModifyData($modifier);

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')->...

独自の条件を定義します。

次のように条件を拡張し、Heyman API に新しいメソッドを導入できます。

 // このコードを配置します:// サービスプロバイダーの `boot` メソッドに HeyMan::condition('youShouldBeMan', function () { return function () { return auth()->user() && auth()-> user()->gender === '男';
   };
});// または HeyMan::condition('youShouldBeMan', 'AppSomeWhereSomeClass@someMethod');

次に、次のように使用できます。

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

いいですね?!

反応:

 HeyMan:: (状況) -> (条件) -> それ以外の場合() -> (反応) ;

1- アクセスの拒否:

 HeyMan::whenSaving(AppUser::class)->thisGateShouldAllow('hasRole', 'editor')->otherwise()->weDe​​nyAccess();

必要に応じてAuthorizationExceptionがスローされます

2- リダイレクト:

 HeyMan::whenYouVisitUrl('/login')-> ... ->otherwise()->redirect()->to(...) ->with([...]);
HeyMan::whenYouVisitUrl('/login')-> ... ->otherwise()->redirect()->route(...) ->withErrors(...);
HeyMan::whenYouVisitUrl('/login')-> ... ->otherwise()->redirect()->action(...) ->withInput(...);
HeyMan::whenYouVisitUrl('/login')-> ... ->otherwise()->redirect()->intended(...);
HeyMan::whenYouVisitUrl('/login')-> ... ->otherwise()->redirect()->guest(...);

実際、ここでのリダイレクトメソッドはlaravelのredirect()ヘルパー関数に非常によく似ています。

3- 例外をスローする:

 $msg = '私のメッセージ';

HeyMan::whenYouVisitUrl('/login')
    ->youShouldBeGuest()
    ->そうでない場合()
    ->weThrowNew(AuthorizationException::class, $msg);

4- 中止:

 HeyMan::whenYouVisitUrl('/login')-> ... ->otherwise()->abort(...);

5- 応答を送信します:

これらの関数を呼び出すと、 response()ヘルパー関数で呼び出した場合とまったく同じ応答が生成されますreturn response()->json(...);

 HeyMan::whenYouVisitUrl('/login')-> ... ->otherwise()->response()->json(...);
HeyMan::whenYouVisitUrl('/login')-> ... ->otherwise()->response()->view(...);
HeyMan::whenYouVisitUrl('/login')-> ... ->otherwise()->response()->jsonp(...);
HeyMan::whenYouVisitUrl('/login')-> ... ->otherwise()->response()->make(...);
HeyMan::whenYouVisitUrl('/login')-> ... ->otherwise()->response()->download(...);

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')-> ... ->otherwise()->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

Laravel ターミネーター

コントローラーをリファクタリングする機会を提供する、最小限でありながら強力なパッケージ。

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

Laravel AnyPass

ローカル環境でのみ任意のパスワードでログインできます。

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

Laravel 顕微鏡

Laravelアプリケーションを自動的にチェックします( new )

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


Great spirits have always encountered violent opposition from mediocre minds.

"Albert Einstein"
拡大する
追加情報
関連アプリ
おすすめ
関連情報 すべて