clockwork
5.2
Clockwork هي أداة تطوير لـ PHP متاحة مباشرة في متصفحك. يمنحك Clockwork نظرة ثاقبة على وقت تشغيل التطبيق الخاص بك - بما في ذلك بيانات الطلب، ومقاييس الأداء، وإدخالات السجل، واستعلامات قاعدة البيانات، واستعلامات ذاكرة التخزين المؤقت، وأوامر redis، والأحداث المرسلة، والمهام الموضوعة في قائمة الانتظار، وطرق العرض المقدمة والمزيد - لطلبات HTTP والأوامر ووظائف قائمة الانتظار والاختبارات .
يحتوي هذا المستودع على مكون Clockwork من جانب الخادم.
تحقق من موقع Clockwork للحصول على التفاصيل.
قم بتثبيت مكتبة Clockwork عبر Composer.
composer require itsgoingd/clockwork
تهانينا، لقد انتهيت! لتمكين المزيد من الميزات مثل الأوامر أو ملفات تعريف مهام قائمة الانتظار، انشر ملف التكوين عبر أمر vendor:publish Artisan.
ملاحظة: إذا كنت تستخدم ذاكرة التخزين المؤقت لمسار Laravel، فستحتاج إلى تحديثها باستخدام الأمر Route:cache Artisan.
اقرأ تعليمات التثبيت الكاملة على موقع Clockwork.
يقوم مكون خادم Clockwork بجمع وتخزين البيانات حول تطبيقك.
يكون Clockwork نشطًا فقط عندما يكون تطبيقك في وضع التصحيح افتراضيًا. يمكنك اختيار تمكين Clockwork أو تعطيله بشكل صريح، أو حتى تعيين Clockwork لجمع البيانات دائمًا دون تعريضها لمزيد من التحليل.
نقوم بجمع مجموعة كاملة من البيانات المفيدة بشكل افتراضي، ولكن يمكنك تمكين المزيد من الميزات أو تعطيل الميزات التي لا تحتاج إليها في ملف التكوين.
قد تسمح بعض الميزات بخيارات متقدمة، على سبيل المثال. بالنسبة لاستعلامات قاعدة البيانات، يمكنك تعيين حد استعلام بطيء أو تمكين اكتشاف الاستعلامات المكررة (N+1). تحقق من ملف التكوين لترى كل ما يمكن أن يفعله Clockwork.
هناك العديد من الخيارات التي تسمح لك باختيار الطلبات التي يكون Clockwork نشطًا لها.
لن يقوم الوضع عند الطلب بجمع البيانات إلا عندما يكون تطبيق Clockwork مفتوحًا. يمكنك أيضًا تحديد سر ليتم تعيينه في إعدادات التطبيق لجمع الطلب. ستسجل الأخطاء فقط الطلبات التي تنتهي باستجابات 4xx و5xx فقط. البطيء فقط سيجمع فقط الطلبات ذات الاستجابات التي تتجاوز الحد البطيء المحدد. يمكنك أيضًا تصفية الطلبات المجمعة والمسجلة عن طريق إغلاق مخصص. لن يتم جمع طلبات CORS قبل الرحلة بشكل افتراضي.
الجديد في Clockwork 4.1، هو أنه يمكن الآن أيضًا جمع الأوامر الحرفية ومهام قائمة الانتظار والاختبارات، وتحتاج إلى تمكين ذلك في ملف التكوين.
تقوم Clockwork أيضًا بتجميع تتبعات المكدس للبيانات مثل رسائل السجل أو استعلامات قاعدة البيانات. يتم جمع الإطارات العشرة الأخيرة للتتبع بشكل افتراضي. يمكنك تغيير حدود الإطارات أو تعطيل هذه الميزة في ملف التكوين.
قم بزيارة طريق /clockwork لعرض البيانات المجمعة والتفاعل معها.
سيعرض التطبيق جميع الطلبات المنفذة، وهو أمر مفيد عندما لا يتم تقديم الطلب عن طريق المتصفح، ولكن على سبيل المثال تطبيق الهاتف المحمول الذي تقوم بتطوير واجهة برمجة التطبيقات (API) له.
يتوفر أيضًا ملحق أدوات تطوير المتصفح لمتصفح Chrome وFirefox:
يمنحك Clockwork الآن خيارًا لعرض معلومات الطلب الأساسية في شكل شريط أدوات في تطبيقك.
يتم عرض شريط الأدوات بالكامل من جانب العميل ويتطلب تثبيت مكتبة جافا سكريبت صغيرة.
تعرف على المزيد على موقع Clockwork.
يمكنك تسجيل أي متغير عبر مساعد Clock()، بدءًا من سلسلة بسيطة إلى مصفوفة أو كائن، وحتى قيم متعددة:
clock (User:: first (), auth ()-> user (), $ username ) تقوم الدالة المساعدة clock() بإرجاع وسيطها الأول، بحيث يمكنك بسهولة إضافة عبارات تصحيح الأخطاء المضمنة إلى التعليمات البرمجية الخاصة بك:
User:: create ( clock ( $ request -> all ()))إذا كنت تريد تحديد مستوى السجل، فيمكنك استخدام المكالمة الطويلة:
clock ()-> info ( " User { $ username } logged in! " )يمنحك الجدول الزمني تمثيلاً مرئيًا لوقت تشغيل التطبيق الخاص بك.
لإضافة حدث إلى المخطط الزمني - ابدأه بالوصف، وقم بتنفيذ التعليمات البرمجية المتعقبة، ثم قم بإنهاء الحدث. تتوفر واجهة برمجة التطبيقات بطلاقة لتكوين الحدث بشكل أكبر.
// using timeline api with begin / end and fluent configuration
clock ()-> event ( ' Importing tweets ' )-> color ( ' purple ' )-> begin ();
. . .
clock ()-> event ( ' Importing tweets ' )-> end ();وبدلاً من ذلك، يمكنك تنفيذ كتلة التعليمات البرمجية المتعقبة كإغلاق. يمكنك أيضًا اختيار استخدام التكوين القائم على المصفوفة بدلاً من واجهة برمجة التطبيقات بطلاقة.
// using timeline api with run and array - based configuration
clock ()-> event ( ' Updating cache ' , [ ' color ' => ' green ' ])-> run ( function () {
. . .
});اقرأ المزيد حول الميزات المتوفرة على موقع Clockwork.
