Artisan príkazy
Šesť konzolových príkazov pokrýva celý životný cyklus z terminálu aj z plánovača. issue, renew, prune a sync len volajú koreň fasády — Certificates::issue(), renewDue() / renew(), prune() a sync() — takže ich Certificates::fake() zaznamená a --connection zacieli zvolený register. check prehľadáva cez Certificates::expiring(); list je len čítací dotaz nad modelom registra:
php artisan certificates:issue {domain} {--driver=} {--connection=}
php artisan certificates:list {--driver=} {--status=} {--expiring=} {--connection=}
php artisan certificates:renew {domain?} {--threshold=} {--queue} {--connection=}
php artisan certificates:check {--threshold=} {--alert} {--driver=} {--connection=}
php artisan certificates:prune {--days=30} {--status=} {--connection=}
php artisan certificates:sync {--driver=} {--connection=}| Príkaz | Čo robí |
|---|---|
certificates:issue | Spustí Certificates::issue() pre jednu doménu; --driver určí driver, --connection register. Pri zlyhaní skončí nenulovým kódom — neplatná doména, chyba poskytovateľa alebo už prebiehajúce vystavenie. |
certificates:list | Vypíše záznamy registra podľa domény; filtre --driver, --status (hodnota ako issued), --expiring=N dní a --connection. |
certificates:renew | Spustí Certificates::renewDue() — alebo renew() pre jednu doménu; --threshold prepíše renewal.threshold_days, --queue zaradí RenewCertificateJob do fronty. Vypíše výsledok každého certifikátu a pri akomkoľvek zlyhaní skončí nenulovým kódom. |
certificates:check | Prehľadá expirujúce certifikáty — vrátane už expirovaných — spustí CertificateExpiring a s --alert alebo pri alerts.enabled vytvorí upozornenia, pričom každý certifikát kontroluje na jeho vlastnom pripojení. Nikdy neobnovuje. |
certificates:prune | Spustí Certificates::prune(): soft-deletne záznamy neaktualizované --days dní (predvolene 30) v stave expired, failed alebo revoked — alebo len --status — a vypíše ich počet (Odstránili sa 3 certifikáty.). |
certificates:sync | Spustí Certificates::sync(): prenesie certifikáty poskytovateľa do registra podľa drivera a názvu — so živým stavom, expiráciou, vydavateľom, sériovým číslom a odtlačkom, ak ich driver hlási — a obnoví vyčistené záznamy, ktoré poskytovateľ stále hlási, okrem odvolaných. Rozpracované záznamy uzavrie aj s udalosťami (requested → issued + CertificateIssued, renewing → renewed + CertificateRenewed, → failed + CertificateFailed) a odvolaný záznam nikdy neobnoví. Vypíše počet zapísaných záznamov (Od poskytovateľa kubernetes sa synchronizoval 1 certifikát.). |
Príklady
php artisan certificates:issue shop.example.com --driver=acme
php artisan certificates:list --status=issued
php artisan certificates:list --expiring=14 --connection=tenant
php artisan certificates:renew --threshold=30 --queue
php artisan certificates:check --threshold=30 --alert
php artisan certificates:prune --days=60 --status=failed
php artisan certificates:sync --driver=kubernetesPlánovanie
Balík neregistruje žiadny plán. Typické nastavenie každých pár minút synchronizuje register (pri kubernetes, kde vystavenie prebieha asynchrónne, tak zapíše jeho výsledok), denne obnovuje certifikáty a kontroluje upozornenia:
use Illuminate\Support\Facades\Schedule;
Schedule::command('certificates:sync')->everyFiveMinutes(); // kubernetes: Requested → Issued, fires CertificateIssued
Schedule::command('certificates:renew')->daily();
Schedule::command('certificates:check --alert')->daily();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 kryptomienOdoslaním daru súhlasíte s našimi podmienkami prijímania darov.
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.