NCA Social Media
Erstellt:
Aktualisiert:
Autor:
Roland Golla
Grünes Maßband misst Code Türme, KI Agent liest Balken, Flagge PDepend

Was ist PDepend?

PDepend ist ein Open Source Tool, das PHP Code vermisst und daraus Software Metriken berechnet. Es zeigt in Zahlen, wie komplex, wie gekoppelt und wie wartbar ein Projekt ist.
PDepend ist die PHP Version des Java Tools JDepend. Es liest euren Code ein, baut einen Abstract Syntax Tree und misst Größe, Komplexität, Abhängigkeiten und Vererbung. Viele andere Tools bauen darauf auf, allen voran der PHP Mess Detector. Mit Version 3 parst PDepend parallel auf allen Kernen, liest Konfiguration als YAML und versteht die neue Syntax von PHP 8.4 und 8.5.
Inhalt
NCA KI Workshop für Developer

Agentic Coding im Team, nicht nur im Glossar

Ein Tag inhouse mit Benjamin Klein für Developer, Tester und Admins. Context Engineering, Harness, ADRs und zwei Hands on Blöcke mit KI Agenten in eurem Setup.

  1. 1
    Kostenloses Vorgespräch
    Stand, Rollen und Ziele klären
  2. 2
    Workshoptag bei euch
    Praxis am Vormittag, Hands on danach
  3. 3
    Praxistag optional
    Agenten im eigenen Projekt
Benjamin Klein
Benjamin Klein
Senior Consultant
Zum Workshop für Developer arrow_forward

PDepend mit NCA richtig einordnen

Never Code Alone arbeitet seit über 20 Jahren mit PHP, Testing und Refactoring. Für die tägliche statische Analyse setzen wir auf PHPStan und Psalm. PDepend nutzen wir nicht produktiv. Wir kennen es aber als Motor hinter PHPMD und als Werkzeug, um ein fremdes Projekt in Zahlen zu verstehen. Unser Weg bleibt gleich: erst Quality Gates, dann KI und dann aufräumen.
Wenn ihr ein gewachsenes Projekt vermessen und Prioritäten für das Refactoring setzen wollt, helfen wir mit PHP Consulting für Qualität und Legacy Code. Dazu passen der PHP Mess Detector für Regeln auf Basis der Metriken, PHPStan für Typfehler, Deptrac für saubere Schichten und Characterization Tests, bevor ihr alten Code anfasst.

So vermisst PDepend euren Code

PDepend arbeitet in zwei Schritten. Zuerst parst es alle Dateien und baut daraus ein Modell eures Projekts mit Paketen, Klassen, Methoden und Funktionen. Dann laufen Analyzer über dieses Modell. Jeder Analyzer berechnet eine Gruppe von Metriken.
  • Größe: Zeilen Code, Zeilen ohne Kommentare, Anzahl der Klassen und Methoden
  • Komplexität: zyklomatische Komplexität und NPath Komplexität je Methode
  • Kopplung: wie viele andere Klassen eine Klasse nutzt und wie viele sie nutzen
  • Vererbung: Tiefe der Vererbung und Zahl der Kindklassen
  • Pakete: Abstraktion, Instabilität und Abstand zur Hauptlinie nach Robert C. Martin
Die Ergebnisse gibt PDepend als XML Report aus. Dazu kommen zwei Grafiken. Das JDepend Chart zeigt, wie stabil und abstrakt eure Pakete sind. Die Overview Pyramid fasst Größe, Komplexität und Kopplung auf einen Blick zusammen.

Die wichtigsten PDepend Metriken

Metrik Was sie misst Worauf ihr achtet
ccn und ccn2 Zyklomatische Komplexität, also die Zahl der Wege durch eine Methode Hohe Werte heißen viele Testfälle und schwer lesbare Logik
npath Zahl der möglichen Ausführungspfade einer Methode Wächst schnell bei verschachtelten Bedingungen
loc, ncloc, eloc Zeilen Code gesamt, ohne Kommentare und ausführbar Sehr lange Methoden und Klassen sind Kandidaten fürs Aufteilen
wmc Summe der Komplexität aller Methoden einer Klasse Zeigt Klassen, die zu viel auf einmal tun
maxDIT Maximale Tiefe der Vererbung Tiefe Hierarchien machen Änderungen riskant
fanout und cr Abhängigkeiten nach außen und CodeRank als Gewicht im Netz Stark gekoppelte Klassen brechen bei Änderungen zuerst

Das ist neu in PDepend 3

PDepend 3 ist ein großer Umbau. Die Mindestversion springt auf PHP 8.1, und ihr braucht einen 64 Bit Build von PHP. Alte PHP Versionen von 5.3 bis 7.4 werden nicht mehr unterstützt. Dafür wird das Tool deutlich schneller und versteht moderne Syntax.
  • Paralleles Parsen: Standardmäßig startet PDepend einen Worker pro CPU Kern. Mit --threads steuert ihr die Zahl, mit --threads=1 läuft alles in einem Prozess wie früher
  • YAML Konfiguration: PDepend sucht zuerst nach pdepend.yml, pdepend.yml.dist und pdepend.php, erst danach nach pdepend.xml
  • Assistent: --generate-configuration legt per kurzem Dialog eine pdepend.yml an
  • Migration: --migrate-configuration wandelt eine alte pdepend.xml in YAML um
  • PHP 8.4: Property Hooks, asymmetrische Sichtbarkeit und new ohne Klammern
  • PHP 8.5: der neue Pipe Operator
  • Attribute: erscheinen jetzt als eigene Knoten im Syntaxbaum
Auch der Cache ist umgezogen. Er liegt jetzt im Cache Ordner nach XDG Standard, meist unter ~/.cache/pdepend. Wer eigene Skripte auf den alten Pfad gebaut hat, muss sie anpassen. Die wirkungslose Option --optimization ist entfallen.

PDepend 2 und PDepend 3 im Vergleich

Thema PDepend 2 PDepend 3
PHP Version auch sehr alte Versionen ab 5.3 ab PHP 8.1, nur 64 Bit
Parsen ein Prozess parallel, ein Worker pro CPU Kern
Konfiguration pdepend.xml pdepend.yml, pdepend.php oder weiter XML
Neue Konfiguration von Hand schreiben --generate-configuration
Neueste Syntax bis PHP 8.x mit Lücken PHP 8.4 Property Hooks und PHP 8.5 Pipe Operator
Cache eigener Pfad XDG Cache Ordner, Treiber immer file
Eigene Erweiterungen viele geschützte Methoden offen neue Typen, Parser versiegelt, Visitor umgebaut

PDepend installieren und Reports erzeugen

PDepend installiert ihr per Composer als Dev Abhängigkeit. Habt ihr schon PHPMD 3 im Projekt, ist PDepend 3 bereits als Abhängigkeit dabei.
Code:
          

composer require --dev pdepend/pdepend

Ein Aufruf erzeugt alle drei Reports auf einmal. Am Ende steht der Ordner, den PDepend vermessen soll.
Code:
          

vendor/bin/pdepend \
  --summary-xml=build/pdepend/summary.xml \
  --jdepend-chart=build/pdepend/jdepend.svg \
  --overview-pyramid=build/pdepend/pyramid.svg \
  src

Die summary.xml enthält jede Metrik je Datei, Klasse und Methode. Sie eignet sich für eigene Auswertungen und Dashboards. Die beiden SVG Dateien sind für Menschen gedacht. Legt sie als Artefakt in der Pipeline ab, dann kann jeder im Team sie öffnen.
Wer lieber eine Konfiguration pflegt, startet den Assistenten. Eine alte XML Datei wandelt die Migration um. Die Migration läuft laut Release Notes nur, solange Symfony 7 oder älter installiert ist.
Code:
          

vendor/bin/pdepend --generate-configuration
vendor/bin/pdepend --migrate-configuration

PDepend in Legacy Projekten und für Coding Agents nutzen

In einem fremden oder alten Projekt ist PDepend ein guter erster Blick. Ihr seht in Minuten, welche Klassen am komplexesten sind und welche am stärksten mit dem Rest verwoben sind. Genau dort lohnt sich Refactoring zuerst. Und genau dort braucht ihr vorher Tests.
Unsere Reihenfolge für Legacy Code: erst sichern Characterization Tests das Verhalten ab, dann zeigen die Metriken die Hotspots, dann wird in kleinen Schritten umgebaut. Bei großen Umbauten hilft das Strangler Fig Pattern.
Auch Coding Agents profitieren von den Zahlen. Ein Agent sieht nur die Dateien, die er gerade liest. Die Metriken aus PDepend geben ihm eine Karte des ganzen Projekts. Er kann gezielt die komplexen Stellen angehen, und ihr könnt nach jeder Änderung messen, ob die Komplexität gesunken ist. Als festes Gate in der Pipeline nutzt ihr dafür PHPMD, das die Werte von PDepend mit Grenzwerten prüft.

PDepend im Vergleich mit anderen PHP Analyse Tools

Tool Rolle Ergebnis
PDepend misst den Code Metriken als XML, JDepend Chart und Overview Pyramid
PHPMD bewertet die Metriken mit Regeln Liste von Verstößen, nutzbar als Gate in der CI
PHP Metrics zeigt Risiken im ganzen Projekt HTML Report mit Hotspots und Diagrammen
Deptrac prüft erlaubte Abhängigkeiten zwischen Schichten Verstöße gegen eure Architektur Regeln
PHPStan sucht Fehler im Code Typfehler, falsche Aufrufe, fehlende Methoden

PHP_Depend is an adaptation of the established Java development tool JDepend.

PDepend Projekt – README auf GitHub

Wann sich PDepend für euer Team lohnt

PDepend lohnt sich, wenn ihr ein Projekt verstehen wollt, bevor ihr es umbaut. Die Zahlen ersetzen kein Code Review. Sie zeigen aber schnell, wo ihr hinschauen solltet, und sie machen Fortschritt beim Refactoring messbar.
Gut passt PDepend für Audits von fremdem Code, Legacy Projekte vor einem Umbau und Teams, die ihre Architektur über die Zeit beobachten wollen. Weniger passt es als alleiniges Gate in der Pipeline. Dafür sind PHPMD mit klaren Grenzwerten und PHP Metrics mit seinem lesbaren HTML Report die besseren Werkzeuge.
Wer die Architektur zusätzlich mit festen Regeln absichern will, findet in phpat und PHP Arkitect passende Werkzeuge. Wie gut eure Tests den Code abdecken, zeigt Code Coverage.
CYPRESS.IO Ambassador und IT Consultant für QA Engenieering und Qualität in PHP Projekten.
Erreichen Sie unsere PHP Consultant Spezialisten

Wir arbeiten seit über 20 Jahren mit PHP und Symfony. Wir helfen bei PHP Updates und PHP Refactoring und beraten remote zu allen Fragen rund um PHP. Zuerst sichern Tests und statische Analyse den Code ab, dann räumen wir auf. Automatische CI/CD Deployments und eine stabile Docker Umgebung sorgen dafür, dass jede Änderung sicher live geht.

Häufige Fragen zu PDepend

Die wichtigsten Antworten rund um PDepend, die Metriken und das Update auf Version 3.
Wird PDepend 2026 noch weiterentwickelt?

Ja. PDepend wird aktiv gepflegt und hat mit Version 3 einen großen Umbau bekommen. Das Tool parst jetzt parallel, liest YAML Konfiguration und versteht die Syntax von PHP 8.4 und 8.5. Das Maintainer Team betreut zugleich PHPMD, und beide Projekte sind gemeinsam auf Version 3 gegangen.

Welche PHP Version braucht PDepend 3 im Jahr 2026?

PDepend 3 braucht mindestens PHP 8.1 und einen 64 Bit Build von PHP. Das gilt für die Umgebung, in der das Tool läuft. Analysieren kann es auch älteren Code. Läuft eure Pipeline noch mit älterem PHP, bleibt euch nur Version 2, bis ihr das Image anhebt.

Was bringt das parallele Parsen in PDepend 3 im Jahr 2026?

PDepend startet standardmäßig einen Worker pro CPU Kern und verteilt die Dateien darauf. Gerade in großen Projekten läuft die Analyse dadurch deutlich schneller. Mit --threads legt ihr die Zahl der Worker selbst fest. Mit --threads=1 parst PDepend wie früher in einem einzigen Prozess.

Muss ich im Jahr 2026 meine pdepend.xml umstellen?

Nein, PDepend 3 liest XML weiter. Es sucht aber zuerst nach pdepend.yml, pdepend.yml.dist und pdepend.php. Mit --migrate-configuration wandelt ihr eine alte Datei in YAML um, solange Symfony 7 oder älter installiert ist. Ohne alte Datei legt --generate-configuration eine neue an.

Brauche ich PDepend 2026 noch, wenn ich PHPMD nutze?

PHPMD bringt PDepend als Abhängigkeit mit und nutzt seine Metriken. Für Regeln und Gates in der Pipeline reicht PHPMD allein. PDepend direkt aufzurufen lohnt sich, wenn ihr die rohen Zahlen, das JDepend Chart oder die Overview Pyramid sehen wollt, etwa für ein Audit oder für eigene Auswertungen.

Wie installiere ich PDepend?

Am einfachsten per Composer mit composer require --dev pdepend/pdepend. Danach steht der Befehl unter vendor/bin/pdepend bereit. Wenn ihr PHPMD 3 nutzt, ist PDepend 3 schon im Projekt. Für Teams ist Composer meist die beste Wahl, weil die Version dann im Lock File festgehalten ist.

Was zeigt das JDepend Chart?

Das JDepend Chart ordnet jedes Paket nach Abstraktion und Instabilität an. Pakete nahe der Hauptlinie sind ausgewogen. Pakete weit davon entfernt sind entweder zu abstrakt und kaum genutzt oder sehr konkret und von vielen abhängig. Diese Pakete sind schwer zu ändern und gute Kandidaten für einen Umbau.

Was ist die Overview Pyramid?

Die Overview Pyramid fasst Größe, Komplexität und Kopplung eines Projekts in einer Grafik zusammen. Sie zeigt Verhältnisse wie Methoden pro Klasse oder Aufrufe pro Methode. So seht ihr auf einen Blick, ob ein Projekt eher aus vielen kleinen oder wenigen großen Bausteinen besteht und wie stark diese verbunden sind.

Was ist der Unterschied zwischen zyklomatischer und NPath Komplexität?

Die zyklomatische Komplexität zählt die Entscheidungen in einer Methode, also jedes if, jede Schleife und jedes case. Die NPath Komplexität zählt die möglichen Wege durch die Methode. Sie wächst bei verschachtelten Bedingungen viel schneller. Beide Werte zeigen, wie schwer eine Methode zu testen und zu verstehen ist.

Muss ich eigene PDepend Erweiterungen anpassen?

Ja, wenn ihr eigene Analyzer oder Parser Erweiterungen geschrieben habt. In Version 3 haben Interfaces native Typen, der Visitor wurde umgebaut und viele Parser Methoden sind privat. getName ersetzt ihr durch getImage. Die Details stehen in der Upgrade Anleitung des Projekts auf GitHub.

Kann ich PDepend in der CI Pipeline nutzen?

Ja. Ihr ruft PDepend in GitHub Actions oder GitLab CI auf und legt summary.xml und die SVG Grafiken als Artefakt ab. So kann jeder im Team die Zahlen ansehen. Als Gate, das den Build stoppt, nutzt ihr besser PHPMD, weil es die Metriken mit festen Grenzwerten prüft.

Hilft PDepend auch bei der Arbeit mit Coding Agents?

Ja. Ein Agent sieht meist nur die Dateien, die er gerade bearbeitet. Die Metriken aus PDepend zeigen ihm, wo im Projekt die komplexen und stark gekoppelten Stellen liegen. Nach jeder Änderung messt ihr, ob die Komplexität gesunken ist. Für ein festes Gate kombiniert ihr das mit PHPMD.