PDepend misst Komplexität, Kopplung und Größe von PHP Code, mit allem zu PDepend 3, parallelem Parsen, YAML Konfiguration und den wichtigsten Metriken
Mehr erfahren
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.
composer require --dev phpmd/phpmd
vendor/bin/phpmd init
vendor/bin/phpmd analyze --ruleset codesize --ruleset unusedcode src/
use PHPMD\Attribute\SuppressWarnings;
use PHPMD\Rule\UnusedLocalVariable;
#[SuppressWarnings(UnusedLocalVariable::class)]
public function example()
{
$unused = 42;
}
vendor/bin/phpmd analyze --ruleset codesize --generate-baseline src/
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/
aims to be a PHP equivalent of the well known Java tool PMD
PDepend misst Komplexität, Kopplung und Größe von PHP Code, mit allem zu PDepend 3, parallelem Parsen, YAML Konfiguration und den wichtigsten Metriken
Mehr erfahren
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.