Open source
Certificates for Laravel
composer require roundly-consulting/certificates-for-laravelPrehľad
Vyžiadajte, sledujte a obnovujte TLS certifikáty svojich domén priamo z Laravelu. Certifikát vystavíte jedným volaním — od Let’s Encrypt cez natívneho ACME v2 klienta v čistom PHP, z cert-managera v Kubernetes alebo zo Storage disku — a každý výsledok sa zapíše do lokálneho Eloquent registra so stavom, doménami, vlastníkom a expiráciou. Obnova, kontroly expirácie, pripojenia pre tenantov a zaznamenávajúci testovací fake sú súčasťou balíka — všetko za jednou fasádou Certificates. Licencia MIT a minimum závislostí: transport je HTTP klient Laravelu, CSR zabezpečuje ext-openssl a každé kryptografické primitívum pochádza z nášho auditovaného crypto-for-laravel — žiadne externé ACME, kryptografické ani Kubernetes SDK.
Čo získate
Natívny ACME klient
Skutočné certifikáty od Let’s Encrypt alebo ľubovoľnej ACME v2 autority v čistom PHP — HTTP-01 v balíku, DNS-01 cez vlastný solver.
Vymeniteľné drivery
ACME, cert-manager v Kubernetes, driver nad Storage diskom plus drivery null a in-memory — jedno API a priestor pre vlastného poskytovateľa.
Dotazovateľný register
Každý certifikát ako Eloquent model so stavom, SAN doménami, vlastníkom a expiráciou — otázku „čo vyprší do 14 dní?“ zodpovie jeden scope.
SAN a wildcard certifikáty
Viac hostiteľov alebo *.example.com jedným certifikátom cez for([...]) či alsoFor().
Obnova a upozornenia
Certificates::renewDue() obnoví alebo zaradí do fronty všetko, čo je na rade, a vykáže výsledok každého certifikátu; expirácia sa cez alerts-for-laravel mení na kontroly warning a critical.
Vlastníci a tenanti
Certifikáty priradené tenantom cez HasCertificates a samostatné databázové pripojenie pre každého tenanta cez on().
Fasáda, DI alebo akcie
Volajte fasádu Certificates, injektujte CertificatesManager alebo spustite akciu — a Certificates::fake() zaznamená každé volanie, s aserciou pre každé z nich.
Dokumentácia
Inštalácia
Inštalácia cez Composer, publikovanie a spustenie migrácií registra, výber drivera a voliteľne publikovanie konfigurácie a prekladov.
Konfigurácia
Každý kľúč config/certificates.php s env premennou a predvolenou hodnotou — driver, register, obnova, zámok, cache stavu a upozornenia.
Fasáda Certificates
Celá fasáda Certificates na jednom mieste — vystavenie, renew, revoke a expire, hromadné renewDue, sync a prune, rukoväť for() a drivery.
DI a akcie
Bez fasády: injektujte CertificatesManager s rovnakým API alebo volajte sedem jednoúčelových akcií priamo z vlastného kódu.
Vystavovanie certifikátov
Vystavte a sledujte certifikát jedným volaním — issueIfMissing(), issue() s DTO či generate() — a čo sa pritom deje.
Fluentný builder
Certificates::for() je rukoväť domény — driver, SAN domény, vlastník, meta a platnosť, potom vystavenie, stav, obnova, odvolanie či expirácia.
Drivery
Päť dodávaných driverov — kubernetes, acme, filesystem, null a array — čo ktorý dokáže a ako ho vybrať pre konkrétne volanie.
ACME a Let’s Encrypt
Získajte skutočné certifikáty od Let’s Encrypt alebo ľubovoľnej ACME v2 autority v čistom PHP — HTTP-01 v balíku, DNS-01 cez vlastný solver.
Kubernetes a cert-manager
Riaďte cert-manager z Laravelu — driver kubernetes doplní Ingress o TLS hostiteľov a stav Certificate zdrojov číta cez Kubernetes API.
Súborový driver
Uchovávajte PEM materiál na Storage disku Laravelu — importujte certifikáty vystavené inde alebo si ich pre vývoj podpíšte sami.
Viac domén a wildcardy
Pokryte viac hostiteľov alebo wildcard jedným SAN certifikátom a nájdite certifikát, ktorý pokrýva ľubovoľného hostiteľa.
Register certifikátov
Eloquent model Certificate — stĺpce, query scopes, pomocníci pre expiráciu, zmeny stavu cez fasádu, vymeniteľný model a schéma.
Stav a živé reporty
Životný cyklus CertificateStatus a jeho prechody, stav z registra verzus cachované živé reporty poskytovateľa a riadenie cache.
Certifikáty na modeloch
Pridajte HasCertificates tenantom, webom či tímom a vyžadujte, vyhľadávajte a vypisujte ich certifikáty cez morph certifiable.
Pripojenia pre tenantov
Register každého tenanta držte na vlastnom databázovom pripojení — pre volanie cez on(), globálne cez konfiguráciu a --connection v príkazoch.
Obnova certifikátov
Obnovujte certifikáty pred expiráciou cez Certificates::renewDue() alebo certificates:renew — priamo či cez frontu, s výsledkom každého certifikátu.
Sledovanie expirácie
Expirácia certifikátov cez alerts-for-laravel — pásma warning a critical, monitory jednotlivých certifikátov, certificates:check a upozornenia pri zlyhaní.
Udalosti
Sedem udalostí životného cyklu — requested, issued, failed, renewed, expiring, revoked a expired — každá nesie model z registra.
Artisan príkazy
Šesť príkazov na vystavenie, výpis, obnovu, kontrolu, čistenie a synchronizáciu certifikátov — so všetkými voľbami a príkladmi pre plánovač.
Rozšírenie
Zapojte vlastného poskytovateľa certifikátov cez Certificates::extend(), ukladajte materiál cez CertificateStore a pridajte makrá managera.
Validácia a výnimky
Overujte zadané domény pravidlom ValidDomain a spracujte typované výnimky balíka pod spoločným základom CertificateException.
Testovanie
Certificates::fake() zaznamená v pamäti každé vystavenie, obnovu, odvolanie, expiráciu, sync aj prune, s aserciou pre každé — plus driver array a factory.
Požiadavky
PHP 8.4+ s ext-openssl a ext-json, Laravel 12 alebo 13 a štyri balíky Roundly, ktoré sa doinštalujú 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 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.