PHPStan 2.3 ist bis zu 7,5 mal schneller, erkennt ungenutzte Variablen und versteht Generics besser. Turbo, Result Cache, Installation und CI Einsatz
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.
final class ConferenceFactory
{
private $talkFactory;
public function createConference(array $data)
{
$talks = $this->talkFactory->create($data);
return new Conference($talks);
}
}
array am Parameter. Das ergibt eine von drei Deklarationen, also rund 33 Prozent.
final class ConferenceFactory
{
private TalkFactory $talkFactory;
public function createConference(array $data): Conference
{
$talks = $this->talkFactory->create($data);
return new Conference($talks);
}
}
composer require tomasvotruba/type-coverage --dev
# phpstan.neon
includes:
- vendor/tomasvotruba/type-coverage/config/extension.neon
# phpstan.neon
parameters:
type_coverage:
return: 50
param: 35.5
property: 70
constant: 85
phpstan.neon läuft. Prüft ihr nur einen Unterordner wie src/Controller, bleibt Type Coverage still. So vermeidet das Paket falsche Treffer, wenn ein einzelner Ordner schwächer typisiert ist als der Rest.
Rector\TypePerfect. Bestehende Ignores und Baselines passen deshalb weiter.
composer remove rector/type-perfect --dev
composer require tomasvotruba/type-coverage --dev
# phpstan.neon
parameters:
type_perfect:
no_isset_on_object: true
no_empty_on_object: true
no_param_type_removal: true
no_mixed_property: true
no_mixed_caller: true
narrow_param: true
narrow_return: true
no_isset_on_object bis narrow_return.mixed an Stellen, die eigentlich klar sind. Eine feste Quote in der Pipeline stoppt das automatisch. Der Agent bekommt den PHPStan Fehler zurück und muss nachbessern.
This technique is very simple to start even on legacy project.
PHPStan 2.3 ist bis zu 7,5 mal schneller, erkennt ungenutzte Variablen und versteht Generics besser. Turbo, Result Cache, Installation und CI Einsatz
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.
Type Coverage ist eine PHPStan Erweiterung von Tomas Votruba. Sie misst den Anteil gesetzter Typdeklarationen an allen möglichen Stellen im Code, getrennt nach Rückgabewerten, Parametern, Properties und Konstanten. Ihr legt pro Art einen Mindestwert fest. Fällt der Code darunter, meldet PHPStan einen Fehler, und die Pipeline bleibt rot. So wächst die Typensicherheit messbar und Schritt für Schritt.
Type Perfect ist als deprecated markiert. Die Regeln wurden mit Version 2.3 in Type Coverage übernommen. Ihr entfernt rector/type-perfect aus der composer.json und installiert tomasvotruba/type-coverage. Die Regeln behalten ihren alten Namespace, deshalb passen Ignores und Baselines weiter. Nur die Prüfung auf Array Zugriff bei Objekten wurde nicht übernommen.
Type Coverage ab Version 2.3, also mit den Type Perfect Regeln, verlangt PHP 8.4. Type Perfect lief noch ab PHP 8.2. Projekte auf älteren PHP Versionen bleiben vorerst bei einer älteren Type Coverage Version oder planen zuerst das PHP Update. Das lohnt sich ohnehin, weil alte PHP Versionen keine Sicherheitsupdates mehr bekommen.
Startet mit dem Wert, den euer Code heute erreicht, und tragt ihn als Mindestwert ein. Dann hebt ihr die Quote in kleinen Schritten an, etwa bei jedem größeren Ticket. Ein starrer Zielwert von außen bringt wenig. Wichtig ist, dass die Zahl nie sinkt und neuer Code von Anfang an vollständig typisiert ist.
Ja. KI Agents lassen gern Typen weg oder greifen zu mixed. Eine feste Quote in der Pipeline fängt das ohne Diskussion ab. Der Agent bekommt den PHPStan Fehler zurück und muss nachbessern. Zusammen mit den Type Perfect Regeln entsteht so ein einfacher Guardrail, der auch bei hohem Tempo die Qualität hält.
Ihr installiert das Paket mit composer require tomasvotruba/type-coverage --dev. Mit dem PHPStan Extension Installer ist es sofort aktiv. Ohne Installer bindet ihr die Datei config/extension.neon aus dem Paket in eure phpstan.neon ein. Danach setzt ihr unter type_coverage die Mindestwerte für return, param, property und constant.
Das ist Absicht. Type Coverage greift nur, wenn PHPStan über die vollen Pfade aus der phpstan.neon läuft. Ein einzelner Ordner kann schwächer typisiert sein als das Projekt im Schnitt. Würde das Paket dort anschlagen, gingen andere Fehler in der Ausgabe unter. Startet PHPStan also ohne Pfadangabe, wenn ihr die Quote prüfen wollt.
Code Coverage misst, welcher Code bei euren Tests läuft. Type Coverage misst, wie viele Typdeklarationen im Code stehen. Beide Zahlen sagen etwas anderes. Hohe Code Coverage schützt nicht vor fehlenden Typen, und volle Typen ersetzen keinen Test. In einem gesunden Projekt beobachtet ihr beide Werte getrennt.
Nein. PHPStan Level bestimmen, wie streng die Analyse prüft. Type Coverage misst, wie viele Typen überhaupt da sind. Beides ergänzt sich gut. Mehr Typen machen höhere Level erst erreichbar, weil PHPStan dann mehr über den Code weiß. Oft lohnt es sich, zuerst die Quote und danach das Level zu heben.
Am einfachsten sind no_isset_on_object und no_empty_on_object. Sie ersetzen isset und empty auf Objekten durch instanceof, damit PHPStan den genauen Typ kennt. Danach folgen no_param_type_removal, die Regeln gegen mixed Zugriffe und zum Schluss narrow_param und narrow_return. In dieser Reihenfolge stehen die Regeln auch in der Dokumentation.
Rector bringt Regeln mit, die Typen aus Aufrufen und Rückgaben ableiten. Das spart viel Handarbeit. Trotzdem gehört jede Änderung ins Review, weil ein falsch abgeleiteter Typ zur Laufzeit knallen kann. Wir setzen auf Refactoring von Hand mit KI und Rector als Helfer, abgesichert durch Tests in der Pipeline.
Ja. Type Coverage ist eine normale PHPStan Erweiterung und funktioniert unabhängig vom Framework. In Laravel Projekten läuft PHPStan meist über Larastan, das Eloquent und Facades versteht. Type Coverage ergänzt das um eine klare Quote. So seht ihr auch in großen Laravel Codebasen, ob die Typensicherheit wächst.