amoifr13/phpquality repository overview

⁠PhpQuality - PHP Static Code Analyzer

Author: Pascal CESCON⁠ GitHub: Amoifr/PhpQuality⁠

⁠Features

⁠Code Metrics

• LOC - Lines of Code (total, comments, logical)
• CCN - McCabe Cyclomatic Complexity per method
• MI - Maintainability Index (0-100)
• LCOM - Lack of Cohesion of Methods (0-1)
• Halstead - Volume, Difficulty, Effort, Estimated Bugs

⁠Architecture Analysis

• Layer Detection - Auto-detect architectural layers (Controller, Application, Domain, Infrastructure)
• Layer Violations - Detect forbidden dependencies (Clean Architecture)
• SOLID Violations - SRP, ISP, DIP detection
• Circular Dependencies - Tarjan's algorithm detection
• Dependency Graph - Interactive D3.js visualization

⁠HTML Reports

Beautiful multi-page HTML reports with:

• Dashboard with metric distributions
• Detailed pages for each metric
• Interactive charts (Chart.js)
• Dependency graph (D3.js)
• Dark/Light theme support
• 30+ languages supported

⁠Quick Start

# Basic analysis with auto-detection
docker run --rm \
  -v $(pwd):/project \
  -v $(pwd)/reports:/reports \
  amoifr13/phpquality \
  analyze --source=/project/src --report-html=/reports

# Specify project type (symfony, laravel, wordpress, etc.)
docker run --rm \
  -v $(pwd):/project \
  -v $(pwd)/reports:/reports \
  amoifr13/phpquality \
  analyze --source=/project/src --type=symfony --report-html=/reports

# Enable git blame for Hall of Fame/Shame
docker run --rm \
  -v $(pwd):/project \
  -v $(pwd)/reports:/reports \
  amoifr13/phpquality \
  analyze --source=/project/src --report-html=/reports --git-blame

⁠Options

⁠Supported Project Types

• PHP (Generic)
• Symfony
• Laravel
• PrestaShop
• Magento 2
• WordPress
• WooCommerce
• Drupal
• Joomla
• TYPO3
• Sulu CMS
• Sylius
• CodeIgniter
• CakePHP

⁠Stack

• PHP 8.3 (Alpine)
• Symfony 7.x
• nikic/php-parser
• Twig + Chart.js + D3.js

⁠License

MIT