Neznáme parametre a chyby

Požiadavka na filter alebo triedenie mimo allow-listu vyhodí UnknownFilter alebo UnknownSort. Obe dedia zo Symfony HttpException so stavom 400, takže ich Laravel vykreslí ako bežnú HTTP chybu:

GET /posts?filter[secret]=1

HTTP/1.1 400 Bad Request
{"message": "Requested filter(s) `secret` are not allowed. Allowed filter(s) are `status, title`."}

Režim ignore

Nastavte mode.unknown_filter alebo mode.unknown_sort na ignore a problematický kľúč sa potichu zahodí — použijú sa len povolené. Reťazec triedenia, ktorý sa zahodí celý, sa správa, akoby chýbal, takže stránku stále zoradí defaultSort(). Iná hodnota ako reject či ignore vyhodí InvalidConfigurationException namiesto hádania:

// config/query-builder.php
'mode' => [
    'unknown_filter' => 'ignore',   // drop un-allow-listed filters
    'unknown_sort'   => 'reject',   // keep sorts strict (HTTP 400)
],

Hlášky a preklady

Hlášky pochádzajú z query-builder::errors.unknown_filter a query-builder::errors.unknown_sort so zástupnými symbolmi :unknown a :allowed. Odrazené neznáme kľúče sú obmedzené — prvých 5, každý skrátený na 64 znakov, s dovetkom „…and N more“ — takže kľúče od útočníka nezaplavia odpoveď ani logy. Publikujte preklady, ak chcete zmeniť znenie alebo pridať jazyk:

// lang/vendor/query-builder/sk/errors.php
return [
    'unknown_filter' => 'Filtre :unknown nie sú povolené. Povolené filtre: :allowed.',
    'unknown_sort' => 'Triedenia :unknown nie sú povolené. Povolené triedenia: :allowed.',
];

Prehľad výnimiek

use RoundlyConsulting\QueryBuilder\Exceptions\QueryBuilderException;

try {
    $posts = QueryBuilder::for(Post::class, $request)
        ->allowedFilters('status')
        ->get();                        // filters apply here — lazily
} catch (QueryBuilderException $e) {
    // UnknownFilter / UnknownSort — both carry HTTP status 400
}