Laravel 12.22 - přidává except() Metoda nástroje Eloquent Builder pro vyloučení modelů z dotazů
Laravel 12.22 zavádí novou a expresivní metodu nazvanou except() v nástroji pro sestavování dotazů Eloquent. Tato metoda usnadňuje vyloučení konkrétních instancí modelů nebo kolekcí modelů z výsledků dotazů - pomáhá vám psát čistší a čitelnější kód.
Co dělá except() Dělat?
Na stránkách except() metoda umožňuje vyloučit jednu nebo více instancí modelu nebo kolekcí modelů. z dotazu. Interně využívá stávající whereKeyNot() extrakcí primárních klíčů ze zadaných modelů.
To znamená, že namísto ruční extrakce ID a volání whereKeyNot(), můžete nyní přímo předávat modely nebo kolekce do funkce except() pro vyloučení.
Proč neupravit whereKeyNot()?
whereKeyNot() byl původně navržen tak, aby vylučoval záznamy pouze podle jejich klíče nebo ID. Jeho úprava pro přímou práci s modely nebo kolekcemi by zkomplikovala jeho účel a mohla by přinést neočekávané vedlejší účinky pro stávající uživatele.
Nový except() metoda udržuje obavy v čistotě:
whereKeyNot()se nadále zaměřuje na klíče/ID.except()poskytuje uživatelsky přívětivý a expresivní způsob vyloučení modelů.
Jak používat except()
Před verzí Laravel 12.22
Chcete-li vyloučit videa s ID 2 a 4, musíte:
$videos = \App\Models\Video::query() ->whereIn('id', [2, 4]) ->get(); $otherVideosUsingWhereKeyNot = \App\Models\Video::query() ->whereKeyNot($videos->pluck('id')) ->get();Zde ručně vyberete ID z kolekce a vyloučíte je.
Po vydání Laravel 12.22
Výše uvedené můžete zjednodušit předáním modelů přímo do příkazu except():
$videos = \App\Models\Video::query() ->whereIn('id', [2, 4]) ->get(); $otherVideosUsingExcept = \App\Models\Video::query() ->except($videos) ->get();Díky tomu budou vaše záměry jasnější a kód čistší.
Souhrn
Nový except() metoda v Laravelu 12.22 je malým doplňkem systému Eloquent, který zlepšuje čitelnost a vyjadřovací schopnosti při vylučování modelů z dotazů.
- Předejte jednu nebo více instancí modelu nebo kolekcí, abyste je vyloučili.
- Interně používá
whereKeyNot()pro efektivní filtrování dotazů. - Udržuje
whereKeyNot()soustředěný a nezměněný. - Nyní je k dispozici ve verzi Laravel 12.22 a novější.
- Tato metoda byla přidána v žádosti o stažení #56442