feip/php-cycdep-finder

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

Maintainers

Package info

gitlab.feip.co/public-php-packages/php-cycdep-finder.git

pkg:composer/feip/php-cycdep-finder

Statistics

Installs: 295

Dependents: 0

Suggesters: 0

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

This package is not auto-updated.

Last update: 2026-03-26 10:10:07 UTC


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.