Každá výnimka balíka dedí z RoundlyConsulting\Plausible\Exceptions\PlausibleException, takže jeden catch zachytí čokoľvek z klienta:
| Výnimka | Kedy vznikne |
|---|---|
MissingConfiguration | Pri prvom volaní chýba url, pri prvom volaní Stats alebo Sites API chýba key (zaznamenávanie udalostí funguje aj bez neho), prípadne volanie potrebuje web a ten nie je zadaný ani nakonfigurovaný. |
UniqueVisitorIdentifierRequired | Udalosť sa zaznamenáva (synchrónne, cez frontu alebo v dávke) pred volaním setVisitor() alebo fromRequest(). |
InvalidRevenue | Mena alebo suma tržby je neplatná — výnimka z money je dostupná cez getPrevious(). |
RateLimitExceeded | Obmedzená požiadavka by čakala dlhšie než max_wait danej oblasti. Nesie key a retryAfterSeconds(). |
use Illuminate\Http\Client\RequestException;
use RoundlyConsulting\Plausible\Enums\Metric;
use RoundlyConsulting\Plausible\Exceptions\PlausibleException;
try {
$visitors = Plausible::stats()->query()->last7Days()->aggregate()->metric(Metric::Visitors);
} catch (PlausibleException $e) {
// configuration, visitor, revenue or rate-limit problem raised by the package
} catch (RequestException $e) {
// Plausible answered with a non-2xx status — $e->response holds it
}Jedinou výnimkou mimo tejto hierarchie je chybné nastavenie: vyhodí RoundlyConsulting\PackageToolkit\Exceptions\InvalidConfigurationException z balíka package toolkit s názvom kľúča — napríklad pri preklepe v env, ako PLAUSIBLE_TIMEOUT=five alebo PLAUSIBLE_STATS_RATELIMIT_PER=hourly. Pozrite časť Konfigurácia.
Chyby HTTP
Chyby HTTP sú vlastné výnimky Laravelu: odpoveď Plausible mimo 2xx vyhodí Illuminate\Http\Client\RequestException — až potom, čo limiter zaznamená prípadnú penalizáciu 429 — a výpadok siete vyhodí Illuminate\Http\Client\ConnectionException. Pre prechodné chyby spojenia zapnite retry.*.
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 kryptomienOdoslaním daru súhlasíte s našimi podmienkami prijímania darov.
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.