لاراول 13.40: میدلور رو دقیقاً کنار میدلورهای پیشفرض بذار
خلاصهٔ کاملتر
تو این مقاله از Laravel News اومده که بعضی میدلورها باید دقیقاً یه جای مشخص از صف پیشفرض لاراول اجرا بشن. مثلاً میدلوری که IP کاربر رو میخونه باید بعد از TrustProxies باشه (یعنی میدلوری که به لاراول میگه IP واقعی رو از هدرهای لود بالانسر بخونه). میدلوری که سشن رو میخونه باید بعد از StartSession بیاد. تا حالا تو bootstrap/app.php فقط میشد میدلور رو اول یا آخر صف یا گروه گذاشت.
لاراول 13.40 چهار متد جدید آورده. insertBefore() و insertAfter() روی صف سراسری کار میکنن و insertBeforeInGroup() و insertAfterInGroup() داخل یه گروه، که اسم گروه رو اول میگیرن. اینها روی هر گروهی کار میکنن، حتی گروههایی که خودت با $middleware->group() ساختی:
->withMiddleware(function (Middleware $middleware) {
$middleware->insertAfter(TrustProxies::class, BlockBannedIps::class);
$middleware->insertAfterInGroup('web', StartSession::class, SetLocaleFromSession::class);
})نویسنده یه مثال واقعی میزنه: اپی که زبان کاربر رو تو سشن نگه میداره و slug آدرسها رو ترجمه میکنه. مدل Article تو resolveRouteBinding() بر اساس locale فعلی دنبال slug میگرده، پس locale باید بعد از شروع سشن و قبل از SubstituteBindings (یعنی جایی که مدل از روی پارامتر route پیدا میشه) تنظیم بشه. با web(append: ...) میدلور بعد از SubstituteBindings اجرا میشد و slug فرانسوی 404 میداد. با prepend هم قبل از سشن اجرا میشد و خطای Session store not set on request. میگرفتی.
راهحل قبلی این بود که کل گروه web رو دستی بازنویسی کنی، ولی اون کپی با تغییرات فریمورک جلو نمیره. مثلاً لاراول 12 تو این گروه ValidateCsrfToken داشت و لاراول 13 PreventRequestForgery داره، پس اپی که لیست نسخهٔ 12 رو کپی کرده بود بعد از آپگرید کلاس قدیمی رو نگه میداشت. لیست کپیشده auth.session رو هم جا میانداخت. با 13.40 فقط اسم میدلوری که اضافه میکنی رو مینویسی.
تغییر کوچیکتری هم کنارش اومده: replace() و replaceInGroup() حالا آرایه قبول میکنن و اون آرایه جای میدلور اصلی تو صف میشینه. یعنی میتونی یه میدلور رو با دوتا عوض کنی، یا خود میدلور اصلی رو هم تو آرایه بذاری تا یکی کنارش اضافه بشه. هلپرهای web() و api() هم چون آرگومان replace رو به replaceInGroup() میدن، آرایه رو قبول میکنن. این تغییرات رو Jamie York تو PRهای 62230 و 62261 اضافه کرده.
نکات کلیدی:
- متدهای insertBefore و insertAfter برای صف سراسری میدلور در لاراول 13.40
- متدهای insertBeforeInGroup و insertAfterInGroup برای هر گروه، با اسم گروه بهعنوان آرگومان اول
- replace و replaceInGroup حالا آرایه میگیرن و هلپرهای web و api هم پشتیبانی میکنن
- بازنویسی دستی گروه web با آپگرید خراب میشه، مثلاً جایگزینی ValidateCsrfToken با PreventRequestForgery در لاراول 13
- میدلور چک IP باید بعد از TrustProxies باشه، وگرنه IP لود بالانسر رو میبینه




