PHP ve Laravel

Kurulum composer require blipit/blipit

blipit/blipit paketini (0.3.0 veya daha yenisi) kurun ve projenizin public key'i ile init'i bir kez çağırın. Blipit'in kendi çekirdeği üzerinde çalışır ve başka hiçbir paket çekmez. Yakalanmamış istisnalar, uyarılar ve ölümcül hatalar kendiliğinden raporlanır; Laravel ve Symfony desteği yerleşiktir.

Claude Code, Cursor veya başka bir yapay zekâ kodlama asistanına yapıştırın. Adımları ve kodu içerir. app.blipit.io'da API anahtarları altında aynı istem, anahtarınız yazılmış olarak gelir.
Video: Blipit'i her stack'e kurun, 1:07 itibarıyla

1Kurulum

sh
composer require blipit/blipit

2Başlangıçta başlatın

Düz PHP: front controller'ınızın en üstünde, herhangi bir istek işlenmeden önce. Laravel, sonraki adımdaki gibi Blipit'i kendi config'inden başlatır. Anahtar, projenin Anahtarlar sayfasındadır. Anahtar boşsa init istisna fırlatmak yerine hata loguna bir uyarı yazar ve false döndürür.

php
use Blipit\Blipit;

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

3Anahtarlarınızı alın

app.blipit.io'da oturum açın ve kenar çubuğunda API anahtarları'nı, ardından projenizi açın. Her projenin iki anahtarı vardır. Public key blipit_pk_ ile başlar: tarayıcı ve uygulama koduna gider, yalnızca olay gönderebilir ve herkesin görmesi güvenlidir. Secret key blipit_sk_ ile başlar: sunucunuzda ya da Odoo'da kalır, asla tarayıcıda olmaz, çünkü sorunları okuyup değiştirebilir de. Secret key yalnızca bir kez, oluşturulduktan hemen sonra gösterilir, bu yüzden o anda kopyalayın; kaybederseniz Yeni bir secret key oluştur'a basın, eskisi hemen çalışmayı durdurur. Bazı SDK'lar ayrıca aynı sayfada gösterilen proje id'sine ihtiyaç duyar.

app.blipit.io'da API anahtarları: tarayıcı kodu için public key (blipit_pk_), sunucular ve Odoo için secret key (blipit_sk_).
app.blipit.io'da API anahtarları: tarayıcı kodu için public key (blipit_pk_), sunucular ve Odoo için secret key (blipit_sk_).
Yeni bir secret key yalnızca bir kez gösterilir. Şimdi kopyalayın: hash'lenmiş olarak saklanır ve bir daha gösterilemez.
Yeni bir secret key yalnızca bir kez gösterilir. Şimdi kopyalayın: hash'lenmiş olarak saklanır ve bir daha gösterilemez.

4Anahtarı ortam değişkenlerinde tutun

Bu SDK public key ile gönderir. Laravel: onu .env dosyasına ve config/services.php'ye ekleyin; Blipit service provider'ı kendiliğinden bulunur ve Blipit'i bu config'den başlatır, başka bir şey gerekmez. Değerleri config üzerinden okuyun, çünkü config önbelleğe alındıktan sonra env() uygulama kodunda hiçbir şey döndürmez. Düz PHP: anahtarı sunucunun ortamından getenv() ile okuyun.

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

5Anahtarları git'ten uzak tutun

Anahtarları ortam değişkenlerinde ya da barındırma ortamınızın gizli ayarlarında tutun, asla commit ettiğiniz kodda tutmayın ve .env dosyalarınızı .gitignore'a ekleyin. Bir web sayfasında public key bulunması normaldir. Bir secret key git'e, herkese açık bir sayfaya, bir ekran görüntüsüne ya da bir sohbete düşerse API anahtarları'nı açın, Yeni bir secret key oluştur'a basın ve yeni anahtarı eskisinin kullanıldığı her yere yapıştırın: eski anahtar hemen çalışmayı durdurur.

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

6Laravel ve Symfony

Laravel: handler'ının raporladığı her istisna Blipit'e ulaşır; böylece 404'ler ve doğrulama hataları dışarıda kalır. Sorgular, log satırları ve HTTP istemci çağrıları breadcrumb olur, kuyruğa alınan işler trace edilir. bootstrap/app.php'de zaten bulunan bir Blipit::captureException satırı kalabilir: aynı istisna asla iki kez gönderilmez. Symfony: listener'ı config/services.yaml içinde kaydedin ve Blipit::init'i public/index.php ile bin/console'da erkenden çağırın.

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 }

7Manuel yakalama ve giriş denemeleri

Giriş denemeleri gizli anahtar gerektirir: sunucuda genel anahtar yerine gizli anahtarla başlatın, aksi halde alım bunları 403 security_needs_secret_key ile reddeder. Scale planı.

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());

8Çalıştığını kontrol edin

app.blipit.io içinde Sorunlar'ı açın. İlk olay birkaç saniye içinde bir sorun altında gruplanmış olarak görünür ve sorumlu kişilere e-posta gider.

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

Bilmekte fayda var

  • init içinde "traces_sample_rate" => 0.2 geçirin; istekler Pulse sayfasında görünür. Blipit::trace("import orders", fn () => $importer->run()), trace edilen bir istek ya da iş içindeki herhangi bir bloğun süresini ölçer.
  • 0.2'den yükseltme: project artık gerekmez (hâlâ kabul edilir), Blipit::dsn() ve Blipit::notice() kaldırıldı ve before_send artık olayı Blipit'in biçiminde bir dizi olarak alır ve döndürür.
  • Blipit'i güncel tutmak: Blipit'i güncel tutmak rehberi (docs.blipit.io/updates) güncelleme afişini, önemli sürümler için e-postaları, geliştirme konsolunuzdaki bildirimi ve bu platformun güncelleme komutunu açıklar.
  • Her uygulama ve platform için bir proje: her proje oluşturulurken platformunu seçer (Android, iOS, React Native, Flutter, Web, Backend veya Odoo) ve Blipit başka bir platformdan gelen verileri açık bir hatayla reddeder. Yani bir iOS uygulaması ile bir Android uygulaması için iki anahtarlı iki proje gerekir. Sürümler, versiyonlar, çökme oranları ve mağaza derlemeleri her platformda farklıdır; bunları tek projede karıştırmak hepsini yanlış yapar. Web projesi aynı web uygulamasının sunucu tarafını da kabul eder (Next.js sunucusu veya Node), React Native veya Flutter projesi de kendi yerel Android ve iOS çökme raporlarını kabul eder.

Takıldınız mı? support@blipit.io adresine e-posta gönderin. Her projenin anahtarları ve proje id'si app.blipit.io içindeki API anahtarları altındadır.