Výnimky

Každá výnimka, ktorou balík odmietne volanie, dedí od TagsException (RuntimeException). Zobrazujte ich cez štyri stabilné metódy namiesto znalosti jednotlivých tried: errorCode() — kód v snake_case, verejné API od verzie 1.0; status() — stav HTTP pre odkaz v tele požiadavky; isNotFound() — skupina „neexistuje“, ktorá odpovie 404, ak bol odkaz segmentom cesty; clientMessage() — preložený text, ktorý smie vidieť klient. Hlásenia pochádzajú z tags::messages v angličtine a slovenčine a nikdy neuvádzajú názov PHP triedy:

use RoundlyConsulting\Tags\Exceptions\TagsException;

try {
    $concert->attachTags($request->input('labels', []), 'label');
} catch (TagsException $e) {
    return response()->json(
        ['message' => $e->clientMessage(), 'code' => $e->errorCode()],
        $e->status(),
    );
}

Výnimka	errorCode()	status()	Kedy
`UnknownTagTypeException`	`unknown_tag_type / type_required`	404 / 422	Typ, ktorý nikto nedefinoval (alebo je pred volajúcim skrytý); reťazec bez typu, keď predvolený typ neexistuje.
`TagNotFoundException`	`tag_not_found`	422 (404 in the path)	Kľúč, slug či názov bez živého štítku, ktorý volajúci smie použiť; zmazaný štítok.
`TagScopeMismatchException`	`tag_not_found`	422 (404 in the path)	Štítok iného rozsahu — navonok presne ako chýbajúci; getMessage() si presný text ponechá pre logy.
`DuplicateTagException`	`duplicate_tag`	409	Názov či ručný slug, ktorého slug drží iný štítok typu a rozsahu — uvedie slug a jazyk a pri zmazanom štítku odkáže na restore().
`InvalidTagException`	`invalid_tag`	422	Prázdny, pridlhý či na slug nevhodný názov, nepodporovaný či chybný jazyk, zlá farba, ikona, popis, slug či pozícia, ručný slug na voľnom type, rozsah pri type len globálnom, zmena typu či vlastníka.
`InvalidTagHierarchyException`	`invalid_hierarchy`	422	Cyklus, strom hlbší, než typ dovoľuje, rodič na plochom type, zmazaný rodič.
`TagHasChildrenException`	`tag_has_children`	409	Zmazanie, ktoré by osirelo živé deti — odovzdajte TagChildren::Reparent alebo Delete.
`TagLimitExceededException`	`tag_limit_exceeded`	422	Zápis, po ktorom by mal model viac štítkov typu, než je povolené; nezapíše sa nič.
`TagTypeMismatchException`	`tag_type_mismatch`	422	Štítok jedného typu použitý tam, kde sa čakal iný — volanie so štítkami, rodič, handle.
`TagTypeNotAllowedException`	`tag_type_not_allowed`	422	Zoznam on() typu alebo tagTypes() modelu toho druhého nepripúšťa.
`UnknownMorphAliasException`	`unknown_alias`	422	Odkaz na rozsah či model v API, ktorý povolené zoznamy nepoznajú — alebo rozsah, ktorý volajúci nesmie použiť, s rovnakou odpoveďou.
`InvalidTagTypeException`	`invalid_tag_type`	500	Definícia typu, ktorá nemôže fungovať (pozrite Typy štítkov).
`TagTypeAlreadyDefinedException`	`type_already_defined`	500	Druhá definícia jedného názvu s oboma miestami definície.
`UnsavedTaggableException`	`unsaved_taggable`	500	Označovanie modelu, ktorý ešte nie je uložený.

Chýbajúci kľúč sa klientovi zobrazí presne ako štítok iného rozsahu: clientMessage() je všeobecné „The tag does not exist.“, kým getMessage() si kľúč ponechá pre vaše logy.
Mimo tejto skupiny: InvalidTagsConfigurationException (konfigurácia, s ktorou balík nevie pracovať, s názvom kľúča — dedí od výnimky toolkitu, preto ju zachytávajte spolu s InvalidConfigurationException) a ReadOnlyTagsRelationException (LogicException pri zápise cez tags()).

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

Odoslaním daru súhlasíte s našimi podmienkami prijímania darov.

Podporte našu open-source prácu Pridajte sa k nám na Patreone

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 Prezrieť všetky balíky