PHP e Laravel

Installazione composer require blipit/blipit

Installa il pacchetto blipit/blipit (0.3.0 o successivo) e chiama init una volta con la chiave pubblica del tuo progetto. Funziona sul core di Blipit e non porta con sé nessun altro pacchetto. Eccezioni non catturate, warning ed errori fatali vengono segnalati da soli, e Laravel e Symfony sono integrati.

Incollalo in Claude Code, Cursor o in qualsiasi assistente di programmazione IA. Contiene i passaggi e il codice. In app.blipit.io, in Chiavi API, lo stesso prompt ha già la tua chiave inserita.
Video: installare Blipit in qualsiasi stack, da 1:07

1Installazione

sh
composer require blipit/blipit

2Inizializza all'avvio

PHP semplice: in cima al tuo front controller, prima che venga gestita qualsiasi richiesta. Laravel avvia Blipit dalla sua configurazione, come nel passaggio successivo. La chiave è nella pagina Chiavi del progetto. Con una chiave vuota, init scrive un avviso nel log degli errori e restituisce false invece di lanciare un'eccezione.

php
use Blipit\Blipit;

Blipit::init([
    "key" => "<public key>",
    "environment" => "production",
    "release" => "myapp@1.4.2",
]);

3Ottieni le chiavi

Accedi su app.blipit.io e apri Chiavi API nella barra laterale, poi il tuo progetto. Ogni progetto ha due chiavi. La chiave pubblica inizia con blipit_pk_: va nel codice del browser e delle app, può solo inviare eventi e chiunque può vederla senza rischi. La chiave segreta inizia con blipit_sk_: resta sul tuo server o in Odoo, mai in un browser, perché può anche leggere e modificare le issue. La chiave segreta viene mostrata una sola volta, subito dopo la creazione, quindi copiala in quel momento; se la perdi, premi Crea una nuova chiave segreta e quella vecchia smette subito di funzionare. Alcuni SDK richiedono anche l'id del progetto, mostrato nella stessa pagina.

Chiavi API su app.blipit.io: la chiave pubblica (blipit_pk_) per il codice del browser e la chiave segreta (blipit_sk_) per i server e Odoo.
Chiavi API su app.blipit.io: la chiave pubblica (blipit_pk_) per il codice del browser e la chiave segreta (blipit_sk_) per i server e Odoo.
Una nuova chiave segreta viene mostrata una sola volta. Copiala subito: viene salvata come hash e non può essere mostrata di nuovo.
Una nuova chiave segreta viene mostrata una sola volta. Copiala subito: viene salvata come hash e non può essere mostrata di nuovo.

4Tieni la chiave nell'ambiente

Questo SDK invia con la chiave pubblica. Laravel: aggiungila a .env e a config/services.php; il service provider di Blipit viene rilevato da solo e avvia Blipit da quella configurazione, quindi non serve altro. Leggi i valori tramite config, perché env() non restituisce nulla nel codice dell'app una volta che la configurazione è in cache. PHP semplice: leggi la chiave con getenv() dall'ambiente del server.

.env
BLIPIT_KEY=blipit_pk_your_public_key
config/services.php
'blipit' => [
    'key' => env('BLIPIT_KEY'),
    'environment' => env('APP_ENV'),
    'release' => env('GIT_SHA'),
],

5Tieni le chiavi fuori da git

Tieni le chiavi in variabili d'ambiente o nelle impostazioni dei secret del tuo host, mai nel codice che fai commit, e aggiungi i tuoi file .env a .gitignore. Una chiave pubblica in una pagina web è normale. Se una chiave segreta finisce in git, in una pagina pubblica, in uno screenshot o in una chat, apri Chiavi API, premi Crea una nuova chiave segreta e incolla la nuova chiave ovunque usavi quella vecchia: la vecchia chiave smette di funzionare subito.

.gitignore
.env
.env.local
.env.*.local

6Laravel e Symfony

Laravel: ogni eccezione segnalata dal suo handler arriva a Blipit, così i 404 e gli errori di validazione restano fuori. Query, righe di log e chiamate del client HTTP diventano breadcrumb, e i job in coda vengono tracciati. Una riga Blipit::captureException che hai già in bootstrap/app.php può restare: la stessa eccezione non viene mai inviata due volte. Symfony: registra il listener in config/services.yaml e chiama Blipit::init presto in public/index.php e bin/console.

config/services.yaml
Blipit\Symfony\BlipitListener:
    arguments: ['@router']
    tags:
        - { name: kernel.event_listener, event: kernel.exception, method: onKernelException }
        - { name: kernel.event_listener, event: kernel.request, method: onKernelRequest }
        - { name: kernel.event_listener, event: kernel.terminate, method: onKernelTerminate }
        - { name: kernel.event_listener, event: console.error, method: onConsoleError }

7Cattura manuale e tentativi di accesso

I tentativi di accesso richiedono la chiave segreta: sul server inizializza con la chiave segreta invece di quella pubblica, altrimenti l'ingestione li rifiuta con 403 security_needs_secret_key. Piano Scale.

php
Blipit::captureException($e);
Blipit::captureMessage("cache miss rate above 50%", "warning");
Blipit::setUser(["id" => "42", "email" => "ana@example.com"]);
Blipit::captureSecurity("login_failed", $email, "bad_password", null, $request->ip(), $request->userAgent());

8Verifica che funzioni

Apri Issue in app.blipit.io. Il primo evento compare entro pochi secondi, raggruppato in una issue, e i responsabili ricevono un'email.

php
Blipit::captureMessage("Hello from PHP");

Buono a sapersi

  • Passa "traces_sample_rate" => 0.2 in init e le richieste compaiono nella pagina Pulse. Blipit::trace("import orders", fn () => $importer->run()) misura la durata di qualsiasi blocco dentro una richiesta o un job tracciati.
  • Aggiornamento dalla 0.2: project non serve più (è ancora accettato), Blipit::dsn() e Blipit::notice() non esistono più e before_send ora riceve e restituisce l'evento come array nel formato di Blipit.
  • Tenere Blipit aggiornato: la guida Tenere Blipit aggiornato (docs.blipit.io/updates) spiega il banner di aggiornamento, le email per le versioni importanti, l'avviso nella console di sviluppo e il comando di aggiornamento per questa piattaforma.
  • Un progetto per app e piattaforma: ogni progetto sceglie la sua piattaforma quando viene creato (Android, iOS, React Native, Flutter, Web, Backend o Odoo) e Blipit rifiuta con un errore chiaro i dati di qualsiasi altra piattaforma, quindi un'app iOS e un'app Android hanno bisogno di due progetti con due chiavi. Release, versioni, tassi di crash e build per gli store sono diversi per ogni piattaforma, e mescolarli in un progetto li rende tutti sbagliati. Un progetto Web accetta anche la parte server della stessa app web (il server Next.js o Node), e un progetto React Native o Flutter accetta anche i propri crash nativi Android e iOS.

Bloccato? Scrivi a support@blipit.io. Le chiavi e l'id di ogni progetto sono sotto Chiavi API in app.blipit.io.