skop pertanyaan laravel

Skop pertanyaan dalam Laravel ialah ciri yang sangat penting, yang membolehkan anda menentukan beberapa kaedah pertanyaan yang biasa digunakan dalam model untuk digunakan semula sepanjang keseluruhan aplikasi. Skop pertanyaan ini boleh menjadi global (digunakan pada keseluruhan model) atau setempat (hanya digunakan pada kaedah model).

Dalam artikel ini, kami akan memperkenalkan definisi, penggunaan dan beberapa perkara yang perlu diberi perhatian kepada skop pertanyaan dalam Laravel.

1. Takrif skop pertanyaan

Skop pertanyaan ialah fungsi tanpa nama yang menerima parameter $query, yang merupakan contoh pembina pertanyaan Eloquent. Dalam fungsi tanpa nama ini, anda boleh melakukan beberapa operasi pertanyaan pada contoh, seperti menambah klausa tempat, susunan mengikut klausa, dsb.

Berikut ialah contoh definisi skop pertanyaan asas:

public function scopePublished($query)
{
    return $query->where('status', '=', 'published');
}

Dalam contoh di atas, kami mentakrifkan skop pertanyaan yang dinamakan diterbitkan, yang secara automatik akan menambah skop pertanyaan apabila bertanya di mana klausa untuk menapis diterbitkan model.

2. Menggunakan skop pertanyaan

Menggunakan skop pertanyaan adalah sangat mudah, cuma panggil kaedah model yang sepadan. Contohnya, jika kami menggunakan skop pertanyaan yang diterbitkan dalam contoh di atas, kami hanya perlu memanggil kod berikut:

$posts = Post::published()->get();

Kod di atas akan mengembalikan koleksi semua kejadian Post yang telah diterbitkan.

Jika anda perlu menghantar parameter ke dalam skop pertanyaan, cuma tambah parameter dalam kaedah ini. Contohnya:

public function scopeCategory($query, $categoryId)
{
    return $query->where('category_id', '=', $categoryId);
}

Skop pertanyaan ini boleh digunakan untuk menapis catatan blog untuk kategori tertentu.

$posts = Post::category(1)->get();

Kod di atas akan mengembalikan semua catatan blog dengan ID kategori 1.

Nota: Skop pertanyaan boleh dirantai, jadi anda boleh menggunakan berbilang skop pertanyaan pada masa yang sama untuk mendapatkan hasil yang lebih tepat.

3. Takrifan global skop pertanyaan

Jika anda mahu menggunakan skop pertanyaan yang sama merentas keseluruhan model, anda boleh menentukan skop pertanyaan global. Untuk melakukan ini, hanya panggil kaedah but dalam model anda dan tentukan skop pertanyaan global menggunakan kaedah statik::addGlobalScope.

Berikut ialah contoh skop pertanyaan global asas:

protected static function boot()
{
    parent::boot();

    static::addGlobalScope('active', function (Builder $builder) {
        $builder->where('active', '=', 1);
    });
}

Dalam contoh di atas, kami mentakrifkan skop pertanyaan global bernama aktif dan mengehadkannya kepada medan aktif bersamaan dengan 1 rekod.

Kini, apabila anda menanyakan model dalam mana-mana kaedah, skop pertanyaan akan berkuat kuasa secara automatik.

4. Mengalih keluar skop pertanyaan

Kadangkala kita mungkin perlu mengalih keluar skop pertanyaan model tertentu. Laravel menyediakan kaedah removeGlobalScope untuk membantu kami mencapai matlamat ini.

Sebagai contoh, dengan mengandaikan kami mempunyai skop pertanyaan global bernama aktif, kami boleh mengalih keluarnya menggunakan kaedah berikut:

$users = User::withoutGlobalScope('active')->get();

Kod di atas akan mengembalikan semua pertanyaan yang tidak dihadkan oleh skop aktif pengguna.

Nota: Jika anda ingin mengalih keluar semua skop pertanyaan global, anda boleh menggunakan kaedah withoutGlobalScopes.

$users = User::withoutGlobalScopes()->get();

Kod di atas akan mengembalikan semua pengguna yang tidak dihadkan oleh sebarang skop pertanyaan global.

Ringkasan

Skop pertanyaan ialah ciri yang sangat berkuasa dalam Laravel. Dengan menggunakan skop pertanyaan, anda boleh menggunakan semula operasi pertanyaan biasa dengan mudah sepanjang aplikasi anda dan menyusun kod anda dengan lebih jelas. Mempelajari penggunaan skop pertanyaan yang betul bukan sahaja boleh meningkatkan produktiviti anda, tetapi juga membantu anda membina aplikasi yang lebih mantap.

Atas ialah kandungan terperinci skop pertanyaan laravel. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!