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.