Výnimky

RoundlyConsulting\Jwt\Jose\Exceptions\JwtException rozširuje RuntimeException a je základom každej chyby tokenu. Zachyťte ju na jednotné ošetrenie alebo zachyťte podtriedu pre presnú príčinu:

use RoundlyConsulting\Jwt\Facades\Jwt;
use RoundlyConsulting\Jwt\Jose\Exceptions\JwtException;
use RoundlyConsulting\Jwt\Jose\Exceptions\TokenExpired;

try {
    $claims = Jwt::verify($jwt);
} catch (TokenExpired $e) {
    // Prompt a re-login / refresh flow.
} catch (JwtException $e) {
    // Any other token failure: 401.
}

Chybná konfigurácia je 500, nie 401

Oba guardy premenia JwtException na null používateľa — teda 401. Chyby konfigurácie touto cestou ísť nesmú, preto zámerne nie sú JwtException:

• RoundlyConsulting\Jwt\Exceptions\JwtMisconfigured — nenastavený issuer či audience (null alebo prázdny), názov guardu, ktorý nie je jwt guard, nevolateľná token_version, mintAccessToken() na guarde s requestom pre iné audience alebo konfiguračná hodnota nesprávneho tvaru — TTL five, nerozpoznaný prepínač, chybná dvojica v service.secrets alebo v nej dvakrát uvedený vydavateľ či identity, ktorá nie je ClaimsAuthenticatable. Tajomstvo nikdy nevypíše: opakovaného vydavateľa pomenuje, len ak naň vyzerá, inak uvedie pozície položiek, a pri service.secret / service.secrets správa uvedie len typ hodnoty („must be a string or null, array given“), pričom samotná hodnota sa do rámcov stack trace nedostane.
• RoundlyConsulting\Jwt\ServiceTokens\Exceptions\ServiceAuthMisconfigured — chýbajúce alebo slabé tajomstvo, chýbajúci názov služby, chýbajúce audience či vlastný vydavateľ pri vydaní, chýbajúci vlastný záznam v mape tajomstiev alebo rezervované doplnkové claimy.
• KeyLoadFailed je JwtException, no guard jwt ju vyhodí ďalej ešte pred všeobecným ošetrením — chýbajúci či neplatný RSA kľúč je chyba prevádzky, nie neprihlásený volajúci.

Správy KeyLoadFailed sú konkrétne: pomenujú chýbajúcu či nečitateľnú cestu aj riešenie, napríklad spustiť jwt:generate-keys, nastaviť env premennú alebo dať PHP používateľovi právo na čítanie.