CaptainHook هي مكتبة git Hook سهلة الاستخدام ومرنة للغاية لمطوري PHP. فهو يمكّنك من تكوين إجراءات git Hook الخاصة بك في ملف json بسيط.
يمكنك استخدام CaptainHook للتحقق من صحة رسائل الالتزام أو إعدادها، أو التأكد من جودة التعليمات البرمجية أو تشغيل اختبارات الوحدة قبل الالتزام أو دفع التغييرات إلى git. يمكنك مسح ذاكرة التخزين المؤقت المحلية تلقائيًا أو تثبيت أحدث تبعيات الملحن بعد سحب أحدث التغييرات.
يجعل CaptainHook من السهل مشاركة الخطافات داخل فريقك ويمكنه أيضًا التأكد من قيام كل فرد في فريقك بتنشيط الخطافات محليًا.
يمكنك تشغيل أوامر cli، أو استخدام بعض أدوات التحقق المضمنة، أو كتابة فئات PHP الخاصة بك والتي يتم تنفيذها بواسطة CaptainHook . لمزيد من المعلومات قم بإلقاء نظرة على الوثائق.
الطريقة المفضلة لتثبيت CaptainHook هي تثبيت ملف PHAR. يمكنك القيام بذلك عن طريق استخدام Phive أو تنزيل PHAR من صفحة إصدار GitHub.
phive تثبيت الكابتن هوك
أو استخدم Composer لتثبيته.
يتطلب الملحن --dev Captainhook/captainhook-phar
إذا كنت ترغب في الحصول على الكود المصدري بكل تبعياته، يمكنك استخدام:
يتطلب الملحن --dev Captainhook/captainhook
بعد تثبيت CaptainHook، يمكنك استخدام Captainhook القابل للتنفيذ لإنشاء التكوين.
تكوين البائع/بن/الكابتن هوك
بعد إنشاء ملف التكوين Captainhook.json، يجب عليك تنشيط الخطافات عن طريق تثبيتها في دليل .git المحلي لديك. للقيام بذلك، فقط قم بتشغيل أمر CaptainHook التالي.
تثبيت البائع/بن/الكابتن هوك
ألق نظرة على فيديو التثبيت القصير هذا.
أحد أهداف CaptainHook هو تسهيل استخدام الفريق لنفس خطافات git. إذا كنت تريد التأكد من قيام الجميع بتثبيت الخطافات بالفعل، فيمكنك استخدام hook-installer
الصغيرة الخاصة ببرنامج Composer . يقوم بتشغيل أمر captainhook install
في كل مرة تقوم فيها بتشغيل أمر Composer .
يتطلب الملحن --dev Captainhook/hook-installer
لا يزال بإمكان زملاء الفريق خارج المسار الالتزام دون تنفيذ الخطافات، ولهذا السبب يجب عليك إجراء عمليات التحقق المناسبة على الواجهة الخلفية أيضًا. ولكن على الأقل بهذه الطريقة لا يمكن لأحد أن ينسى تثبيتها "عن طريق الصدفة".
فيما يلي مثال لملف التكوين Captainhook.json .
{ "commit-msg": {"ممكّن": صحيح،"إجراءات": [ {"action": "CaptainHookAppHookMessageActionBeams" } ] }، "الالتزام المسبق": {"ممكّن": صحيح،"الإجراءات": [ {"إجراء": "phpunit" }, {"action": "phpcs --standard=psr2 src" } ] }، "الدفع المسبق": {"ممكّن": خطأ،"الإجراءات": [] } }
هل ترغب في المساهمة في مكتبة CaptainHook
؟ ممتاز! شكراً جزيلاً. يمكنني بالتأكيد استخدام مساعدتكم.
قم بإلقاء نظرة على إرشادات المساهمة.