smmccabe/phpdebt

A technical debt calculator for PHP

phpdebt

PHP Technical Debt Calculator, _(*1)

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., _(*2)

Currently works primarly against Drupal, _(*3)

Installation

wget https://github.com/smmccabe/phpdebt/releases/download/1.0.2/phpdebt.phar
chmod +x phpdebt.phar
sudo mv phpdebt.phar /usr/local/bin/phpdebt

Usage and Examples

Against a whole project, _(*4)

phpdebt .

Against a specific folder, _(*5)

phpdebt src/

Against a specific file, _(*6)

phpdebt src/MyClass.php

Against wildcards, _(*7)

phpdebt src/*.inc

Sample output, _(*8)

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

Score Guidelines

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., _(*9)

Fixing Found Faults

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., _(*10)

Bugs or Issues

Please post any bugs, issues or support requests to the github issue board, _(*11)