Inštalácia

Pridajte balík, potom publikujte a spustite migrácie. Service provider aj alias fasády Certificates sa načítajú automaticky — bez manuálnej registrácie:

composer require roundly-consulting/certificates-for-laravel

php artisan vendor:publish --tag="certificates-migrations"
php artisan migrate

Migrácie sa len publikujú — service provider ich nikdy nenačíta, takže samotné php artisan migrate bez publikovania nič nevytvorí. Do database/migrations sa uložia ako vaše vlastné súbory s časovou pečiatkou: create_certificates_table a po nej add_domains_to_certificates_table. Opätovné publikovanie ich prepíše na mieste, neduplikuje ich.

Register odporúčame, nie je však povinný. Bez tabuľky balík naďalej vystavuje certifikáty cez API poskytovateľa (exists(), get(), generate()), ale nič nezaznamenáva a nevie sledovať expiráciu — find() a status() vracajú null.

Výber drivera

Predvolený driver je kubernetes — certifikát na pozadí vystaví cert-manager a výsledok zapíše naplánovaný certificates:sync (pozri Kubernetes a cert-manager). Pre Let’s Encrypt z jedného servera prepnite na acme, zadajte kontaktnú adresu pre certifikačnú autoritu a vystavujte:

CERTIFICATES_DRIVER=acme
CERTIFICATES_ACME_CONTACT=[email protected]

use RoundlyConsulting\Certificates\Facades\Certificates;

$certificate = Certificates::issueIfMissing('app.example.com');

Voliteľné publikovanie

Konfigurácia a preklady sú voliteľné — každý konfiguračný kľúč má hodnotu z env. Publikujte ich, len ak ich chcete prepísať:

php artisan vendor:publish --tag="certificates-config"
php artisan vendor:publish --tag="certificates-translations"

Balík ponúka tri publish tagy: certificates-migrations, certificates-config a certificates-translations.

Prekladové riadky — správy výnimiek a validácie, výstup konzoly aj výsledky upozornení — sú súčasťou balíka v angličtine a slovenčine v mennom priestore certificates::messages a Laravel použije ten, ktorý zodpovedá jazyku aplikácie. Preklady publikujte len vtedy, ak chcete prepísať niektorý riadok alebo pridať ďalší jazyk. Riadky s počtom (commands.pruned, commands.synced, alerts.ok / warning / critical a alerts.registry_failed) sa vykresľujú cez trans_choice(): angličtina používa tvar singular|plural, slovenčina {0} …|{1} …|[2,4] …|[5,*] …. Prepísaný riadok môže zostať jediný, bez | — použije sa tak, ako je.