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