php clean architecture

หากต้องการติดต่อเป็นภาษาอังกฤษไปที่ readme.en

PHP Clean Architecture

เครื่องมือสำหรับการควบคุมคุณภาพของแอพพลิเคชั่นที่เขียนบน PHP โดยอัตโนมัติรวมถึงการวิเคราะห์และการสร้างภาพของตัวชี้วัดที่ง่ายขึ้น

แนวคิดของการสร้างได้รับแรงบันดาลใจจากหนังสือ Pure Architecture (Robert Martin) หากคุณยังไม่ได้อ่านคุณสามารถทำความคุ้นเคยกับแนวคิดสำคัญของเครื่องมือที่ใช้เครื่องมือที่ใช้ https://habr.com/en/post/504590/

การติดตั้ง

composer require v.chetkov/php-clean-architecture --dev

การกำหนดค่า

ต่อไปเราคัดลอกตัวอย่างการกำหนดค่าไปยังรูทของโครงการ

cp vendor/v.chetkov/php-clean-architecture/example.phpca-config.php phpca-config.php

รายละเอียดทั้งหมดของการกำหนดค่ามีการอธิบายในรายละเอียดในตัวอย่างของ config https://github.com/chetkov/php-clean- สถาปัตยกรรม/blob/master/example.phpca-config.php เช่นเดียวกับในบทความ https://habr.com/en/post/504590/

การใช้งาน

1. การก่อตัวของรายงานเพื่อการวิเคราะห์

vendor/bin/phpca-build-reports { ? path/to/phpca-config.php}

รายงานแสดงให้เห็นถึงสถานะปัจจุบันของโครงการแสดงความสัมพันธ์ระหว่างส่วนประกอบความแข็งแกร่งการลบส่วนประกอบออกจากลำดับหลักอย่างชัดเจนและยังเน้นการพึ่งพาที่ไม่พึงประสงค์และปัญหาทางสถาปัตยกรรมอื่น ๆ ที่ตรวจพบบนพื้นฐานของการกำหนดค่า

2. ตรวจสอบ CI

vendor/bin/phpca-check { ? path/to/phpca-config.php}

ในกรณีที่มีการละเมิดตามหลักจรรยาบรรณที่กำหนดโดยการกำหนดค่าจะแจ้งให้ทราบถึงปัญหาที่ค้นพบและเสร็จสิ้นการดำเนินการกับข้อผิดพลาด ขอแนะนำให้เพิ่มการเปิดตัวคำสั่งนี้ใน CI (นี่รับประกันการปฏิบัติตามรหัสที่เข้าสู่แอสเซมบลี

3. อนุญาตให้รัฐ

vendor/bin/phpca-allow-current-state { ? path/to/phpca-config.php}

ทีมจะรักษาสถานะปัจจุบันของโครงการความสัมพันธ์ระหว่างคลาสที่มีอยู่เป็นไฟล์แยกต่างหาก ด้วยการเปิดตัว PHPCA ในภายหลังปัญหาที่เกี่ยวข้องกับสถานะที่เก็บรักษาไว้จะถูกละเว้น

สิ่งนี้ทำให้สามารถเชื่อมต่อสถาปัตยกรรม PHP-XLean ได้อย่างง่ายดายไม่เพียง แต่กับโครงการใหม่ แต่ยังรวมถึงที่มีอยู่และมีปัญหาอยู่แล้วการกำจัดซึ่งต้องใช้เวลา

4. รายงาน/ตรวจสอบตามรายการไฟล์

หากคุณต้องการตรวจสอบการมีปัญหาหรือสร้างกราฟการพึ่งพาและดำเนินการวิเคราะห์ไม่ได้ในโครงการทั้งหมด แต่โดยบางส่วนของมัน (ตัวอย่างเช่นตามรายการไฟล์ที่เปลี่ยนแปลง) คุณสามารถตั้งค่าของตัวแปรสภาพแวดล้อม phpca_allowed_paths :

 export PHPCA_ALLOWED_PATHS= ` git diff master --name-only ` PHPCA_REPORTS_DIR= ' phpca-report ' ; vendor/bin/phpca-build-reports { ? path/to/phpca-config.php}