PHP Technical Debt Calculator

It scans through your code looking for any faults based on a number of standards from existing code analysis tools, it totals up the number of faults it finds and compares them against the total lines of functional code (comments and whitespace are excluded) and gives a quality score.

Currently works primarly against Drupal

composer global require smmccabe/phpdebt

Git

You will need to manually install the below requirements if you don't wish to use composer.

git clone https://github.com/smmccabe/phpdebt.git
cd phpdebt
./phpdebt

• bc
• phpmd
• phpcs
• coder

Against a whole project

phpdebt .

Against a specific folder

phpdebt src/

Against a specific file

phpdebt src/MyClass.php

Against wildcards

phpdebt src/*.inc

Sample output

phpdebt .
phpmd cleancode: 145
phpmd codesize: 19
phpmd design: 2
phpmd naming: 35
phpmd unusedcode: 43
phpcs Drupal: 39
phpcs DrupalPractice: 69
Total Faults: 352
Total Lines: 10568
Quality Score: 3 faults per 100 lines

Faults per 100 lines:

• < 2 - Excellent Code
• < 6 - Good Code
• < 10 - Decent Code
• < 25 - Needs work, cleanup should be prioritized of most feature work
• >= 25 Needs significant work, cleanup should be prioritized over any feature work or bugfixes.

phpdebt does not currently provide a verbose mode, to identify and fix specific faults, it is recommended to run tools such as phpmd and phpcs directly, see the phpdebt script if you wish to replicate what phpdebt is running. A verbose mode will be added in the future.

Please post any bugs, issues or support requests to the github issue board