--- title: "Lifecycle for Laravel — dokumentácia | Roundly" description: "Vývojárska dokumentácia Lifecycle for Laravel, stavového automatu pre Eloquent: strážené prechody, kvóty, expirácia, plánovanie, rollbacky a história." url: https://roundly-consulting.com/sk/open-source/navody/lifecycle-for-laravel language: sk --- [Všetky balíky](https://roundly-consulting.com/sk/open-source.md) Open source # Lifecycle for Laravel Inštalácia `composer require roundly-consulting/lifecycle-for-laravel` Vyžaduje: PHP ^8.4 · Laravel ^12.0|^13.0 [GitHub](https://github.com/roundly-consulting/lifecycle-for-laravel) [Packagist](https://packagist.org/packages/roundly-consulting/lifecycle-for-laravel) [Prispieť (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Patreon](https://www.patreon.com/cw/roundly) ## Prehľad Stavové životné cykly — stavový automat — pre akýkoľvek Eloquent model so stavom: objednávky, tikety, inzeráty, predplatné či žiadosti. Stavy modelu a pomenované prechody medzi nimi deklarujete raz v malej triede definície — každý presun potom prejde jednou pipeline kontrol, ktorá overí, kto smie konať, limity a kvóty odolné voči súbehu, a zapíše riadok do histórie, ktorú nemožno meniť. Expirácia, upozornenia „čoskoro vyprší“, plánované prechody a rollbacky sú zabudované a každé zamietnutie je štruktúrovaný, preložený dôvod, ktorý zobrazíte priamo v rozhraní. Natívny balík s licenciou MIT, postavený len na Laraveli a vlastných základných balíkoch Roundly — bez závislostí tretích strán. ### Čo získate #### Deklaratívne definície Stavy z backed enumu alebo reťazcov, počiatočný a koncové stavy a pomenované prechody so zástupným znakom — aj viac cyklov na jeden model. #### Jedna pipeline kontrol Gate abilities, pravidlá pre aktéra, dôvody, validácia payloadu, vlastné guardy a termíny — každé zamietnutie je štruktúrovaný, preložený Denial. #### Limity a kvóty bez súbehu Maximálny počet, cooldown, minimálny čas v stave, rate limity a kvóty podľa scope, ktoré vydržia aj súbežné požiadavky. #### Expirácia a plánovanie TTL pre každý stav, ochranná lehota, upozornenia len raz, predĺženie a obnovenie a ľubovoľný prechod naplánovaný na neskôr — všetko spustí jeden sweep. #### Rollbacky a história Vráťte posledný prechod alebo sa vráťte k bodu v histórii, s časovým oknom, kompenzáciou a snapshotmi — nad históriou, ktorú nemožno meniť. #### Bezpečné pri súbehu Zámok riadku a zápis cez compare-and-swap pri každom prechode, udalosti po commite, optimistické verzie a idempotentné kľúče. #### Fasáda, DI alebo akcie Jedna fasáda Lifecycles, injektovateľný manažér alebo jednoúčelové akcie — a fake, ktorý odmietne to, čo skutočný engine odmietne aj bez databázy. ### Dokumentácia #### [Inštalácia](https://roundly-consulting.com/sk/open-source/navody/lifecycle-for-laravel/instalacia.md) Inštalácia cez Composer, voľba typov kľúčov, publikovanie migrácií a naplánovanie sweepu, keď stavy expirujú alebo plánujete prechody. #### [Konfigurácia](https://roundly-consulting.com/sk/open-source/navody/lifecycle-for-laravel/konfiguracia.md) Každý konfiguračný kľúč, predvolená hodnota a env premenná — typy kľúčov, subjekty, striktné zápisy, aktéri, transakcie, história a plány. #### [Definovanie životného cyklu](https://roundly-consulting.com/sk/open-source/navody/lifecycle-for-laravel/definovanie-cyklu.md) Deklarujte stavy, počiatočný a koncové stavy a pomenované prechody v triede definície — každá metóda buildera a spôsob validácie. #### [Modely so životným cyklom](https://roundly-consulting.com/sk/open-source/navody/lifecycle-for-laravel/modely.md) Implementujte LifecycleSubject, pridajte trait HasLifecycle a priraďte atribúty k definíciám — viac cyklov na model, vzťahy a rezervované názvy. #### [Fasáda Lifecycles](https://roundly-consulting.com/sk/open-source/navody/lifecycle-for-laravel/fasada.md) Prehľad fasády Lifecycles — handle for($model), pomocníci model(), prístupy definitions() a schedules(), sweep a priame zápisy. #### [DI a akcie](https://roundly-consulting.com/sk/open-source/navody/lifecycle-for-laravel/bez-fasady.md) Bez fasády: injektujte LifecycleManager alebo zavolajte jednoúčelovú akciu s request DTO — mapa handle → manažér → akcia. #### [Aplikovanie prechodov](https://roundly-consulting.com/sk/open-source/navody/lifecycle-for-laravel/aplikovanie-prechodov.md) Aplikujte pomenované prechody s aktérom, dôvodom a payloadom — transitionTo(), attempt(), výsledky, optimistické verzie a idempotentné kľúče. #### [Overenie pred akciou](https://roundly-consulting.com/sk/open-source/navody/lifecycle-for-laravel/overenie-pred-akciou.md) Overte prechod ešte pred aplikovaním — can(), check(), allowedTransitions() a štruktúrované, preložené objekty Decision a Denial. #### [Obmedzenia a guardy](https://roundly-consulting.com/sk/open-source/navody/lifecycle-for-laravel/obmedzenia.md) Pipeline kontrol v poradí — systémový kontext, pravidlá pre aktéra, Gate abilities, dôvody, payload, vlastné guardy — a všetky kódy zamietnutí. #### [Limity, kvóty a zmrazenie](https://roundly-consulting.com/sk/open-source/navody/lifecycle-for-laravel/limity-a-kvoty.md) Maximálny počet, cooldowny, minimálny čas v stave, zapečatenie, rate limity, kvóty podľa scope odolné voči súbehu a zmrazenie cyklu. #### [Handlery, hooky, stampy a snapshoty](https://roundly-consulting.com/sk/open-source/navody/lifecycle-for-laravel/handlery-a-hooky.md) Spúšťajte vedľajšie efekty v transakcii cez handlery a hooky onEnter/onExit, zapisujte časy, zachytávajte atribúty a kompenzujte pri rollbacku. #### [Expirácia](https://roundly-consulting.com/sk/open-source/navody/lifecycle-for-laravel/expiracia.md) TTL pre stav z intervalu, closure alebo stĺpca — ochranná lehota, upozornenia len raz, effectiveState() a extend, renew či neverExpire(). #### [Plánované prechody a sweep](https://roundly-consulting.com/sk/open-source/navody/lifecycle-for-laravel/planovane-prechody.md) Naplánujte ľubovoľný prechod na neskôr a spúšťajte splatné expirácie, upozornenia a plány cez lifecycle:sweep — priamo alebo cez frontu. #### [Rollbacky a história](https://roundly-consulting.com/sk/open-source/navody/lifecycle-for-laravel/rollbacky-a-historia.md) Vráťte posledný prechod alebo sa vráťte k bodu v histórii — všetko alebo nič, s oknom, kompenzáciou a snapshotmi — plus nemenná história. #### [Dotazovanie](https://roundly-consulting.com/sk/open-source/navody/lifecycle-for-laravel/dotazovanie.md) Query scopes pre stav, expiráciu, ochrannú lehotu, zmrazenie a čas v stave — plus eager loading cez withLifecycle() proti N+1 dotazom. #### [Striktné zápisy a drift](https://roundly-consulting.com/sk/open-source/navody/lifecycle-for-laravel/striktne-zapisy.md) Prečo priame zápisy stavu vyhadzujú výnimku, ktoré spôsoby zápisu obchádzajú engine a ako allowDirectWrites() a adopcia zosúladia drift. #### [Definície a grafy](https://roundly-consulting.com/sk/open-source/navody/lifecycle-for-laravel/definicie-a-grafy.md) Prezerajte stavy a prechody cez Lifecycles::model() a definitions() a exportujte diagramy Mermaid alebo DOT cez lifecycle:graph. #### [API zdroje a validácia](https://roundly-consulting.com/sk/open-source/navody/lifecycle-for-laravel/api-zdroje.md) LifecycleResource a TransitionRecordResource pre API, validačné pravidlá ValidTransition a ValidState a 422 či Retry-After zo zamietnutí. #### [Udalosti](https://roundly-consulting.com/sk/open-source/navody/lifecycle-for-laravel/udalosti.md) Všetky udalosti, kedy sa odošlú a čo nesú — počúvajte LifecycleTransitioned, nie updated z Eloquentu, a vedľajšie efekty spúšťajte po commite. #### [Artisan príkazy](https://roundly-consulting.com/sk/open-source/navody/lifecycle-for-laravel/prikazy.md) make:lifecycle, sweep, graph, validate, show, adopt a prune — signatúry, voľby a kedy ktorý príkaz spúšťať. #### [Súbežný prístup a databázy](https://roundly-consulting.com/sk/open-source/navody/lifecycle-for-laravel/subezny-pristup.md) Jedna transakcia a poradie zámkov pri každej zmene, zápis stavu cez compare-and-swap, READ COMMITTED pre kvóty na MySQL, deadlocky a Octane. #### [Migrácia zo status enumov](https://roundly-consulting.com/sk/open-source/navody/lifecycle-for-laravel/migracia.md) Preneste ručne písané status enumy, kontroly a príkazy na balík a presuňte existujúcu tabuľku cez lifecycle:adopt. #### [Testovanie](https://roundly-consulting.com/sk/open-source/navody/lifecycle-for-laravel/testovanie.md) Cez Lifecycles::fake() zaznamenáte prechody a zamietate na požiadanie, so všetkými aserciami — alebo testujte skutočný engine s factories. #### [Požiadavky](https://roundly-consulting.com/sk/open-source/navody/lifecycle-for-laravel/poziadavky.md) PHP 8.4+, Laravel 12 alebo 13 a SQLite, PostgreSQL alebo MySQL/MariaDB — s tabuľkami balíka v tej istej databáze ako vaše modely. ## 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)