Open source
Plausible for Laravel
composer require roundly-consulting/plausible-for-laravelPrehľad
Prehľadný a výstižný klient pre API Plausible Analytics — Cloud aj self-hosted. Čítajte štatistiky cez fluentný typovaný builder, zaznamenávajte udalosti a presné tržby zo servera, sledujte zobrazenia stránok a udalosti modelov bez písania sledovacieho kódu a spravujte weby, ciele a zdieľané odkazy priamo z Laravel aplikácie. Licencia MIT, postavené len na oficiálnych komponentoch Laravelu a štyroch malých sprievodných balíkoch Roundly — bez SDK tretích strán.
Čo získate
Plynulé typované štatistiky
Realtime, súhrnné, časové a rozpadové dotazy cez jeden fluentný builder, ktorý vracia typované výsledkové objekty.
Dotazy Stats v2
Dimenzie, typovo bezpečné filtre where()/orWhere(), radenie a stránkovanie nad endpointom /api/v2/query.
Udalosti zo servera
Zaznamenávajte zobrazenia stránok a vlastné udalosti z backendu — synchrónne, cez frontu alebo ako jednu dávku úloh.
Presné tržby
Tržba je Money z money-for-laravel, odoslaná ako presný desatinný reťazec. Meny, ktoré Plausible neprevedie, sa odmietnu vopred.
Sledovanie bez sledovacieho kódu
Middleware na zobrazenia stránok, trait Trackable pre modely a hosťovaný skript cez @plausibleScript alebo Plausible::script().
Správa webov
Vytvárajte, upravujte a mažte weby, ciele a zdieľané odkazy na dashboard priamo z kódu — ideálne pre multi-tenant produkty.
Limity požiadaviek a testovací fake
Klientske obmedzenie požiadaviek pre každú oblasť API s adaptívnym spomalením pri 429 a nahrávací Plausible::fake() pre testy.
Dokumentácia
Inštalácia
Inštalácia cez Composer, tri premenné prostredia a overenie pripojenia jedným Artisan príkazom.
Konfigurácia
Každý konfiguračný kľúč, jeho predvolená hodnota a premenná env — inštancia, web, HTTP, limity, sledovanie a skript.
Fasáda Plausible
Fasáda Plausible: jeden klient pre každú oblasť API — štatistiky, udalosti, weby, ciele, zdieľané odkazy — plus skript, ping a health.
Bez fasády
Bez fasády: injektujte PlausibleManager alebo zavolajte helper plausible() — a prečo sú tu namiesto akcií klienti pre oblasti API.
Dotazy na štatistiky
Realtime návštevníci, súhrny, časové rady a rozpady cez fluentný builder s typovanými výsledkami a skratkami období.
Filtre
Typovo bezpečné filtre where()/orWhere() pre Stats v2, filtre na vlastné vlastnosti a surové tvary v1 a v2.
Dotazy Stats v2
Endpoint /api/v2/query s dimenziami, radením, include a stránkovaním a pozičné riadky QueryResult.
Cache, kolekcie a stránkovanie
Cache ľubovoľného dotazu podľa jeho podpisu, výsledky ako Collection a prechod všetkými stranami rozpadu cez cursor() či each().
Explicitné objekty požiadaviek
Zostavte AggregateRequest, TimeseriesRequest a BreakdownRequest sami a získajte surovú Response alebo typovaný výsledok.
Zaznamenávanie udalostí
Posielajte zobrazenia stránok a vlastné udalosti zo servera — synchrónne, cez frontu alebo v dávke — s návštevníkom pre Plausible.
Tržby
Pripájajte k udalostiam presné tržby ako Money z money-for-laravel — desatinné reťazce, žiadne floaty, neplatné meny odmietnuté.
Automatické zobrazenia stránok
Middleware plausible.track zaznamená zobrazenia úspešných HTML GET odpovedí zo servera, až po odoslaní odpovede.
Udalosti modelov (Trackable)
Trait Trackable posiela udalosti Plausible pri udalostiach životného cyklu Eloquentu — vlastné props, URL a web pre každý model.
Sledovací skript
Oficiálny hosťovaný skript Plausible cez @plausibleScript alebo <x-plausible-script>, nastavený na jednom mieste.
Weby, ciele a zdieľané odkazy
Vytvárajte weby, konverzné ciele a zdieľané odkazy na dashboard Plausible z kódu — typované výsledky, jeden limit.
Enumy
Typovo bezpečné metriky, obdobia, intervaly, vlastnosti, dimenzie, operátory a typy cieľov s pomocníkmi z enums-for-laravel.
Obmedzenie požiadaviek
Klientske limity požiadaviek zvlášť pre stats, events a sites s adaptívnym spomalením pri 429, rýchlym zlyhaním a zdieľaným rozpočtom.
Kontrola stavu
Overenie konfigurácie a spojenia s API bez výnimiek — ping(), health() a Artisan príkaz plausible:health.
Výnimky
Hierarchia PlausibleException — chyby konfigurácie, návštevníka, tržieb a limitov — a ako sa prejavia chyby HTTP.
Testovanie
Nahraďte klienta nahrávacím Plausible::fake() — bez reálneho HTTP — a overujte udalosti, dotazy aj správu webov.
Požiadavky
PHP 8.4+ s ext-bcmath, Laravel 12 alebo 13 a účet Plausible — kľúč Stats alebo Sites API, na samotné zaznamenávanie udalostí bez kľúča.
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.