Migrácia zo status enumov

Väčšina aplikácií začína stĺpcom status, backed enumom a niekoľkými ručne písanými kontrolami. Bežné vzory sa na balík prenesú takto — zámky riadkov, zápisy cez compare-and-swap aj obnovenie modelu v pamäti po zlyhaní sú zabudované:

Predtým a potom

// Before
public function execute(Appointment $appointment, Status $to): void
{
    if (! $appointment->status->canTransitionTo($to)) {
        throw new InvalidTransition;
    }

    $appointment->update(['status' => $to]);
    event(new AppointmentStatusChanged($appointment, $to));
}

// After
$appointment->transitionTo(Status::Confirmed);
Lifecycles::for($appointment)->by($vet)->because('Patient did not come')->apply('mark_no_show');

Presun existujúcej tabuľky

• 1. Nainštalujte balík, nastavte typy kľúčov, publikujte a spustite migrácie.
• 2. Napíšte definíciu so stavmi, ktoré už stĺpec obsahuje — enum si ponechajte a použite ho priamo (states(Status::class)), potom ju zvalidujte voči tabuľke.
• 3. Urobte z modelu subjekt (implements LifecycleSubject, use HasLifecycle, lifecycleDefinitions()). Nové riadky odteraz dostávajú záznamy aj históriu automaticky.
• 4. Existujúce riadky prevezmite cez lifecycle:adopt: každý riadok dostane záznam, jeho uložený stav sa prevezme a stavy NULL sa zmenia na počiatočný stav. Prevzaté pobyty začínajú teraz; pri stavoch s TTL zabráni --no-expiry naplánovaniu expirácie pre všetky staré riadky naraz. Príkaz sa dá spustiť opakovane.
• 5. Ručne písaný kód prechodov nahraďte apply() / transitionTo(). So zapnutým strict_writes teraz priame $model->status = …; save() vyhodí výnimku; updaty cez query builder sa prevezmú pri ďalšej zmene.
• 6. Vedľajšie efekty presuňte do handlerov (v transakcii) alebo listenerov LifecycleTransitioned (po commite, pre e-maily a externé volania).
• 7. Ak ste pridali TTL alebo plány, naplánujte sweep.
• 8. Kontroly v rozhraní nahraďte can() / allowedTransitions() alebo LifecycleResource a validáciu formulárov pravidlom ValidTransition.

php artisan lifecycle:validate "App\Models\Order:status"
php artisan lifecycle:adopt "App\Models\Order" --no-expiry   # or without --no-expiry to start TTLs now

V seederoch a factories je vytvorenie modelu s ľubovoľným deklarovaným stavom povolené a zaznamenané. Zmena stavu už uloženého modelu v afterCreating alebo v seederi vyžaduje Lifecycles::allowDirectWrites() (prevezme sa okamžite), prípadne spustite seeder s LIFECYCLE_STRICT_WRITES=false.