الصفحة الرئيسية>PHP كود المصدر>فئات أخرى
تنزيل

لارافيل هيمان

التهم القراءة. في الواقع، سهولة القراءة هي القيمة الأساسية للتعليمات البرمجية الخاصة بك !!!

الوارداتامتحان

يستمر هيمان من حيث توقفت حزم أذونات الأدوار الأخرى...

لقد استخدمنا CDD (التطوير المدفوع بالإبداع) جنبًا إلى جنب مع TDD

تم تصميمه خصيصًا لكل مطور Laravel ذكي

تم اختباره جيدًا، وتحسينه، وجاهز للإنتاج!

لقد عالجنا الكثير من complexity خلف الكواليس، لنوفر لك الكثير من simplicity .

  • متكامل مع حزمة laravel-debugbar الجاهزة: laravel debugbar

تثبيت: 

composer require imanghafoori/laravel-heyman

متطلبات:

  • PHP v7.0 أو أعلى

  • لارافيل v5.1 أو أعلى

مثال:

هنا يمكنك رؤية مثال جيد على:

https://github.com/imanghafoori1/council

خصيصا هذا الملف:

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

هذه شوكة من نتيجة سلسلة دروس laracasts.com المعاد تصميمها لاستخدام حزمة Heyman.

هيمان، دعونا نقاتل الزومبي

طلب زومبي المتشعب =>


<= لارافيل هيمان





قصة:

تخيل أن رئيسك يأتي إليك ويقول: 

 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. يمكن للمستخدمين بسهولة إلغاء القواعد الافتراضية وإعادة كتابة قائمة التحكم بالوصول (ACL) المفضلة لديهم أو عناصر التحقق من الصحة في ServiceProviders العاديين.

يا رجل، هذا شيء مذهل!

 // هذا مكتوب في الحزمة وموجود في مجلد البائع، لذلك لا يمكننا لمسه.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)->...

في الحقيقة هي تشير إلى اللحظة التي تشتعل فيها الأحداث الداخلية مثل: (الحفظ، الحذف، الإنشاء، ...)

لاحظ أنه يتم تمرير نموذج الحفظ إلى بوابة رد الاتصال في المكالمة التسلسلية التالية. لذلك على سبيل المثال يمكنك التحقق من معرف النموذج الذي يتم حفظه.

شروط:

 HeyMan:: (الحالة) -> (الحالة) -> وإلا() -> (رد الفعل) ؛

وبعد ذكر الحال يأتي وقت ذكر الحال.

1- البوابات:

 // تعريف GateGate::define('hasRole', function(){...});

ثم يمكنك استخدام البوابة:

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

اجتياز الإغلاق كبوابة:

 $gate = function($user, $role) {// بعض المنطق يعود صحيحًا؛
}
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']);  إرجاع بيانات $؛
}

HeyMan::whenYouHitRouteName('welcome.name')
        ->yourRequestShouldBeValid(['name' => 'required'])
        ->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 مثل هذا:

 // ضع هذا الكود:// في طريقة "التمهيد" لمقدمي الخدمة لديكHeyMan::condition('youShouldBeMan', function () { return function () { return auth()->user() && auth()-> user()->gender === 'Man';
   };
});// أو HeyMan::condition('youShouldBeMan', 'AppSomeWhereSomeClass@someMethod');

ثم يمكنك استخدامه مثل هذا:

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

جميل أليس كذلك؟!

ردود الفعل:

 HeyMan:: (الحالة) -> (الحالة) -> وإلا() -> (رد الفعل) ؛

1- رفض الوصول:

 HeyMan::whenSaving(AppUser::class)->thisGateShouldAllow('hasRole', 'editor')->otherwise()->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()->intened(...);
HeyMan::whenYouVisitUrl('/login')-> ... ->خلاف ذلك()->redirect()->guest(...);

في الواقع، طريقة إعادة التوجيه هنا تشبه إلى حد كبير وظيفة المساعدة redirect() في Laravel.

3- رمي الاستثناء:

 $msg = 'رسالتي';

HeyMan::whenYouVisitUrl('/تسجيل الدخول')
    ->youShouldBeGuest()
    ->وإلا()
    ->weThrowNew(AuthorizationException::class, $msg);

4- الإجهاض:

 HeyMan::whenYouVisitUrl('/login')-> ... ->خلاف ذلك()->abort(...);

5- إرسال الرد:

يؤدي استدعاء هذه الوظائف إلى توليد نفس الاستجابة تمامًا مثل استدعائها على الوظيفة المساعدة response() : return response()->json(...);

 HeyMan::whenYouVisitUrl('/login')-> ... ->خلاف ذلك()->response()->json(...);
HeyMan::whenYouVisitUrl('/login')-> ... ->خلاف ذلك()->response()->view(...);
HeyMan::whenYouVisitUrl('/login')-> ... ->خلاف ذلك()->response()->jsonp(...);
HeyMan::whenYouVisitUrl('/login')-> ... ->خلاف ذلك()->response()->make(...);
HeyMan::whenYouVisitUrl('/login')-> ... ->خلاف ذلك()->response()->download(...);

6- إرسال الرد المخصص:

 HeyMan::whenYouVisitUrl('/login')->
        ...
      ->وإلا()
      ->weRespondFrom('AppHttpResponsesAuthentication@guestsOnly');
 مساحة الاسم AppHttpResponses؛ مصادقة الفئة
{ضيوف الوظيفة العامة فقط ()
    {if (request()->expectsJson()) {return Response()->json(['error' => 'Uauthenticated.'], 401);
        }return redirect()->guest(route('login'));
    }
}

يا رجل، هل ترى؟ لدينا فقط استجابة Http هنا. لذا فإن وحدات التحكم لدينا تتمتع بالحرية في التعامل مع المواقف الصحيحة ولا تقلق بشأن المواقف الاستثنائية.

المزيد من التفاعلات المتقدمة:

مرحبًا، قد ترغب في استدعاء طريقة ما أو إطلاق حدث قبل إرسال الرد مباشرةً. يمكنك القيام بذلك عن طريق أساليب afterCalling() و afterFiringEvent() .

 HeyMan::whenYouVisitUrl('/login')-> ... ->خلاف ذلك()->afterFiringEvent('explode')->response()->json(...);
HeyMan::whenYouVisitUrl('/login')-> ... ->خلاف ذلك()->afterCalling('someclass@method1')->response()->json(...);

تعطيل هيمان:

يمكنك تعطيل عمليات التحقق من HeyMan مثل هذا (مفيد أثناء الاختبار):

بدون عنوان

 HeyMan::turnOff()->eloquentChecks();.../// يمكنك حفظ بعض النماذج البليغة هنا.../// دون قيود من قواعد HeyMan....

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

المساهمة:

إذا وجدت مشكلة، أو كان لديك طريقة أفضل للقيام بشيء ما، فلا تتردد في فتح مشكلة أو طلب سحب.

نجومك يجعلوننا نفعل المزيد

كما هو الحال دائمًا، إذا وجدت هذه الحزمة مفيدة وتريد تشجيعنا على صيانتها والعمل عليها. فقط اضغط على زر النجمة للإعلان عن رغبتك.

تاريخ النجوم

المزيد من المؤلف:

لارافيل القطعة

حزمة بسيطة ولكنها قوية لتوفير بنية أفضل وفرصة للتخزين المؤقت لتطبيقات Laravel الخاصة بك.

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

لارافيل تيرمينيتور

حزمة بسيطة ولكنها قوية لتمنحك فرصة إعادة تصميم وحدات التحكم الخاصة بك.

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

لارافيل أني باس

يسمح لك بتسجيل الدخول باستخدام أي كلمة مرور في البيئة المحلية فقط.

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

مجهر لارافيل

يقوم تلقائيًا بفحص تطبيق laravel الخاص بك ( جديد )

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


Great spirits have always encountered violent opposition from mediocre minds.

"Albert Einstein"
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل