دليل Laravel مع AllStak

أضف مراقبة تلقائية للأخطاء والطلبات والاستعلامات إلى تطبيق Laravel. يُكتشَف مزوّد الخدمة تلقائيًا — دون أي تغييرات في الشيفرة.

المستودع المصدر:
AllStak/allstak-php-sdk
مسار README:
README.md
إصدار الـ SDK:
1.4.0
مصدر التثبيت:
Packagist
آخر تحقّق:
2026-05-31

التثبيت

ثبّت عبر Composer.

composer require allstak/sdk-php

الإعداد

أضف مفتاح API إلى البيئة. واختياريًا انشر ملف الإعداد لتخصيص خيارات الالتقاط.

ALLSTAK_API_KEY=ask_live_xxx
ALLSTAK_ENVIRONMENT=production
[email protected]

# optional:
# php artisan vendor:publish --tag=allstak-config

مثال أساسي

بعد composer require ومفتاح API واحد، يصبح التطبيق مُجهّزًا بالكامل دون أي تغييرات في الشيفرة — إذ يُكتشَف مزوّد الخدمة تلقائيًا.

التقاط الأخطاء

تُلتقط الاستثناءات غير المُعالَجة تلقائيًا. والمُعالَجة التقطها عبر الـ Facade.

use AllStak\Facade;

Facade::captureError(new RuntimeException('checkout failed'));
Facade::captureLog('info', 'payment retry', ['orderId' => 'ord_123']);

تتبّع الطلبات

تُلتقط الطلبات الواردة عبر وسيط عام عندما تكون ALLSTAK_CAPTURE_REQUESTS مفعّلة، واستعلامات قاعدة البيانات عبر DB::listen عندما تكون ALLSTAK_CAPTURE_DB مفعّلة — كلاهما تلقائي دون نداء من المستخدم.

أفضل الممارسات

  • احتفظ بـ ALLSTAK_API_KEY في .env ولا تُودِعه أبدًا.
  • اضبط ALLSTAK_ENVIRONMENT ليبقى الاختبار والإنتاج منفصلين.
  • أبقِ ALLSTAK_CAPTURE_DB مفعّلًا لالتقاط استعلامات قاعدة البيانات البطيئة.
ابدأ مجاناً كل الأدلّة