feip/php-cycdep-finder

Package to find cyclic dependencies in classes, files, directories and packages in PHP projects

v1.5.1 2026-02-12 09:27 UTC

Requires

• php: >=8.2
• nikic/php-parser: ^5.0

Requires (Dev)

• phpunit/phpunit: ^11.1

MIT

• Patr1arch

README

Requirements

• PHP >=8.2
• Composer v2

Installation

composer require --dev feip/php-cycdep-finder

Usage

vendor/bin/cycdep <directories, .php or composer.json files> [options]

Options:

• -q — quiet mode (no output)
• -vv — verbose: show PHP ASTs and dependency tree
• --ignore-namespace=<pattern> — ignore cycles where all members match the pattern (can be repeated)

Examples

# Check the app/ directory
vendor/bin/cycdep app/

# Ignore Model <-> Factory mutual dependencies
vendor/bin/cycdep app/ --ignore-namespace=Models --ignore-namespace=Factories

Self-references (a class referencing itself, e.g. recursive tree DTOs) are automatically excluded and do not require --ignore-namespace.