Download the PHP package allturko/nabiz without Composer

On this page you can find all versions of the php package allturko/nabiz. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of allturko/nabiz

Informations about the package nabiz

allturko/nabiz

Laravel uygulamaları için Nabız izleme istemcisi. Exception'ları, yavaş istekleri ve yavaş SQL sorgularını kişisel veri toplamadan merkezî Nabız Hub'a raporlar.

Bu paket izlenen projelere kurulur. Hub'ın kendisi ayrı bir repodadır: nabiz-hub
Paket allturko/nabiz
Destek Laravel 11 · 12 · 13 · PHP 8.2+
Lisans MIT
Durum 🚧 Geliştirme aşamasında (Faz 2)

Kurulum

.env dosyasına:

Service provider Laravel'in paket keşfi ile otomatik yüklenir; elle kayıt gerekmez. Anahtar ve secret değerleri Nabız panelindeki Kurulum sekmesinden alınır.

Kurulumu doğrulayın

Bu adım atlanmamalı. Paketin en pahalı arıza biçimi sessiz çalışmamadır: secret eksik kopyalanmışsa hiçbir şey patlamaz, hiçbir log düşmez — hub geçersiz imzaya da 204 döner. Kurulum aylarca çalışmıyor olabilir ve bu sessizlik "sorun yok" sanılır.

Komut yerelde yanlış olan ne varsa gösterir: eksik değişken, hatalı secret uzunluğu, şifresiz hub adresi.

Verinin gerçekten ulaştığı yalnızca hub panelinden doğrulanır: proje satırındaki bağlantı durumu Bağlı görünmelidir. Komut bunu kendi başına söyleyemez, çünkü hub geçerli ile geçersiz imzayı dışarıya aynı yanıtla karşılar.

Ne toplar

Alan Örnek
kind exception · fatal · http_5xx · slow_request · slow_query · job_failed
msg, exception_class, stack, file, line Hata bilgisi (maskelemeden geçer)
route GET /api/products/{id} — desen, gerçek id değil
controller, method, status ProductController@show, GET, 500
duration_ms, memory_mb Performans
query_count SQL sorgu sayısı — N+1 tespiti
slowest_query_sql Normalize: select * from users where email = ?
release, php_version, framework_version Ortam

Ölümcül hatalar ayrı bir tür

Bellek tükenmesi, zaman aşımı ve derleme hataları PHP'de exception üretmez: süreç ölür, exception handler hiç çalışmaz. Yani siteyi gerçekten düşüren hata sınıfı, yalnızca hookExceptions() ile izlendiğinde tamamen görünmez kalıyordu — uptime probu 500'ü görür ama sebebini kimse bilmez.

register_shutdown_function ile yakalanıp fatal türüyle gönderilir. exception olarak gönderilmedi çünkü ikisi farklı şeyler: exception uygulamanın yakalayabildiği bir durum, fatal ise sunucunun sınırına çarpması — ve bu sınıfı ayrıca süzebilmek gerekiyor.

Bellek tükendiğinde raporlama kodunun kendisi de yer bulamaz; bu yüzden açılışta 256 KB'lık bir tampon ayrılıp shutdown anında serbest bırakılır. Tampon olmadan kanca yazılır ama tam ihtiyaç anında sessizce çalışmaz.

Yalnızca ölümcül türler (E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR, E_USER_ERROR) gönderilir. Uyarı ve bildirimler her istekte onlarca üretilebilir ve paneli boğardı.

Canlılık nabzı

Paket sekiz saatte bir hub'a olay taşımayan küçük bir istek gönderir.

Sebebi şu: hub bir kurulumun çalışıp çalışmadığını yalnızca gelen hatalardan anlıyordu. Sonuç ters dönüyordu — hatasız çalışan bir uygulama hiç olay göndermediği için "kurulum çalışmıyor olabilir" diye raporlanıyordu. Sağlıklı olmak cezalandırılıyordu.

Artık kanıt isteğin kendisi. Nabız geldiği sürece hub kurulumun ayakta olduğunu bilir; gelmediğinde söylediği şey gerçekten doğrudur.
Aralık 8 saat
Gövde {"events": []} — hiçbir ölçüm taşımaz
Uç Olayların gittiği uçla aynı, ek bir adres yok
Tetikleyen HTTP isteği (aşağıya bakın)

Aralık, hub'ın 24 saatlik sessizlik eşiğinin üçte biri. Eşitlenseydi tek bir kaçırılan istek — deploy, kısa bir kesinti — kurulumu bozuk gösterirdi.

Neden zamanlayıcıya bağlı değil

Nabız terminate() aşamasında, yani yanıt kullanıcıya gönderildikten sonra atılır. Süresi gelmemişse yalnızca bir önbellek okuması yapılır; kullanıcı hiçbir şey beklemez.

Laravel'in zamanlayıcısı kullanılmadı çünkü paket onlarca projeye kuruluyor ve hepsinde çalışan bir cron olduğu varsayılamaz. Zamanlayıcısı olmayan bir projede nabız hiç atmaz ve kurulum sessizce "bozuk" görünürdü — düzeltmeye çalıştığı hatanın aynısı.

İsteğe bağlamanın ikinci faydası: hub'ın kendi uptime probu da bir istektir. Hiç ziyaretçisi olmayan bir site bile prob sayesinde nabzını atmaya devam eder.

Önbellek anahtarı proje anahtarıyla ayrılır; aynı cache deposunu paylaşan iki uygulama birbirinin nabzını bastırmaz.

NABIZ_ENABLED=false iken ya da yapılandırma eksikken hiç gönderilmez.

Ne toplamaz

Bunlar tasarım kısıtıdır, yapılandırmayla açılamaz:

Kayıttan önce mesaj ve stack trace içindeki e-posta, TC kimlik no, telefon, IBAN ve kart numarası desenleri maskelenir.

Davranış garantileri

Paket, kurulduğu uygulamanın davranışını değiştirmez:

Yapılandırma

config/nabiz.php içinde:

Ayar Varsayılan Açıklama
slow_request_ms 1000 Bu süreyi aşan istekler slow_request olarak raporlanır
slow_query_ms 500 Bu süreyi aşan sorgular slow_query olarak raporlanır
capture_user_id false Açılırsa kimliği belirli kişiye bağlı veri toplanır
ignore [] Raporlanmayacak exception sınıfları
timeout 2 Hub'a bağlanma zaman aşımı (sn)

Güvenlik

Sunucudan sunucuya gönderim HMAC ile imzalanır:

NABIZ_SECRET yalnızca sunucuda bulunur. Tarayıcıya veya istemci tarafına asla konulmaz — tarayıcı hataları için ayrı, anahtar tabanlı t.js kullanılır.

Sürümleme

Semver. Hub'ın toplama ucu sözleşmesi geriye uyumlu tutulur: yeni alanlar eklenebilir, mevcut alanlar kaldırılmaz. Eski paket sürümleri çalışmaya devam eder.

Geliştirme

Yayınlama: git tag v1.x.x && git push --tags → Packagist webhook ile otomatik güncellenir.

All versions of nabiz with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
ext-curl Version *
illuminate/support Version ^11.0 || ^12.0 || ^13.0
illuminate/http Version ^11.0 || ^12.0 || ^13.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package allturko/nabiz contains the following files

Loading the files please wait ...