--- title: "Enums for Laravel — dokumentácia | Roundly" description: "Dokumentácia Enums for Laravel: preložené popisy, možnosti pre select, farby štítkov, vyhľadanie prípadov, validačné pravidlá a porovnania pre PHP enumy." url: https://roundly-consulting.com/sk/open-source/navody/enums-for-laravel language: sk --- [Všetky balíky](https://roundly-consulting.com/sk/open-source.md) Open source # Enums for Laravel Inštalácia `composer require roundly-consulting/enums-for-laravel` Vyžaduje: PHP ^8.4 · Laravel ^12.0|^13.0 [GitHub](https://github.com/roundly-consulting/enums-for-laravel) [Packagist](https://packagist.org/packages/roundly-consulting/enums-for-laravel) [Prispieť (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Patreon](https://www.patreon.com/cw/roundly) ## Prehľad Jeden trait, ktorý vašim PHP enumom pridá pomocné metódy, aké si inak v každej Laravel aplikácii píšete znova: čitateľné a preložiteľné popisy — odvodené z hodnoty alebo načítané z vašich prekladových súborov; názvy, hodnoty a popisy ako kolekcie; možnosti pre select a podklady pre stavové štítky s farbou každého prípadu; vyhľadanie prípadu podľa názvu či popisu; validačné pravidlo, ktoré sa nikdy nerozíde s kódom; náhodný výber; prehľadné porovnania a plynulé podmienené callbacky. Pridajte RoundlyConsulting\\Enums\\Helpers do backed alebo čistého enumu a máte hotovo — bez service providera, konfigurácie, migrácií či príkazov. Natívne pre Laravel — postavené na jeho vlastných Collection, Str a prekladači — s licenciou MIT a bez závislostí nad rámec samotného Laravelu. ### Čo získate #### Čitateľné a preložiteľné popisy readable() a label() prevedú hodnotu prípadu cez Str::headline() — z hot-news vznikne „Hot News“ — alebo s #\[TranslatedLabels\] načítajú každý popis z vášho lang//enums.php. #### Názvy, hodnoty a popisy Jedným volaním získate názvy, hodnoty alebo popisy všetkých prípadov ako Laravel kolekcie v poradí deklarácie. #### Možnosti pre select Mapa hodnota => popis pre selecty v Blade alebo typované DTO EnumOption (value, label, name) pre Inertia, Vue a React. #### Farby pre stavové štítky Implementujte HasColor a presentations() vráti hodnotu, preložený popis a farbu každého prípadu — pripravené pre stavový štítok v akomkoľvek frontende. #### Vyhľadanie prípadu Nájdite prípad podľa názvu alebo popisu — striktné varianty from\* vyhodia výnimku, tryFrom\* vrátia null — plus hasName() a hasValue(). #### Validácia vždy v súlade s kódom validationRule() zostaví pravidlo in: z aktuálnych prípadov, takže nový prípad nikdy nerozbije formulár. #### Porovnania a callbacky is(), isNot(), isIn(), isNotIn() a plynulé callbacky whenIs\* s voliteľnou predvolenou vetvou. #### Jeden trait, žiadne nastavovanie Bez service providera, konfigurácie, migrácií, príkazov či fasády. Funguje na backed aj čistých enumoch — čisté enumy všade namiesto hodnoty použijú názov prípadu. ### Dokumentácia #### [Inštalácia](https://roundly-consulting.com/sk/open-source/navody/enums-for-laravel/instalacia.md) Inštalácia cez Composer — nie je čo publikovať ani registrovať: žiadny service provider, konfigurácia, migrácia ani príkaz. #### [Rýchly štart](https://roundly-consulting.com/sk/open-source/navody/enums-for-laravel/rychly-start.md) Pridajte do enumu trait Helpers a jedným riadkom získate popisy, možnosti pre select, vyhľadávanie, validáciu aj porovnania. #### [Backed a čisté enumy](https://roundly-consulting.com/sk/open-source/navody/enums-for-laravel/typy-enumov.md) Čo jednotlivé metódy vracajú pre reťazcové, celočíselné a čisté enumy — a kde čisté enumy namiesto hodnoty použijú názov prípadu. #### [Čitateľné popisy](https://roundly-consulting.com/sk/open-source/navody/enums-for-laravel/popisy.md) readable() a label() prevedú prípad na čitateľný popis cez Str::headline() a prekladač Laravelu. #### [Preklad popisov](https://roundly-consulting.com/sk/open-source/navody/enums-for-laravel/preklad-popisov.md) Lokalizujte popisy cez JSON prekladové súbory či skupinu #\[TranslatedLabels\], alebo prepíšte readable() na enume a majte ich plne pod kontrolou. #### [Popisy z prekladových súborov](https://roundly-consulting.com/sk/open-source/navody/enums-for-laravel/popisy-z-prekladovych-suborov.md) #\[TranslatedLabels\] načíta každý popis z prekladovej skupiny, napr. lang//enums.php, so záložným Str::headline() a zoznamom chýbajúcich riadkov. #### [Názvy, hodnoty a popisy](https://roundly-consulting.com/sk/open-source/navody/enums-for-laravel/nazvy-hodnoty-popisy.md) names(), values(), storable(), labels(), collect() a count() — všetky prípady ako kolekcia v poradí deklarácie. #### [Možnosti pre select](https://roundly-consulting.com/sk/open-source/navody/enums-for-laravel/moznosti-pre-select.md) toOptions() a toArray() zostavia mapu hodnota => popis pre selecty v Blade, formulárové komponenty, JSON aj odpovede API. #### [Možnosti pre frontend](https://roundly-consulting.com/sk/open-source/navody/enums-for-laravel/moznosti-pre-frontend.md) options() vracia typované DTO EnumOption — hodnotu, popis a názov — v tvare, aký očakávajú selecty v JavaScripte, Inertia, Vue a Reacte. #### [Farby štítkov a prezentácia](https://roundly-consulting.com/sk/open-source/navody/enums-for-laravel/farby-a-prezentacia.md) Priraďte prípadom farbu cez HasColor; presentation() a presentations() vrátia DTO {value, label, color} pre badge a stavové štítky. #### [Vyhľadanie prípadu](https://roundly-consulting.com/sk/open-source/navody/enums-for-laravel/vyhladanie-pripadu.md) Nájdite prípad podľa názvu alebo popisu cez fromName(), fromLabel() a ich varianty tryFrom\*; existenciu overíte cez hasName() a hasValue(). #### [Validácia](https://roundly-consulting.com/sk/open-source/navody/enums-for-laravel/validacia.md) validationRule() zostaví pravidlo in: z values(), takže zoznam povolených hodnôt sa pri zmene prípadov nikdy nerozíde s kódom. #### [Porovnávanie](https://roundly-consulting.com/sk/open-source/navody/enums-for-laravel/porovnavanie.md) is(), isNot(), isIn() a isNotIn() porovnávajú prípady podľa identity — čitateľné podmienky bez ručne písaných reťazí ===. #### [Podmienené callbacky](https://roundly-consulting.com/sk/open-source/navody/enums-for-laravel/podmienene-callbacky.md) whenIs(), whenIsNot(), whenIsIn() a whenIsNotIn() spustia callback len pri splnení podmienky, s voliteľnou predvolenou vetvou. #### [Náhodné prípady a factories](https://roundly-consulting.com/sk/open-source/navody/enums-for-laravel/nahodne-pripady.md) random() vyberie náhodný prípad pre model factories, seedery a demo dáta; collect() prejde všetky prípady. #### [Výnimky](https://roundly-consulting.com/sk/open-source/navody/enums-for-laravel/vynimky.md) EnumException — vyhodia ju vyhľadávanie, random(), validationRule(), untranslated() a neplatné skupiny popisov — rozširuje InvalidArgumentException. #### [Prehľad API](https://roundly-consulting.com/sk/open-source/navody/enums-for-laravel/prehlad-api.md) Všetky statické a inštančné metódy, ktoré pridáva trait Helpers — signatúra, návratový typ a účel — plus atribút, rozhranie a DTO. #### [Testovanie](https://roundly-consulting.com/sk/open-source/navody/enums-for-laravel/testovanie.md) Overte popisy, možnosti a validáciu v Peste, skontrolujte preklady cez untranslated(), pridajte riadky cez Lang::addLines() a spustite testy balíka. #### [Požiadavky](https://roundly-consulting.com/sk/open-source/navody/enums-for-laravel/poziadavky.md) PHP 8.4+ a Laravel 12 alebo 13 — bez PHP rozšírení, service providera či konfigurácie. ## 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)