Local scope bilan qayta ishlatiladigan filtr

~20 daq · Laravel · Katalogni qidirish va queryni boshqarish

Muammodan boshlaylik

Bir xil nom qidiruvi katalog va kelajakdagi API actionida takrorlanadi.

Tushunib olamiz

Local scope model querysining ma’noli bir qismini nomlaydi. Scope queryni o‘zgartiradi, natijani darhol get bilan yuklamaydi; shunda boshqa filtrlar va pagination ulanadi. Laravelda scope uchun yangi atributli usullar ham bor, bu dars tanish scopeName konvensiyasi bilan davom etadi. Request validation controller chegarasida qoladi; model HTTP requestni bilmasin.

Ishlaydigan misol

Oldingi darsdagi kitoblar Laravel 13.x loyihasida ishlang. Misoldagi fayl yo‘li izoh yoki matnda ko‘rsatiladi; kodni alohida PHP script sifatida ishga tushirmang. Laravel serveri php artisan serve bilan 127.0.0.1:8000’da ishlasin. Har dars oldingi loyiha holatiga tayanadi.

// AppModelsKitob klassiga metod qo‘shing:
public function scopeNomIzlash(\Illuminate\Database\Eloquent\Builder $query, ?string $q)
{
    if ($q !== null && $q !== '') {
        $query->where('nom', 'like', '%' . $q . '%');
    }
    return $query;
}

// Controllerda eski nom where blokini almashtiring:
$query = \App\Models\Kitob::query()->nomIzlash($filters['q'] ?? null);

Natija va izoh

Narx va sort kodlari o‘z holida qoladi. Nom qidiruvi oldingidek ishlasin. Bitta qoidani scopega ko‘chirish tashqi xatti-harakatni o‘zgartirmasligi kerak.

[!WARNING] Model scope ichida request() yoki view() chaqirmang. Natijani all/get bilan erta yuklash paginationni buzadi va xotira sarfini oshiradi.

Mustaqil mashq

Qidiruv scope uchun mos va mos bo‘lmagan ikkita factory yozuvi bilan test yozing.

Avval yechimni ochmasdan o‘zingiz yozing. Natijani oldindan taxmin qiling, so‘ng haqiqiy natija bilan solishtiring. Oddiy kirishdan tashqari bo‘sh qiymat, nol yoki mavjud bo‘lmagan element kabi chegara holatlarini ham tekshiring.

Yechim va tekshirish yo‘li

Nomlarni aniq override qiling; nomIzlash('PHP')->pluck('nom') faqat mos nomni bersin. Bo‘sh q holatida ikkala yozuv qaytsin.

Xulosa

Local scope model querysining ma’noli bir qismini nomlaydi.

Misolni ko‘chirib ishlatish bilan cheklanmang: qiymatlarni almashtiring, bitta qoidani o‘zgartiring va qaysi holatda xato chiqishini kuzating. Yangi bilimni kursdagi kichik loyihangizga alohida qadam sifatida qo‘shing.

Keyingi dars: Muallif jadvali va mavjud kitoblarga yangi bog‘lanish.

Rasmiy manba: Laravel 13.x rasmiy qo‘llanmasi