PHPStan 2.3.6 ist ein Patch Release mit großer Wirkung. Das Update bringt volle Unterstützung für PHP 8.6, neue Typen für Kommazahlen und weniger Lärm im Report. Wer PHP 8.6 einführen will, braucht genau diese Version. Sonst kennt die statische Analyse die neue Syntax nicht und euer Quality Gate wird zur Bremse.
Hier steht, was in PHPStan 2.3.6 steckt, wie ihr die neuen Typen nutzt und worauf ihr beim Update achtet.
PHP 8.6 und PHPStan sauber einführen: Wir heben mit euch PHP Version, PHPStan Level und Baseline Schritt für Schritt an, ohne dass die Pipeline tagelang rot ist. Zum NCA PHP Consulting
Die Highlights von PHPStan 2.3.6 im Überblick
PHPStan prüft PHP Code auf Fehler, ohne ihn auszuführen. Wie das Tool arbeitet und welche Level es gibt, steht in unserem Glossar zu PHPStan. Die Neuerungen von Version 2.3.6 auf einen Blick:
| Neuerung | Was ihr davon habt |
|---|---|
| Volle Unterstützung für PHP 8.6 | Partial Function Application wird analysiert und nicht als Fehler gemeldet |
| Float Range Typen | Wertebereiche für Kommazahlen wie float<0.0, 1.0> oder finite-float |
| Teilanalyse ohne Lärm | Keine fremden ignore.unmatched Meldungen mehr, wenn ihr nur einen Ordner prüft |
| Präziserer Result Cache | Weniger Dateien werden zwischen zwei Läufen neu analysiert |
| Benchmarks mit Tally | Stabile Messwerte in der CI, egal wie schnell der Runner ist |
Den großen Sprung bei Tempo, Generics und ungenutzten Variablen gab es schon mit Version 2.3. Was dort neu kam, lest ihr in unserem Beitrag zum PHPStan 2.3 Update.
PHP 8.6 und Partial Function Application in PHPStan
Das wichtigste neue Feature von PHP 8.6 heißt Partial Function Application. Ihr schreibt einen normalen Funktionsaufruf und setzt ein ? dort ein, wo ein Argument noch fehlt. PHP führt die Funktion dann noch nicht aus. Ihr bekommt eine Closure zurück, die auf den Rest wartet. Viele kleine Arrow Functions fallen damit weg.
// Bisher
$rounded = array_map(fn (float $price) => round($price, 2), $prices);
// Mit PHP 8.6
$rounded = array_map(round(?, 2), $prices);
Ohne Unterstützung im Analyser wäre jede dieser Zeilen ein Problem. Mit 2.3.6 versteht PHPStan die neue Syntax. Läuft euer Projekt noch auf einer älteren PHP Version, meldet PHPStan die Stelle, weil Partial Function Application erst ab PHP 8.6 funktioniert. So rutscht kein Code durch, der in Produktion gar nicht laufen würde.
Welche PHP Version PHPStan annimmt, liest es seit Version 2.3 auch aus der Angabe require.php in eurer composer.json. Wollt ihr das fest vorgeben, setzt phpVersion in der phpstan.neon. Alle anderen Neuerungen der Sprache erklärt unser Beitrag zu PHP 8.6 und seinen neuen Features.
Float Range Typen für Kommazahlen
Für Integer kennt PHPStan Wertebereiche schon lange. Ein int<0, 100> beschreibt eine Zahl zwischen 0 und 100. Für Kommazahlen gab es so etwas bisher nicht. Ein Rabatt, eine Wahrscheinlichkeit oder eine Deckkraft war einfach ein float. Ob der Wert sinnvoll war, prüfte niemand.
Mit 2.3.6 ändert sich das. Ihr könnt Grenzen direkt im PHPDoc angeben:
/**
* @param float<0.0, 1.0> $ratio
*/
function setOpacity(float $ratio): void
{
}
setOpacity(0.5); // passt
setOpacity(1.5); // PHPStan meldet einen Fehler
Dazu kommen fertige Typen für die häufigsten Fälle:
positive-floatfür Werte größer als null, etwa eine Dauer in Sekunden.non-negative-floatfür Werte ab null, etwa einen Preis.negative-floatundnon-positive-floatfür die Gegenrichtung.finite-floatfür Zahlen ohne NAN und ohne unendliche Werte.
Gerade finite-float ist wertvoll. NAN ist technisch ein float und rutscht deshalb durch jede normale Typprüfung. Ein NAN aus einer Division kann sich still durch Berechnungen ziehen, bis eine Rechnung oder ein Diagramm falsch ist. Mit dem neuen Typ fällt das schon in der Analyse auf.
/**
* @param finite-float $amount
* @param positive-float $rate
*/
function applyRate(float $amount, float $rate): float
{
return $amount * $rate;
}
PHPStan rechnet mit den Bereichen auch weiter. Wandelt ihr einen Integer Bereich in float um, entsteht ein passender Float Bereich. Bei Rechenoperationen leitet PHPStan die neuen Grenzen ab. Die technischen Details stehen im Pull Request zu den Float Range Typen.
Weniger Lärm bei der Analyse einzelner Ordner
Viele Teams prüfen nicht immer das ganze Projekt. Im Git Hook läuft PHPStan nur über die geänderten Dateien, lokal oft nur über einen Ordner.
vendor/bin/phpstan analyse src/Controller
Bisher gab es dabei ein lästiges Problem. Die Baseline und die Ignore Regeln gelten für das ganze Projekt. Prüft ihr nur einen Teil, passen viele Einträge zu keinem Fehler. PHPStan meldete das als ignore.unmatched, und zwar für jeden einzelnen Eintrag. Die echten Fehler gingen in dieser Liste unter.
Mit 2.3.6 ist der Report bei Teilanalysen sauber. Ihr seht nur noch Meldungen, die zu den geprüften Dateien gehören. Für Git Hooks und schnelle lokale Läufe ist das eine echte Erleichterung.
Ein Result Cache, der weniger neu analysiert
Der Result Cache merkt sich, welche Fehler PHPStan in welchen Dateien gefunden hat. Beim nächsten Lauf werden nur geänderte Dateien und ihre Abhängigkeiten neu geprüft.
Eine Lücke gab es noch. Tauchte eine neue Klasse oder Funktion auf, analysierte PHPStan alle Dateien mit Fehlern neu, auch die aus der Baseline. Die Hoffnung war, dass Fehler zu einem bisher unbekannten Symbol verschwinden. In großen Projekten mit langer Baseline kostete das bei jedem neuen Symbol Zeit.
Jetzt verfolgt die Engine genau, welche Regeln und Extensions nach einem unbekannten Symbol gefragt haben. Taucht das Symbol auf, weiß der Cache, welche Dateien betroffen sind. Nur die werden neu analysiert. Das Ergebnis sind spürbar schnellere Läufe im Alltag. In der Pipeline wirkt das nur, wenn ihr den Cache zwischen den Läufen speichert. Wie ihr das zusammen mit Tests und Code Stil aufbaut, zeigt unser Beitrag zu Quality Gates in der CI/CD Pipeline.
Tally Benchmarks und TwigStan für Templates
PHPStan wird jetzt laufend mit Tally gemessen. Die Zahlen bleiben in der CI stabil, egal wie schnell der Runner gerade ist. Für euch heißt das: Verlangsamungen fallen beim Projekt selbst früher auf und landen seltener in einem Release.
Die Release Notes weisen außerdem auf TwigStan hin. Das Tool bringt statische Analyse in Twig Templates und baut auf PHPStan auf. Für Symfony Projekte schließt es eine Lücke, denn Fehler in Templates sieht PHPStan allein nicht. Den Code und die Einrichtung findet ihr im GitHub Repository von TwigStan.
So aktualisiert ihr auf PHPStan 2.3.6
Das Update ist ein Befehl. Aktualisiert die offiziellen Extensions gleich mit, damit alle zur selben Version passen.
composer update phpstan/phpstan
composer update "phpstan/*"
Danach lohnen sich drei Prüfungen:
- Voller Lauf: Nach einem PHPStan Update wird der Result Cache einmal komplett verworfen. Plant den ersten Lauf in der Pipeline etwas länger ein.
- Baseline prüfen: Präzisere Typen können neue Meldungen erzeugen. Schaut sie euch an, bevor ihr sie in die Baseline schiebt.
- Erste Float Bereiche setzen: Fangt bei Werten an, die schon heute Ärger machen. Prozente, Preise und Faktoren sind gute Kandidaten.
Steht ein älteres Projekt noch ganz am Anfang, hilft ein Blick mit PHPStan Bodyscan. Es zeigt, wie viele Fehler auf jedem Level warten. Alle Änderungen der einzelnen Versionen findet ihr in den PHPStan Releases auf GitHub.
Warum strengere Typen auch Coding Agents helfen
Coding Agents schreiben Code, der auf den ersten Blick läuft. Ob eine Funktion einen negativen Preis oder einen Faktor von 150 Prozent annimmt, prüfen sie selten. Solche Fehler fallen oft erst in Produktion auf.
Float Range Typen machen diese Regeln sichtbar. Steht im PHPDoc float<0.0, 1.0>, bekommt der Agent bei einem falschen Wert eine klare Meldung aus der Pipeline zurück. Damit kann er selbst nachbessern, bevor ein Mensch den Pull Request liest. Wir nutzen PHPStan täglich als Quality Gate, egal ob ein Mensch oder eine KI den Code geschrieben hat. Unser Grundsatz bleibt: erst Quality Gates, dann KI. Was passiert, wenn diese Leitplanken fehlen, zeigt unser Beitrag dazu, wie KI Refactoring die Applikation zerstört.
Häufige Fragen zu PHPStan 2.3.6
Brauche ich PHPStan 2.3.6 für PHP 8.6?
Ja, wenn ihr die neuen Sprachfeatures nutzen wollt. Mit 2.3.6 versteht PHPStan PHP 8.6 vollständig, auch Partial Function Application. Hebt PHPStan deshalb vor oder zusammen mit der PHP Version an.
Muss ich meine float Typen jetzt umschreiben?
Nein. Ein einfaches float funktioniert weiter. Die neuen Bereiche sind ein Angebot. Setzt sie dort ein, wo falsche Werte echten Schaden anrichten.
Was ist der Unterschied zwischen positive-float und non-negative-float?
positive-float erlaubt nur Werte größer als null. non-negative-float erlaubt zusätzlich die Null. Für eine Dauer passt meist der erste Typ, für einen Preis oder Rabatt eher der zweite.
Brauche ich für die Neuerungen Bleeding Edge?
Für die Highlights aus 2.3.6 nennen die Release Notes keine Bleeding Edge Pflicht. Die Unused Variables und die neuen Generics aus Version 2.3 laufen dagegen nur mit Bleeding Edge.
Fazit
PHPStan 2.3.6 macht euer Projekt fit für PHP 8.6 und gibt Kommazahlen endlich echte Grenzen. Dazu kommen sauberere Reports bei Teilanalysen und ein Result Cache, der weniger Arbeit macht. Das Update ist ein Befehl. Der Gewinn zeigt sich jeden Tag in der Pipeline.
PHPStan und PHP 8.6 in eurem Projekt
Wir bringen mit euch PHPStan, Baseline und PHP Version auf den aktuellen Stand und bauen daraus ein Quality Gate, das Menschen und Coding Agents gleich streng prüft. Im kostenlosen Kennenlernen schätzen wir den Aufwand, abgerechnet wird transparent auf die Minute.
