PHPackages                             qualimetrix/qualimetrix - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI & Console](/categories/cli)
4. /
5. qualimetrix/qualimetrix

ActiveLibrary[CLI & Console](/categories/cli)

qualimetrix/qualimetrix
=======================

CLI tool for static analysis of PHP code - detects architectural mess and complexity issues

v0.19.0(1mo ago)124LicenseRef-Polyform-Shield-1.0.0PHPPHP ^8.4CI passing

Since Mar 4Pushed 1mo agoCompare

[ Source](https://github.com/qualimetrix/qualimetrix)[ Packagist](https://packagist.org/packages/qualimetrix/qualimetrix)[ Docs](https://github.com/qualimetrix/qualimetrix)[ RSS](/packages/qualimetrix-qualimetrix/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (10)Dependencies (16)Versions (32)Used By (0)

Qualimetrix
===========

[](#qualimetrix)

Static analysis tool for PHP code quality metrics.

**[Documentation](https://qualimetrix.dev/)** | [Quick Start](https://qualimetrix.dev/getting-started/quick-start/) | [llms.txt](https://qualimetrix.dev/llms.txt)

Features
--------

[](#features)

- **Complexity Metrics**: Cyclomatic (CCN), Cognitive, NPATH
- **Maintainability**: Halstead metrics, Maintainability Index
- **Coupling**: RFC, Instability, Abstractness, Distance from Main Sequence
- **Cohesion**: TCC/LCC, LCOM4, WMC
- **Size**: LOC, Class/Method/Property Count
- **Structure**: DIT, NOC
- **Architecture**: Circular Dependency Detection, Layer Policy Enforcement

Quick Start
-----------

[](#quick-start)

```
# Install
composer require --dev qualimetrix/qualimetrix

# Analyze
bin/qmx check src/

# With specific format
bin/qmx check src/ --format=json

# Pre-commit hook
bin/qmx hook:install
```

Output Formats
--------------

[](#output-formats)

FormatUse Case`text`CLI, human-readable`json`CI/CD integration`checkstyle`Jenkins, SonarQube`sarif`GitHub Security, VS Code`gitlab`GitLab Code QualityConfiguration
-------------

[](#configuration)

Create `qmx.yaml` ([full format](https://qualimetrix.dev/getting-started/configuration/)):

```
rules:
  complexity.cyclomatic:
    method:
      warning: 15
      error: 25
```

Or use CLI options:

```
bin/qmx check src/ --cyclomatic-warning=15 --cyclomatic-error=25
```

Git Integration
---------------

[](#git-integration)

```
# Show violations in staged files only
bin/qmx check src/ --report=git:staged

# Show violations in changed files
bin/qmx check src/ --report=git:main..HEAD
```

Baseline Support
----------------

[](#baseline-support)

```
# Generate baseline for existing violations
bin/qmx check src/ --generate-baseline=baseline.json

# Use baseline
bin/qmx check src/ --baseline=baseline.json
```

Documentation
-------------

[](#documentation)

- [Quick Start](https://qualimetrix.dev/getting-started/quick-start/)
- [Architecture](docs/ARCHITECTURE.md)
- [GitHub Action](https://qualimetrix.dev/ci-cd/github-actions/)
- [Changelog](CHANGELOG.md)
- [llms.txt](https://qualimetrix.dev/llms.txt) — concise reference for AI agents
- [llms-full.txt](https://qualimetrix.dev/llms-full.txt) — complete documentation in a single file

Requirements
------------

[](#requirements)

- PHP 8.4+
- Composer

Development
-----------

[](#development)

```
composer install
composer test      # Run tests
composer phpstan   # Static analysis
composer check     # Full validation
```

License
-------

[](#license)

MIT

###  Health Score

43

—

FairBetter than 90% of packages

Maintenance92

Actively maintained with recent releases

Popularity11

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 95.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~2 days

Recently: every ~10 days

Total

27

Last Release

38d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/318489?v=4)[Vladislav Rastrusny](/maintainers/FractalizeR)[@FractalizeR](https://github.com/FractalizeR)

---

Top Contributors

[![claude](https://avatars.githubusercontent.com/u/81847?v=4)](https://github.com/claude "claude (22 commits)")[![FractalizeR](https://avatars.githubusercontent.com/u/318489?v=4)](https://github.com/FractalizeR "FractalizeR (1 commits)")

---

Tags

phpclistatic analysismess detectorMetricscode qualityarchitecturecomplexity

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/qualimetrix-qualimetrix/health.svg)

```
[![Health](https://phpackages.com/badges/qualimetrix-qualimetrix/health.svg)](https://phpackages.com/packages/qualimetrix-qualimetrix)
```

###  Alternatives

[jolicode/castor

A lightweight and modern task runner. Automate everything. In PHP.

54642.4k4](/packages/jolicode-castor)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M196](/packages/sulu-sulu)[aeliot/todo-registrar

Register TODOs from source code in issue tracker

153.0k](/packages/aeliot-todo-registrar)[typo3/cms

TYPO3 CMS is a free open source Content Management Framework initially created by Kasper Skaarhoj and licensed under GNU/GPL.

1.2k1.9M122](/packages/typo3-cms)[contao/core-bundle

Contao Open Source CMS

1231.6M2.7k](/packages/contao-core-bundle)[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

101466.4k45](/packages/friendsoftypo3-content-blocks)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)