--- title: "Package Toolkit for Laravel — dokumentácia | Roundly" description: "Vývojárska dokumentácia Package Toolkit for Laravel: fluentný builder, migrácie len na publikovanie, makrá typov kľúčov a validácia konfigurácie." url: https://roundly-consulting.com/sk/open-source/navody/package-toolkit-for-laravel language: sk --- [Všetky balíky](https://roundly-consulting.com/sk/open-source.md) Open source # Package Toolkit for Laravel Inštalácia `composer require roundly-consulting/package-toolkit-for-laravel` Vyžaduje: PHP ^8.4 · Laravel ^12.0|^13.0 [GitHub](https://github.com/roundly-consulting/package-toolkit-for-laravel) [Packagist](https://packagist.org/packages/roundly-consulting/package-toolkit-for-laravel) [Prispieť (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Patreon](https://www.patreon.com/cw/roundly) ## Prehľad Natívny toolkit bez závislostí na tvorbu Laravel balíkov. Rozšírte jeden základný service provider, vo fluentnom builderi opíšte, čo váš balík obsahuje, a všetky volania publish, load a commands strážené cez runningInConsole() sa vygenerujú za vás — práve raz. K tomu dostanete schémové makrá podľa typu kľúča, prenosné LIKE vyhľadávanie odolné voči injekcii, prísne prístupy ku konfigurácii (vrátane čítačov tajných hodnôt), resolver modelov a trait pre fasády, ktorý drží tajné argumenty mimo stack trace. Licencia MIT, postavené len na oficiálnych API Laravelu a Symfony. ### Čo získate #### Fluentný builder balíka Rozšírte jeden základný provider a v jednom reťazci deklarujte konfiguráciu, migrácie, views, preklady, routy, príkazy, aliasy aj výstup about. #### Migrácie len na publikovanie Migrácie sa publikujú s usporiadanými časovými pečiatkami a pri opätovnom publikovaní sa prepíšu na mieste — nikdy sa nenačítajú automaticky, nezdvoja ani neprepíšu tie vaše. #### Schémové makrá podľa typu kľúča Jedna stratégia bigint/uuid/ulid riadená konfiguráciou s makrami ownerKey(), morphKey(), polymorphicSubject() a auditable(). #### Prísne čítanie konfigurácie Čítače celých a desatinných čísel, reťazcov, zoznamov, enumov, pevných slovníkov a booleanov plus čítače tajných hodnôt, ktoré hodnotu nikdy nevypíšu: nenastavená hodnota — chýbajúca, null alebo prázdna ako KEY= u hostiteľa — dostane predvolenú hodnotu, každá iná neplatná hodnota vyhodí výnimku. Aj pre polia DTO a s vašou vlastnou výnimkou. #### Prenosné a bezpečné vyhľadávanie whereLikeEscaped() escapuje zástupné znaky používateľa a na Postgrese použije ILIKE, inde LIKE — v query aj Eloquent builderi. #### Idempotentné od základu Gates, Blade direktívy a makrá sa zaregistrujú raz aj pri dvojitom boote — plus PHPStan rozšírenie pre makrá. ### Dokumentácia #### [Inštalácia](https://roundly-consulting.com/sk/open-source/navody/package-toolkit-for-laravel/instalacia.md) Inštalácia cez Composer — toolkit je knižnica, na ktorej stavia service provider vášho balíka, nič sa nepublikuje. #### [Builder balíka](https://roundly-consulting.com/sk/open-source/navody/package-toolkit-for-laravel/builder-balika.md) Rozšírte PackageServiceProvider, opíšte balík v configurePackage() a zvyšok zapojí základný provider. #### [Metódy buildera](https://roundly-consulting.com/sk/open-source/navody/package-toolkit-for-laravel/metody-buildera.md) Každá metóda buildera Package — konfigurácia, migrácie, preklady, views, routy, príkazy, aliasy, about a stuby — aj s publish tagom. #### [Migrácie len na publikovanie](https://roundly-consulting.com/sk/open-source/navody/package-toolkit-for-laravel/migracie.md) Migrácie balíka sa nikdy nenačítajú automaticky: publikujú sa s usporiadanými pečiatkami, prepíšu sa na mieste a migrate spustí hostiteľ. #### [Väzby a observery](https://roundly-consulting.com/sk/open-source/navody/package-toolkit-for-laravel/vazby-a-observery.md) Naviažte kontrakt na triedu z konfigurácie a pripojte observer ku konfigurovateľnému modelu — z register() a boot(). #### [Voliteľné traity](https://roundly-consulting.com/sk/open-source/navody/package-toolkit-for-laravel/volitelne-traity.md) Idempotentná registrácia gates, Blade direktív a schémových makier — dvojitý boot nič neprepíše ani nezaregistruje dvakrát. #### [Typy kľúčov a schémové makrá](https://roundly-consulting.com/sk/open-source/navody/package-toolkit-for-laravel/typy-klucov.md) Jedna stratégia kľúčov bigint/uuid/ulid riadená konfiguráciou s makrami ownerKey(), morphKey(), polymorphicSubject() a auditable(). #### [Statická analýza (PHPStan)](https://roundly-consulting.com/sk/open-source/navody/package-toolkit-for-laravel/staticka-analyza.md) Pribalené PHPStan rozšírenie deklaruje schémové aj query makrá, takže ich Larastan nikdy nehlási ako nedefinované metódy. #### [Databázové pomocníky](https://roundly-consulting.com/sk/open-source/navody/package-toolkit-for-laravel/databazove-pomocniky.md) Enum DatabaseDriver na vetvenie podľa drivera a whereLikeEscaped() — prenosné vyhľadávanie podreťazca odolné voči injekcii. #### [Validácia konfigurácie](https://roundly-consulting.com/sk/open-source/navody/package-toolkit-for-laravel/validacia-konfiguracie.md) Prísne čítanie konfigurácie — celé a desatinné čísla, reťazce, zoznamy, enumy, pevné slovníky a booleany, polia DTO a vlastná trieda výnimky. #### [Tajné hodnoty v konfigurácii a fasádach](https://roundly-consulting.com/sk/open-source/navody/package-toolkit-for-laravel/tajne-hodnoty.md) API kľúče a sady kľúčov čítajte s chybami, ktoré hodnotu nikdy neukážu, a jedným traitom udržte tajné argumenty fasády mimo stack trace. #### [Modely z konfigurácie](https://roundly-consulting.com/sk/open-source/navody/package-toolkit-for-laravel/modely-z-konfiguracie.md) Zistite konfigurovateľnú triedu Eloquent modelu cez ModelResolver alebo ResolvesModels — trieda, ktorá nededí z modelu balíka, vyhodí výnimku. #### [Výnimky a retry-after](https://roundly-consulting.com/sk/open-source/navody/package-toolkit-for-laravel/vynimky.md) Hierarchia výnimiek toolkitu s presnými správami a kontrakt HasRetryAfter pre chyby rate limitu. #### [Prechod existujúceho balíka](https://roundly-consulting.com/sk/open-source/navody/package-toolkit-for-laravel/prechod-na-toolkit.md) Presuňte ručne zapojený balík na toolkit v štyroch krokoch — provider, typy kľúčov, pomocníci, kontrola kvality. #### [Testovanie](https://roundly-consulting.com/sk/open-source/navody/package-toolkit-for-laravel/testovanie.md) Migrácie balíka načítajte v jeho TestCase explicitne a strážcov konfigurácie, makrá a direktívy testujte cez verejné API. #### [Požiadavky](https://roundly-consulting.com/sk/open-source/navody/package-toolkit-for-laravel/poziadavky.md) PHP 8.4+ a Laravel 12 alebo 13 — žiadne ďalšie runtime závislosti. S phpstan/extension-installer sa rozšírenie pre PHPStan načíta automaticky. ## 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)