---
title: "Fluentný builder — Certificates for Laravel | Roundly"
description: "Certificates::for() je rukoväť domény — driver, SAN domény, vlastník, meta a platnosť, potom vystavenie, stav, obnova, odvolanie či expirácia."
url: https://roundly-consulting.com/sk/open-source/navody/certificates-for-laravel/fluentny-builder
language: sk
---

[Všetky balíky](https://roundly-consulting.com/sk/open-source.md)

[Certificates for Laravel](https://roundly-consulting.com/sk/open-source/navody/certificates-for-laravel.md)

# 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:

```php
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(), status(), exists() 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

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

$builder->issue();                 // Certificate — always provisions
$builder->issueIfMissing();        // Certificate — the active certificate covering the domain, 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 aktívny certifikát, ktorý doménu už pokrýva — jej vlastný záznam, inak SAN certifikát, ktorý ju uvádza — pri nastavenom using() len na tomto driveri; inak vystaví nový. |
| `exists()` | bool | Opýta sa drivera z using() (alebo predvoleného) na primárnu doménu. |
| `status()` | ?CertificateStatus | Stav pokrývajúceho certifikátu v registri (najprv vlastný záznam, potom SAN), pri nastavenom using() len na tomto driveri. |
| `find()` | ?Certificate | Posledný záznam registra pre primárnu doménu 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](https://roundly-consulting.com/sk/podporte-nas.md)

Odoslaním daru súhlasíte s našimi [podmienkami prijímania darov](https://roundly-consulting.com/sk/podmienky-darov.md).

[Podporte našu open-source prácu (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Pridajte sa k nám na Patreone (otvorí sa v novej karte)](https://www.patreon.com/cw/roundly)

## 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](https://roundly-consulting.com/sk/kontakt.md) [Prezrieť všetky balíky](https://roundly-consulting.com/sk/open-source/navody/certificates-for-laravel.md)