پکیج Sanctum
لاراول در ورژن نو خویش پکیجی به اسم Sanctum را منتشر کرد. انگیزه این پکیج به کارگیری طراحی سایت فروشگاهی از راهی مطلوب برای احراز نامونشان در قابل انعطاف افزارهایی، به اسم SPA یا این که Single Page Application، میباشد. که از روش کادر ورکهای جاوا اسکریپت توسعه و گسترش داده می گردند.برای احراز نامونشان با API در لاراول، عمل Sanctum در اینجا به انتها نمیرسد، و این پکیج را در کلیه نرم افزارها و سیستمهای Token Base میقدرت به کار گرفت.
این پکیج همینطور قابلیت و امکان ساختن چندین Token را برای هر استفاده کننده در نرم افزار شما دارااست، که حتی می توانید برای هر توکن یک سری قابلیت و امکان (Ability) قرار دهید، و از هر توکن به خواسته دسترسی به نصیب خاصی از سیستم خویش استعمال نمائید. به گویش بی آلایشخیس به هر توکن میتوانید دسترسیهایی در سیستم خویش دهید، که درپی اضافه راجعبه آن کلام خوا هیم کرد.
نصب پکیج Sanctum
برای نصب پکیج Sanctum از روش خط امر فرمان تحت را در پروژه خویش اجرا فرمایید.
composer require laravel/sanctum
بعداز نصب پکیج با وارد کردن فرمان ذیل پوشههای پکیج را به پروژه خویش منتقل نمائید.
php artisan vendor:publish --provider="LaravelSanctumSanctumServiceProvider"
با اجرای امر بالا پوشههای پکیج از گزاره، فولدر sanctum.php در مسیر config، که پیکربندی کلی پکیج پروژهی شما در آن جای دارد و همینطور فولدرهای Migration مرتبط با جداول، در پروژه شما قرار داده می شود.
پس از اجرای امر بالا نیاز میباشد، در اولی مرحله جداول مرتبط با Sanctum را به دیتابیس خویش بیشتر کنیم. فرمان تحت را در خط دستور پروژه خویش اجرا فرمائید.
php artisan migrate
جدولی که از روش کد بالا ساخته میشود، در فولدر migration مرتبط با sanctum در مسیر database/migrations و با اسم personal_access_tokens قراردارد.
درحالتی که که میخواهید، پوشههای مرتبط با دیتابیس اجرا نشود، در فولدر AppServiceProvider.php متد Sanctum::ignoreMigrations را در متد register صدا بزنید.
پیکربندی Sanctum
در فولدر config/sanctum.php پیکربندی کلی مرتبط با پکیج Sanctum موجود هست، که در ذیل به شما توضیح خواهیم اعطا کرد.
stateful: اینجا میتوانید دامنههایی که اذن درخواست به سرور را دارا هستند، تمجید نمائید.
expiration: مرتبط با انقضای توکن میباشد، که بر حسب دقیقه به حساب آوردن میگردد، و هنگامی که null قرار بگیرد، توکن منقضی نخواهد شد.
middleware: وقتی که از احراز نام و نشان در اپلیکیشن SPA استعمال میکنید، می بایست csrf-token هایی که از روش پکیج Sanctum به اپلیکیشن داده میگردد، اعتبار سنجی شوند. میتوانید Middlewareهای مرتبط با این عمل را اینجا قرار دهید.
استعمال از پکیج Sanctum در پروژه
می خواهیم در پروژهی خودمان از روش پکیج Sanctum یک API بنویسیم، که استفاده کننده را از روش توکن احراز نامونشان مینماید، و پس از ورود استفاده کننده یک توکن به آن می دهد، و در درخواستهای بعدی با قرار دادن آن توکن در Header درخواست به سرور می گوییم، که درخواست از روش کدام استفاده کننده به سرور ارسال شدهاست.
در اولین مرحله یک پروژه تازه لاراول با فرمان تحت بسازید.
- دوشنبه ۳۰ تیر ۹۹ ۱۵:۰۷ ۱۲۷ بازديد
- ۰ نظر