Fluentný builder

Certificates::for() vracia CertificateBuilder — rukoväť pre jednu doménu. Každý setter vracia builder, takže certifikát popíšete a zakončíte terminálnym volaním:

use RoundlyConsulting\Certificates\Facades\Certificates;

$certificate = Certificates::for('shop.example.com')
    ->alsoFor('www.shop.example.com')
    ->using('acme')
    ->validForDays(90)
    ->meta(['tenant' => '7'])
    ->owner($tenant)        // attaches via the HasCertificates morph
    ->issue();

Settery

Metóda	Účinok
`alsoFor(string ...$domains)`	Pridá SAN domény do jedného certifikátu pre viac domén.
`using(string $driver)`	Driver pre toto vystavenie; obmedzuje aj find(), issueIfMissing() a statusReport().
`validForDays(int $days)`	Náhradná expirácia, keď ju driver neuvádza (predvolene 90).
`meta(array $meta)`	Uloží sa do JSON stĺpca meta v registri.
`owner(Model $owner)`	Priradí vlastníka cez certifiable.
`fresh(bool $fresh = true)`	Obíde cache stavu pri statusReport().

Vydavateľ a namespace patria do konfigurácie drivera, nie k jednotlivému certifikátu: driver kubernetes vždy použije drivers.kubernetes.issuer, issuer_kind a namespace. Pre druhého vydavateľa alebo iný namespace zaregistrujte ďalší driver cez Certificates::extend() a zvoľte ho cez using().

Terminálne metódy

$builder = Certificates::for('shop.example.com')->using('acme');

$builder->issue();                 // Certificate — always provisions
$builder->issueIfMissing();        // Certificate — the active record, or a new issuance
$builder->exists();                // bool
$builder->status();                // ?CertificateStatus
$builder->find();                  // ?Certificate
$builder->fresh()->statusReport(); // ?CertificateStatusReport — cache bypassed

// Lifecycle verbs on the domain's registry row — the acme row only, because of using().
$builder->renew();                 // Certificate — renewed now
$builder->renewLater();            // Certificate — RenewCertificateJob queued
$builder->revoke('key compromise'); // Certificate — Revoked + CertificateRevoked
$builder->expire();                // Certificate — Expired + CertificateExpired

Metóda	Vracia	Správanie
`issue()`	Certificate	Vždy vystaví a zaznamená certifikát.
`issueIfMissing()`	Certificate	Vráti posledný aktívny záznam pre driver, inak vystaví nový.
`exists()`	bool	Opýta sa predvoleného poskytovateľa na primárnu doménu.
`status()`	?CertificateStatus	Stav posledného záznamu v registri.
`find()`	?Certificate	Posledný záznam registra filtrovaný podľa using().
`statusReport()`	?CertificateStatusReport	Živý report od drivera z using() (alebo predvoleného), s cache.
`renew()`	Certificate	Hneď obnoví záznam domény v registri.
`renewLater()`	Certificate	Zaradí pre tento záznam RenewCertificateJob do fronty.
`revoke(?string $reason = null)`	Certificate	Zaznamená odvolanie tohto záznamu.
`expire()`	Certificate	Označí záznam ako expirovaný.

Slovesá životného cyklu nájdu najnovší záznam domény v registri — pri nastavenom using() len pre daný driver — a zavolajú zodpovedajúcu metódu managera, takže ich Certificates::fake() zaznamená. Ak záznam neexistuje, vznikne CertificateException; rukoväť nikdy nesiahne po zázname inej domény ani po zázname tej istej domény pod iným driverom.

for() prijíma aj zoznam domén — prvá je primárna, ostatné sa stanú SAN doménami (pozri Viac domén a wildcardy). Rukoväť vytvárajte cez Certificates::for() — jej konštruktor je interný. Rovnako ako manager je aj builder makrovateľný.

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

Odoslaním daru súhlasíte s našimi podmienkami prijímania darov.

Podporte našu open-source prácu Pridajte sa k nám na Patreone

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 Prezrieť všetky balíky