DI a priame triedy

Fasáda je odporúčaná voľba, nie jediná cesta. Crypto má tri rovnocenné vstupné body a všetky tri spúšťajú rovnaký kód:

• Fasáda Crypto — najkratší zápis, ktorý používa celá táto dokumentácia.
• Manažér RoundlyConsulting\Crypto\CryptoManager — koreň fasády, injektovaný cez konštruktor. Rovnaké API, explicitná závislosť a žiadne statické volania.
• Triedy, ktoré fasáda sprístupňuje — RsaKey, Jws, Token, Certificate a ďalšie — volané priamo. Základné továrne nepotrebujú kontajner, konfiguráciu ani disk.

Injektovanie manažéra

CryptoManager je finálny singleton v kontajneri bez argumentov konštruktora, takže injektovaná inštancia je presne ten objekt, ktorý volá fasáda:

use RoundlyConsulting\Crypto\CryptoManager;

final class IssueApiToken
{
    public function __construct(private CryptoManager $crypto) {}

    public function __invoke(): string
    {
        return $this->crypto->random()->token(48);
    }
}

// Or resolve it — a container singleton, the exact object the facade calls:
app(CryptoManager::class)->keys()->rsa()->generate(3072);

Priame volanie tried

Každá trieda funguje samostatne — tento zápis uvádza každá časť o funkciách ako alternatívu k fasáde:

use RoundlyConsulting\Crypto\Jose\Jws;
use RoundlyConsulting\Crypto\Random\Token;
use RoundlyConsulting\Crypto\Signature\Key\RsaKey;
use RoundlyConsulting\Crypto\X509\Certificate;

$key         = RsaKey::private($pem);        // core factories need no container, config or disk
$code        = Token::numeric(6);
$certificate = Certificate::fromDer($der);
$jws         = new Jws;

Žiadne triedy akcií

Crypto nemá triedy akcií. Ide o bezstavové výpočty, preto balík namiesto jednej akcie na metódu ponúka obyčajné servisné objekty: vnorené prístupy sú finálne, nedržia stav a každá ich metóda deleguje na jednu statickú továreň. Tabuľka priraďuje každej metóde fasády triedu, ktorú sprístupňuje: