Deptrac هي أداة تحليل تعليمات برمجية ثابتة لـ PHP تساعدك على التواصل وتصور وتنفيذ القرارات المعمارية في مشاريعك. يمكنك تحديد طبقاتك المعمارية بحرية عبر الفئات والقواعد التي يجب أن تنطبق عليها.
على سبيل المثال، يمكنك استخدام Deptrac للتأكد من أن الحزم/الوحدات/الامتدادات في مشروعك مستقلة تمامًا عن بعضها البعض لتسهيل إعادة استخدامها.
يمكن استخدام Deptrac في مسار CI للتأكد من أن طلب السحب لا ينتهك أيًا من القواعد المعمارية التي حددتها. باستخدام منسق Graphviz أو Mermaidjs الاختياري، يمكنك تصور الطبقات والقواعد والانتهاكات.
يمكنك العثور على الوثائق في دليل /docs أو زيارة صفحة المستند: https://qossmic.github.io/deptrac
يمكنك تثبيت Deptrac عبر Composer. نوصي باستخدام حزمة deptrac لهذا:
composer require --dev qossmic/deptrac
بمجرد قيامك بتنزيل/تثبيت deptrac، ستحتاج إلى إنشاء ملف تكوين، حيث يمكنك تحديد الطبقات ومجموعة قواعد الاتصال الخاصة بك. ملف التكوين هذا مكتوب بلغة YAML أو php، ويتم تخزينه افتراضيًا بالاسم deptrac.yaml
في الدليل الجذر لمشروعك.
بإمكان Deptrac إنشاء قالب لك باستخدام أمر init
.
vendor/bin/deptrac init
عندما يكون لديك هذا الملف، يمكنك تحليل التعليمات البرمجية الخاصة بك عن طريق تشغيل أمر analyse
:
vendor/bin/deptrac
# which is equivalent to
vendor/bin/deptrac analyse --config-file=deptrac.yaml
لكي تتمكن من تشغيل Deptrac، فإنك تحتاج إلى PHP 8.1 على الأقل.
يمكنك تحليل المشاريع التي تتطلب إصدار PHP أقدم طالما أن nikic/php-parser يمكنه تحليله.
راجع دليل المساهمة أو انتقل إلى مستودع التطوير qossmic/deptrac-src.