Príkazy a kontrola stavu

Pätnásť príkazov pokrýva inštaláciu, overovanie, údržbu a kľúče. Modely zadávate ako názov triedy alebo morph alias a príkazy volajú injektovaný SentinelManager, takže v testoch bežia aj nad Sentinel::fake().

php artisan sentinel:verify                                   # every sealable model
php artisan sentinel:verify "App\Models\Invoice" --seal=financial --ledger
php artisan sentinel:verify --fail-on=tampered,missing --fail-on=backlog
php artisan sentinel:verify --ledger --anchor='<json>'           # compare a payload from a log anchor
php artisan sentinel:verify --check-schema --limit=10000         # CI against a staging snapshot
php artisan sentinel:reseal "App\Models\Invoice" --from-key=default-20250901-a1b2c3 --dry-run
php artisan sentinel:seal-missing "App\Models\Invoice" --reason="Initial baseline 2026-10"
php artisan sentinel:inspect "App\Models\Invoice" 42 --seal=financial
php artisan sentinel:prune --dry-run
php artisan sentinel:key:list --ring=http

Voľby, ktoré sa oplatí poznať

• --fail-on berie hodnoty VerificationStatus (tampered, missing, … — aj outdated a unsealed, ktoré inak nikdy nezlyhajú) a hodnoty LedgerFindingKind, opakovane alebo oddelené čiarkou. Uvedené stavy nahradia predvolené — zlyhajú len tie; ak uvediete len druhy zistení denníka, zlyhávajúce stavy ostanú všetky. Porušenia denníka zlyhajú vždy; backlog a anchor_unreachable len vtedy, ak ich uvediete. Neznámy názov skončí kódom 2.
• --anchor='<json>' (obsah skopírovaný z kotvy log, ktorá sa len zapisuje) sa číta len spolu s --ledger; nedekódovateľný obsah skončí kódom 2.
• --isolated[=EXIT] (sentinel:verify, sentinel:checkpoint) beh preskočí — s kódom 0 alebo zadaným — kým zámok drží iná inštancia.
• Rozsahy: --chunk 1–100 000, --limit ≥ 1 (riadkov spolu naprieč modelmi), --max-findings 0–1 000 000, --batch 1–100 000; dôvody 1–sealing.reason_max_length znakov, dôvod odvolania najviac 1 000.
• --json: sentinel:verify vypíše models, unresolved_types, scanned, counts, findings, truncated a objekt ledger; sentinel:check vypíše failed a zoznam kontrol, pričom failed rešpektuje --strict.
• sentinel:inspect ponechá hodnoty skryté, pokiaľ nezadáte --show-values (môžu obsahovať osobné údaje); sentinel:key:import číta materiál z --file alebo zo skrytého vstupu, nikdy z argumentu, ktorý by skončil v histórii shellu. Riadok pečate s poškodeným sealed_at sentinel:inspect stále zobrazí (zapečatené —, stav malformed (sealed_at), kód 1) namiesto toho, aby skončil chybou.
• sentinel:key:reseal prejde každý kruh, ktorý ukladá kľúče v databáze (--ring pre jeden), riadok po riadku pod zámkom riadku a pred zápisom vypíše ring:kid → "label" — binding, would bind (--dry-run, ktorý nič nezapíše) alebo already bound — s riadiacimi a neviditeľnými znakmi, < a > escapovanými rovnako ako v sentinel:key:list. Je idempotentný a po úspechu bez --dry-run pripomenie nastaviť SENTINEL_REQUIRE_BOUND_LABEL=true.

Návratové kódy

0 znamená úspech, 1 zlyhanie a 2 neplatný vstup:

Plánovanie

Provider zaregistruje údržbu v plánovači, kým je schedule.enabled zapnuté (predvolené), každú úlohu s withoutOverlapping()->onOneServer(). Plný sken je predvolene denný — hodinové skeny celých tabuliek sú pri veľkých tabuľkách tichou záťažou — kým kontrolný bod ostáva každú minútu, pretože jeho interval je okno, v ktorom návrat ostane nepovšimnutý:

Ak ich chcete zapojiť sami, nastavte SENTINEL_SCHEDULE=false a pridajte ich do routes/console.php. Ručne zapísané riadky nenechávajte vedľa automatického plánu — withoutOverlapping() bráni súbežným behom, nie dvojitému naplánovaniu.

// routes/console.php
use Illuminate\Support\Facades\Schedule;

Schedule::command('sentinel:checkpoint')->everyMinute()->withoutOverlapping();
Schedule::command('sentinel:verify --ledger')->hourly();
Schedule::command('sentinel:verify --json')->dailyAt('03:00')->emailOutputOnFailure('[email protected]');
Schedule::command('sentinel:prune')->daily();

Sentinel::sealables() vypíše, čo sentinel:verify bez zadaného modelu skenuje: najprv sentinel.models, potom každú triedu s riadkami pečatí alebo záznamami v denníku. Ak nie je čo skenovať, skončí kódom 2, takže chybná konfigurácia nikdy nehlási zelenú. V CI zastaví pipeline pri zisteniach sentinel:verify --check-schema --limit=10000 nad snapshotom zo stagingu a sentinel:check --strict pri akejkoľvek oslabenej záruke.

Aplikácia bez tabuliek Sentinelu

Aplikácia, ktorá Sentinel dostane len ako závislosť iného balíka, nikdy nepublikuje jeho konfiguráciu ani migrácie — plán je pritom predvolene zapnutý. Preto sa každá plánovaná úloha preskočí, kým neexistuje žiadna z tabuliek, ktoré konfigurácia potrebuje (ten istý zoznam číta kontrola tables):

• Žiadna tabuľka: checkpoint, verify a prune ostanú zaregistrované (schedule:list ich ukáže), no nikdy sa nespustia — schedule:run pre každú odošle ScheduledTaskSkipped. Nič nezlyhá, takže taká aplikácia nepotrebuje SENTINEL_SCHEDULE=false.
• Existuje aspoň jedna tabuľka: aplikácia úložisko Sentinelu používa a každá úloha beží ako predtým — napoly zmigrovaná inštalácia zlyhá rovnako hlasno ako vždy.
• prune sa preskočí len vtedy, keby čistil tabuľku Sentinelu: s úložiskom cache alebo s úložiskom naviazaným v aplikácii beží bez ohľadu na tabuľky.
• Nedá sa to zistiť (pripojenie zlyhá, nastavenie sa nedá prečítať, úložisko sa nedá zostaviť): úloha sa spustí a zlyhanie nahlási sama.
• Zisťuje sa to len pre úlohu, ktorá je na rade, raz za schedule:run: jeden hasTable pre každú potrebnú tabuľku, kým sa nájde prvá. Migrácia úlohy zapne pri najbližšom schedule:run.

Preskočenie je zámerne tiché, a preto kontrola stavu tichá nie je: kým sa úloha preskakuje, kontrola schedule zlyhá a úlohu pomenuje a php artisan about ukáže auto (checkpoint, verify, prune skipped: no tables). Príkazy, ktoré spustíte sami, a riadky, ktoré si naplánujete ručne, sa nikdy nepreskočia.

Kontrola stavu

sentinel:check (alebo Sentinel::check()) nahlási na jednom mieste každú chybnú konfiguráciu, ktorá potichu oslabuje záruky. Správy uvádzajú nastavenia, kruhy, tabuľky a triedy — nikdy materiál kľúčov, ich id ani labely:

$report = Sentinel::check();          // HealthReport
$report->failed();                    // any failure (warnings do not fail it)
$report->failures();                  // list<HealthCheck>: name, status, message
$report->warnings();