NCA Social Media
Erstellt:
Aktualisiert:
Autor:
Roland Golla
Grüner Scanner prüft PHP Code, KI Agent repariert rote Stellen, Flagge PHPMD

Was ist der PHP Mess Detector?

Der PHP Mess Detector (PHPMD) ist ein Open Source Tool für die statische Analyse, das in PHP Code nach unordentlichen Stellen sucht. Er findet zu lange Methoden, zu komplexe Klassen, ungenutzten Code und schlechte Namen, bevor sie zum Problem werden.
PHPMD ist das PHP Gegenstück zum bekannten Java Tool PMD und entstand als Ableger von PDepend. PDepend misst den Code, PHPMD bewertet die Zahlen mit Regeln. Mit Version 3 hat das Projekt einen großen Schritt gemacht. Es gibt eine neue Kommandozeile, Konfiguration per YAML, parallele Analyse und Attribute statt Kommentaren zum Unterdrücken von Meldungen.
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

PHPMD mit NCA richtig einordnen

Never Code Alone arbeitet seit über 20 Jahren mit PHP, Testing und Refactoring. Unsere tägliche Basis für statische Analyse sind PHPStan und Psalm. PHPMD nutzen wir nicht produktiv. Wir kennen das Tool aber gut und wissen, wo es gegenüber Typ Analysen echte Lücken schließt. Unser Grundsatz bleibt gleich: erst Quality Gates, dann KI und dann aufräumen.
Wenn ihr PHPMD einführen oder auf Version 3 heben wollt, helfen wir mit PHP Consulting für Qualität und Legacy Code. Dazu passen statische Analyse mit PHPStan und Psalm, automatisches Refactoring mit Rector, Tests mit PHPUnit und Characterization Tests für Legacy PHP.

So findet PHPMD Probleme im Code

PHPMD liest euren Code ein und baut daraus einen Abstract Syntax Tree. Auf diesen Baum wendet es Regeln an. Jede Regel prüft eine Sache und meldet einen Verstoß, wenn ein Grenzwert überschritten ist. Die Regeln sind in sechs Gruppen sortiert.
  • cleancode: Else Zweige, statische Zugriffe, boolesche Parameter und Bedingungen ohne Logik
  • codesize: zyklomatische Komplexität, NPath Komplexität, lange Methoden und große Klassen
  • controversial: Superglobals und Namenskonventionen, über die Teams gern streiten
  • design: exit, eval, goto, zu viele Abhängigkeiten und zu tiefe Vererbung
  • naming: zu kurze oder zu lange Namen für Variablen, Methoden und Klassen
  • unusedcode: ungenutzte private Felder, Methoden, Parameter und lokale Variablen
Der Unterschied zu PHPStan ist wichtig. PHPStan fragt, ob der Code korrekt ist. PHPMD fragt, ob der Code wartbar ist. Eine Methode mit 300 Zeilen kann fehlerfrei laufen und trotzdem niemand mehr verstehen. Genau dort schlägt PHPMD an.

Das ist neu in PHPMD 3

Version 3 ist das größte Update in der Geschichte von PHPMD. Die Mindestversion springt auf PHP 8.1, als Basis dient PDepend 3. Die Kommandozeile läuft jetzt über Symfony Console. Das bringt neue Befehle und klarere Optionen.
  • phpmd init fragt euch durch ein kurzes Setup und schreibt eine phpmd.yml
  • phpmd migrate wandelt alte XML Rulesets in YAML um
  • Zero Config: Ohne Argumente findet PHPMD Konfiguration und Pfade selbst
  • Neue Formate: Konfiguration geht per YAML, JSON, PHP oder weiter per XML
  • Threads: Mit der Option threads parst PHPMD Dateien parallel
  • Attribute: Statt Kommentaren unterdrückt ihr Meldungen mit #[SuppressWarnings]
  • GitHub: Ein neuer Renderer schreibt Ergebnisse als GitHub Check Runs
Drei Regeln sind neu. IfStatementWithoutLogic meldet Bedingungen, die nur aus festen Werten bestehen. LongMethodName meldet zu lange Namen. UnusedSuppression findet Attribute, die gar nichts mehr unterdrücken. So bleibt die Liste der Ausnahmen sauber.
Auch die Grenzwerte sind jetzt einheitlich. Alle Regeln melden erst, wenn ein Wert über dem Maximum liegt. Die alten Namen wie reportLevel, minimum oder maxmethods heißen jetzt maximum. Die alten Namen funktionieren als Alias weiter.

PHPMD 2 und PHPMD 3 im Vergleich

Thema PHPMD 2 PHPMD 3
PHP Version ab PHP 5.3.9 ab PHP 8.1
Aufruf phpmd src text codesize phpmd analyze --ruleset codesize src
Konfiguration nur XML Rulesets YAML, JSON, PHP oder XML, mit phpmd init
Dateien ausschließen --ignore oder --exclude nur --exclude
Dateiendungen --extensions --suffixes
Priorität --minimumpriority --minimum-priority
Report Datei --reportfile --reportfile-text, --reportfile-xml und weitere
Meldungen unterdrücken @SuppressWarnings im Kommentar #[SuppressWarnings] als Attribut
Parallel nein ja, mit --threads
Exit Code bei Fehlern 1 3

PHPMD installieren und zum ersten Mal starten

Am einfachsten installiert ihr PHPMD per Composer als Dev Abhängigkeit. Danach legt der Assistent eine Konfiguration an.
Code:
          

composer require --dev phpmd/phpmd
vendor/bin/phpmd init

Für den ersten Lauf reicht ein Befehl. Ihr wählt die Regelgruppen und den Ordner. Das Standardformat ist Text.
Code:
          

vendor/bin/phpmd analyze --ruleset codesize --ruleset unusedcode src/

Habt ihr schon ein XML Ruleset aus PHPMD 2, wandelt phpmd migrate es in YAML um. Prüft danach eure Skripte. Alte Optionen wie --ignore oder --reportfile gibt es nicht mehr.
Einzelne Meldungen unterdrückt ihr jetzt direkt am Code. Das Attribut zeigt klar, welche Regel gemeint ist.
Code:
          

use PHPMD\Attribute\SuppressWarnings;
use PHPMD\Rule\UnusedLocalVariable;

#[SuppressWarnings(UnusedLocalVariable::class)]
public function example()
{
    $unused = 42;
}

PHPMD in Legacy Projekten mit Baseline einführen

Ein alter Code Bestand liefert beim ersten Lauf oft Hunderte Meldungen. Niemand räumt die an einem Tag auf. Die Baseline löst das Problem. Sie speichert alle bekannten Verstöße in einer Datei. Ab dann meldet PHPMD nur noch neue Probleme.
Code:
          

vendor/bin/phpmd analyze --ruleset codesize --generate-baseline src/

In PHPMD 3 arbeitet --update-baseline strenger. Neue Verstöße landen nicht mehr still in der Datei. PHPMD gibt sie aus und endet mit Exit Code 2. So wächst die Altlast nicht heimlich weiter.
Für große Projekte helfen zwei weitere Schalter. Der Cache überspringt die Regeln für Dateien, die sich nicht geändert haben. Mit --threads parst PHPMD mehrere Dateien gleichzeitig. Beides lässt sich auch fest in der Konfiguration eintragen.
Unser Weg für Legacy Code: zuerst sichern Tests das Verhalten ab, dann kommt die statische Analyse mit Baseline, danach wird schrittweise aufgeräumt. Wie das bei großen Umbauten klappt, zeigt das Strangler Fig Pattern.

PHPMD als Quality Gate in der CI Pipeline

Richtig wirksam wird PHPMD erst in der Pipeline. Jeder Merge Request läuft durch die Prüfung. Neuer unordentlicher Code kommt so gar nicht erst in den Hauptzweig. Das gilt für GitHub Actions genauso wie für GitLab CI.
Code:
          

name: PHPMD
on: [pull_request]
jobs:
  phpmd:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: shivammathur/setup-php@v2
        with:
          php-version: '8.4'
      - run: composer install --no-progress
      - run: vendor/bin/phpmd analyze --no-progress --ruleset codesize --ruleset unusedcode src/

Achtet beim Umstieg auf die Exit Codes. 0 heißt alles sauber, 2 heißt Regelverstöße gefunden, 3 heißt PHPMD konnte nicht arbeiten. Früher stand für Fehler eine 1. Skripte, die auf 1 prüfen, müsst ihr anpassen.
PHPMD passt gut neben PHP Codesniffer für den Code Stil. Wer alle Prüfungen schon vor dem Commit laufen lassen will, bündelt sie mit GrumPHP.

PHPMD im Vergleich mit anderen PHP Analyse Tools

Tool Fragt vor allem Typischer Fund
PHPMD Ist der Code wartbar? Methode zu lang, Klasse zu komplex, Variable ungenutzt
PHPStan Ist der Code korrekt? Aufruf auf null, falscher Typ, fehlende Methode
Psalm Sind Typen und Datenfluss sicher? Typfehler, unsichere Eingaben bis zur Ausgabe
PDepend Wie sieht der Code in Zahlen aus? Metriken zu Kopplung, Komplexität und Größe
PHP Metrics Wo liegen die Risiken im Projekt? HTML Report mit Hotspots und Diagrammen
Rector Was lässt sich automatisch verbessern? Veraltete Syntax, fehlende Typen, Upgrades

aims to be a PHP equivalent of the well known Java tool PMD

PHPMD Projekt – Projektseite phpmd.org

Wann sich PHPMD für euer Team lohnt

PHPMD lohnt sich, wenn euer Code zwar läuft, aber keiner ihn gern anfasst. Es zeigt die Stellen, an denen Refactoring am meisten bringt. Neben einem Typ Checker wie PHPStan ist es eine gute zweite Sicht. Allein ersetzt es keine Tests und keine Typ Analyse.
Gut passt PHPMD für Legacy Projekte mit großen Klassen, Teams mit gemeinsamen Grenzwerten für Komplexität und Pipelines, die neue Altlasten stoppen sollen. Weniger passt es für kleine neue Projekte, die PHPStan schon auf hoher Stufe fahren. Dort sind die Funde oft doppelt.
Für ein größeres Bild der Risiken eignet sich PHP Metrics mit seinem HTML Report. Wie gut eure Tests den Code abdecken, zeigt Code Coverage. Und wer vor einem PHP 8.6 Upgrade steht, sollte die Analyse vorher sauber aufsetzen.
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 zum PHP Mess Detector

Die wichtigsten Antworten rund um PHPMD, das Update auf Version 3 und den Einsatz in Legacy Projekten.
Wird PHPMD 2026 noch weiterentwickelt?

Ja. PHPMD wird aktiv gepflegt und hat mit Version 3 das größte Update seiner Geschichte bekommen. Das Maintainer Team hat die Kommandozeile neu gebaut, neue Regeln ergänzt und YAML Konfiguration eingeführt. Auch die Basis PDepend ist auf Version 3 gesprungen. Wer PHPMD nutzt, kann also weiter darauf setzen und sollte den Umstieg planen.

Welche PHP Version braucht PHPMD 3 im Jahr 2026?

PHPMD 3 braucht mindestens PHP 8.1. Das ist die Laufzeit für das Tool selbst. Läuft eure Pipeline noch auf einer älteren Version, bleibt nur PHPMD 2. Ein guter Anlass, die Pipeline anzuheben. Alte PHP Versionen bekommen ohnehin keine Sicherheitsupdates mehr und sind ein Risiko für den Betrieb.

Lohnt sich der Umstieg auf PHPMD 3 im Jahr 2026?

Ja, für die meisten Teams lohnt er sich. Ihr bekommt parallele Analyse, eine klarere Kommandozeile, YAML Konfiguration und Attribute statt Kommentaren. Die neue Regel UnusedSuppression räumt alte Ausnahmen auf. Der Aufwand ist überschaubar. phpmd migrate wandelt alte Rulesets um, danach passt ihr Optionen und Exit Codes in den Skripten an.

Was sind die wichtigsten Breaking Changes in PHPMD 3 für 2026?

Die Kommandozeile hat sich geändert. Der Aufruf lautet jetzt phpmd analyze. Optionen wie --ignore, --extensions und --reportfile sind weg oder umbenannt. Bei Verarbeitungsfehlern endet PHPMD mit Exit Code 3 statt 1. Grenzwerte melden erst über dem Maximum. Wer eigene Regeln geschrieben hat, muss außerdem die API Änderungen prüfen.

Ersetzt PHPStan im Jahr 2026 den PHP Mess Detector?

Nein, beide prüfen verschiedene Dinge. PHPStan sucht Fehler wie falsche Typen oder Aufrufe auf null. PHPMD sucht Wartungsprobleme wie zu lange Methoden, hohe Komplexität und ungenutzten Code. Manche Funde überschneiden sich, gerade bei ungenutztem Code. Für Legacy Projekte ist die Kombination aus beiden Tools oft sinnvoll.

Wie installiere ich PHPMD?

Am einfachsten per Composer mit composer require --dev phpmd/phpmd. Danach startet vendor/bin/phpmd init einen Assistenten, der eine phpmd.yml anlegt. Alternativ gibt es ein signiertes Phar, das ihr auch über Phive installieren könnt. Für Teams ist Composer meist die beste Wahl, weil die Version dann im Lock File steht.

Was ist eine Baseline in PHPMD?

Eine Baseline ist eine Datei mit allen bekannten Verstößen. PHPMD ignoriert diese Einträge und meldet nur neue Probleme. So könnt ihr PHPMD in ein altes Projekt bringen, ohne erst Hunderte Meldungen abzuarbeiten. In Version 3 gibt das Update der Baseline neue Verstöße aus und endet mit Exit Code 2.

Wie unterdrücke ich eine einzelne PHPMD Meldung?

In PHPMD 3 nutzt ihr das Attribut #[SuppressWarnings] mit der Klasse der Regel. Das steht direkt an der Methode oder Klasse. Die alte Schreibweise im Kommentar funktioniert noch, gilt aber als veraltet. Die Regel UnusedSuppression meldet euch, wenn ein Attribut nichts mehr unterdrückt und gelöscht werden kann.

Welche Regelgruppen bringt PHPMD mit?

PHPMD hat sechs Gruppen. cleancode prüft sauberen Stil, codesize misst Komplexität und Größe, controversial deckt umstrittene Konventionen ab. design findet schlechte Muster wie eval oder goto. naming prüft Namen, unusedcode findet toten Code. Ihr könnt Gruppen kombinieren und einzelne Grenzwerte in einer eigenen Konfiguration anpassen.

Wie baue ich PHPMD in GitHub Actions oder GitLab CI ein?

Ihr installiert die Abhängigkeiten per Composer und ruft danach phpmd analyze mit euren Regelgruppen auf. Findet PHPMD Verstöße, endet es mit Exit Code 2 und der Job schlägt fehl. Mit --no-progress bleibt das Log sauber. Für GitHub gibt es in Version 3 zusätzlich einen Renderer für Check Runs.

Was ist der Unterschied zwischen PHPMD und PDepend?

PDepend misst Code und liefert Metriken wie Komplexität, Kopplung und Größe. PHPMD baut auf PDepend auf und bewertet diese Zahlen mit Regeln und Grenzwerten. PDepend sagt also, wie groß eine Methode ist. PHPMD sagt, ob sie zu groß ist. Beide Projekte sind gemeinsam auf Version 3 gegangen.

Ist PHPMD für kleine Projekte sinnvoll?

Nur bedingt. In kleinen neuen Projekten mit PHPStan auf hoher Stufe sind viele Funde doppelt. PHPMD zeigt seine Stärke vor allem in gewachsenem Code mit großen Klassen und langen Methoden. Dort findet es schnell die Stellen, an denen Refactoring am meisten bringt, und hält mit einer Baseline neue Altlasten fern.