---
title: "Query Builder for Laravel — dokumentácia | Roundly"
description: "Dokumentácia Query Builder for Laravel: filtre a triedenie cez allow-list, operátory volené klientom, nullable a relačné filtre, obmedzené stránkovanie."
url: https://roundly-consulting.com/sk/open-source/navody/query-builder-for-laravel
language: sk
---

[Všetky balíky](https://roundly-consulting.com/sk/open-source.md)

Open source

# Query Builder for Laravel

Inštalácia

`composer require roundly-consulting/query-builder-for-laravel`

Vyžaduje: PHP ^8.4 · Laravel ^12.0|^13.0

[GitHub](https://github.com/roundly-consulting/query-builder-for-laravel) [Packagist](https://packagist.org/packages/roundly-consulting/query-builder-for-laravel) [Prispieť (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Patreon](https://www.patreon.com/cw/roundly)

## Prehľad

Natívny query builder pre zoznamové API endpointy v Laraveli. Deklarujete, ktoré filtre a triedenia endpoint povoľuje, a balík z query stringu — filter\[…\], sort, page, per\_page — použije len tie a všetko ostatné odmietne s HTTP 400. Výsledkom je stále Eloquent builder, takže ďalej reťazíte with(), get() či paginate(). Licencia MIT, bez runtime závislostí okrem Laravelu, Symfony a dvoch malých sprievodných balíkov Roundly.

### Čo získate

#### Predvolene cez allow-list

Spustia sa len deklarované filtre a triedenia; všetko ostatné vráti HTTP 400 alebo sa v režime ignore potichu zahodí.

#### Bohatá sada filtrov

Presná zhoda, boolean, čiastočná zhoda, prefix/sufix, vyhľadávanie vo viacerých stĺpcoch, porovnanie, scope, callback, trashed, členstvo v JSON poli aj vlastné filtre.

#### Operátory volené klientom

not:, contains: či gte: z množiny, ktorú deklarujete; nedeklarovaný token ostáva doslovnou hodnotou.

#### Nullable a relačné filtre

Sentinel none, not:none, negácie cez whereDoesntHave a tvary hodnôt, ktoré bránia chybám 500 na PostgreSQL.

#### Validované stránkovanie

HasPageSize validuje per\_page (422) a pevne ho obmedzí; nakonfigurovaný názov stránky sa použije automaticky.

#### Bezpečné už návrhom

Viazané hodnoty, escapované zástupné znaky v LIKE, limity requestu a chybové hlášky s obmedzenou dĺžkou.

### Dokumentácia

#### [Inštalácia](https://roundly-consulting.com/sk/open-source/navody/query-builder-for-laravel/instalacia.md)

Inštalácia cez Composer, voliteľné publikovanie konfigurácie a prekladov a kontrola aktívneho wire kontraktu cez artisan about.

#### [Konfigurácia](https://roundly-consulting.com/sk/open-source/navody/query-builder-for-laravel/konfiguracia.md)

Každý konfiguračný kľúč a jeho predvolená hodnota — názvy parametrov, limity veľkosti stránky, režimy neznámych parametrov a limity requestu.

#### [Zostavenie dopytu](https://roundly-consulting.com/sk/open-source/navody/query-builder-for-laravel/zostavenie-dopytu.md)

Obaľte model alebo pripravený builder cez QueryBuilder::for(), deklarujte allow-list a pokračujte ako s bežným Eloquent builderom.

#### [Filtre](https://roundly-consulting.com/sk/open-source/navody/query-builder-for-laravel/filtre.md)

Všetky vstavané konštruktory filtrov — presná zhoda, boolean, čiastočná zhoda, prefix/sufix, scope, callback, trashed a vlastné — plus normalizácia.

#### [Vyhľadávanie vo viacerých stĺpcoch](https://roundly-consulting.com/sk/open-source/navody/query-builder-for-laravel/vyhladavanie.md)

Jedno vyhľadávacie pole naprieč stĺpcami cez search() — doslovná fráza, jedno zoskupené OR, bezpečné voči NULL a šetrné k trigramovým indexom PostgreSQL.

#### [Operátorové filtre](https://roundly-consulting.com/sk/open-source/navody/query-builder-for-laravel/operatorove-filtre.md)

Pevné porovnania na serveri cez operator() a operátory volené klientom, napríklad not:, contains: či gte:, cez operators().

#### [Nullable, relačné a JSON filtre](https://roundly-consulting.com/sk/open-source/navody/query-builder-for-laravel/nullable-a-relacne-filtre.md)

Filtrujte nullable stĺpce so sentinelom none, to-many relácie s negáciou cez whereDoesntHave a JSON polia podľa členstva.

#### [Tvary hodnôt](https://roundly-consulting.com/sk/open-source/navody/query-builder-for-laravel/tvary-hodnot.md)

Deklarujte FilterValueShape na typovaných stĺpcoch, aby chybné uuid či id vrátilo prázdny výsledok namiesto chyby 500 na PostgreSQL.

#### [Validácia hodnôt filtrov](https://roundly-consulting.com/sk/open-source/navody/query-builder-for-laravel/validacia.md)

Obaľte validačné pravidlá do FilterValue, aby sa prefix operátora a sentinely odstránili ešte pred spustením pravidiel.

#### [Triedenie](https://roundly-consulting.com/sk/open-source/navody/query-builder-for-laravel/triedenie.md)

Povoľte polia na triedenie, mapujte verejné názvy na stĺpce, trieďte podľa viacerých stĺpcov a nastavte predvolené poradie.

#### [Stránkovanie](https://roundly-consulting.com/sk/open-source/navody/query-builder-for-laravel/strankovanie.md)

Validujte a pevne obmedzte per\_page traitom HasPageSize pre FormRequest; nakonfigurovaný názov stránky sa použije automaticky.

#### [Formát požiadavky](https://roundly-consulting.com/sk/open-source/navody/query-builder-for-laravel/format-poziadavky.md)

Zmrazená syntax query stringu pre filtre, operátory, triedenie a stránkovanie a stavový kód, ktorý vráti každá chyba.

#### [Neznáme parametre a chyby](https://roundly-consulting.com/sk/open-source/navody/query-builder-for-laravel/nezname-parametre.md)

Nepovolené filtre a triedenia vrátia HTTP 400 s preložiteľnou hláškou s obmedzenou dĺžkou — alebo sa v režime ignore zahodia.

#### [Vlastné filtre a triedenia](https://roundly-consulting.com/sk/open-source/navody/query-builder-for-laravel/vlastne-filtre-a-triedenia.md)

Implementujte kontrakt Filter alebo Sort pre vlastnú logiku a v callbackoch parsujte formát operátorov cez RequestedOperator::split().

#### [Bezpečnostný model](https://roundly-consulting.com/sk/open-source/navody/query-builder-for-laravel/bezpecnost.md)

Ako balík drží vstup z requestu mimo SQL: allow-listy, viazané hodnoty, escapované zástupné znaky, limity requestu a obmedzený výstup chýb.

#### [Testovanie](https://roundly-consulting.com/sk/open-source/navody/query-builder-for-laravel/testovanie.md)

Builder v unit testoch riaďte cez Request::create() a na endpointoch overujte odpovede 400 a 422.

#### [Požiadavky](https://roundly-consulting.com/sk/open-source/navody/query-builder-for-laravel/poziadavky.md)

PHP 8.4+, Laravel 12 alebo 13 a dva sprievodné balíky, ktoré sa nainštalujú automaticky — bez migrácií a ďalších PHP rozšírení.

## Prejavte lásku k open source

Tento balík je zadarmo pod licenciou MIT. Ak vám šetrí čas, jednorazový príspevok alebo členstvo na Patreone nám pomôže ho ďalej udržiavať, testovať a dokumentovať.

[Ďalšie spôsoby podpory vrátane kryptomien](https://roundly-consulting.com/sk/podporte-nas.md)

Odoslaním daru súhlasíte s našimi [podmienkami prijímania darov](https://roundly-consulting.com/sk/podmienky-darov.md).

[Podporte našu open-source prácu (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Pridajte sa k nám na Patreone (otvorí sa v novej karte)](https://www.patreon.com/cw/roundly)

## Chcete to zabudovať do svojho produktu?

Naše balíky integrujeme do zákazkových Laravel a AI riešení. Napíšte nám, na čom pracujete, a ozveme sa do 48 hodín.

[Ponuka do 48 hodín](https://roundly-consulting.com/sk/kontakt.md) [Prezrieť všetky balíky](https://roundly-consulting.com/sk/open-source.md)