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
$_GET ungeprüft in einer SQL Abfrage landet. Psalm stammt ursprünglich von Vimeo und wird heute von Daniil Gentili und Alies Lapatsin gepflegt. Es steht unter MIT Lizenz und ergänzt PHPStan als zweites Quality Gate in vielen PHP Projekten.
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.
io oder time.Result<int> funktioniert ohne zweites Argument.compact und knappe Meldungen sparen Platz im Kontext des Agenten.
# Nach jeder Änderung an einer Datei
./vendor/bin/psalm --no-progress --output-format=compact src/Service/InvoiceService.php
# Vor dem Commit über das ganze Projekt
./vendor/bin/psalm --no-progress --output-format=compact
@psalm-suppress davor oder schieben ihn in die Baseline. Psalm 7 schließt diese Tür. Fehler unter unsuppressibleIssues lassen sich weder im Code noch über die Baseline stumm schalten. Der Eintrag TaintedInput steht für alle Taint Fehler. Mit findUnusedPsalmSuppress meldet Psalm zusätzlich jedes Suppress, das nichts mehr unterdrückt.
<!-- Auszug aus der psalm.xml -->
<psalm findUnusedPsalmSuppress="true">
<unsuppressibleIssues>
<!-- alle Taint Fehler -->
<issue name="TaintedInput" />
<!-- erfundene Methoden und Klassen -->
<issue name="UndefinedMethod" />
<issue name="UndefinedClass" />
</unsuppressibleIssues>
</psalm>
<?php
$runCommand = function (string $command): void {
shell_exec($command);
};
// Psalm 7 verfolgt den Wert jetzt auch durch die Closure
$runCommand((string) $_GET['cmd']); // TaintedShell
php://input, hochgeladene Dateinamen und Kommandozeilen Argumente. Der Datenfluss wird jetzt auch durch Closures, Generatoren, Traits und Referenz Parameter verfolgt. Für Prompt Injection gibt es den neuen Fehler TaintedLlmPrompt, für MongoDB TaintedNosql. Taint Fehler bekommen die Stufe SECURITY und landen im SARIF Report. Damit zeigt GitHub Code Scanning sie direkt im Pull Request an. Wer die Analyse abschalten will, setzt runTaintAnalysis="false" in der psalm.xml. Das empfehlen wir nicht. Die Prüfung passt gut zu den Risiken aus den OWASP Top 10.
@psalm-pure und @psalm-mutation-free werden durch Capabilities ersetzt. Das Modell kommt aus der Sprache Hack. Eine Funktion sagt genau, welche Seiteneffekte sie haben darf. Zur Auswahl stehen unter anderem io, time, read-props, write-props und read-globals. An den beiden Enden stehen pure und impure.
<?php
/** @psalm-capabilities time */
function today(): string
{
return date('Y-m-d'); // erlaubt
}
/** @psalm-pure */
function todayPure(): string
{
return date('Y-m-d'); // ImpureFunctionCall, braucht time
}
suggestPurityAnnotations="true" schlägt es fehlende Annotationen vor, und --alter trägt sie automatisch ein. Das lohnt sich doppelt. Reine Funktionen verbessern die Typinferenz und senken die Zahl falscher Treffer in der Security Analyse. Für Teams mit vielen Value Objects und Domain Driven Design ist das ein echter Gewinn.
<?php
final class Ping // UnusedClass
{
public static function ping(): void { Pong::pong(); }
}
final class Pong // UnusedClass
{
public static function pong(): void { Ping::ping(); }
}
<?php
function slug(string $title): string
{
return $title
|> trim(...)
|> strtolower(...)
|> str_replace(' ', '-', ?); // ok, jede Stufe ist typisiert
}
function length(string $title): string
{
return $title |> trim(...) |> strlen(...); // InvalidReturnStatement
}
composer require --dev vimeo/psalm
./vendor/bin/psalm --init
composer require --dev vimeo/psalm:^7.0 -W
psalm.xml für ein Symfony Projekt sieht so aus. Das Symfony Plugin müsst ihr nicht mehr eintragen, Psalm erkennt es über eure composer.json.
<?xml version="1.0"?>
<psalm
errorLevel="3"
findUnusedCode="true"
xmlns="https://getpsalm.org/schema/config"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="https://getpsalm.org/schema/config vendor/vimeo/psalm/config.xsd"
>
<projectFiles>
<directory name="src"/>
<ignoreFiles>
<directory name="vendor"/>
</ignoreFiles>
</projectFiles>
</psalm>
./vendor/bin/psalm --set-baseline=psalm-baseline.xml
./vendor/bin/psalm --alter --issues=MissingReturnType,MissingParamType --dry-run
--alter im Diff, bevor ihr sie committet. Wie gut eure Typen schon sind, zeigt euch Type Coverage.
--init-ci erzeugt Psalm 7 selbst einen GitHub Actions Workflow. Er nutzt das offizielle Docker Image ghcr.io/psalm/psalm, gepinnt auf die Version aus eurer composer.lock.
./vendor/bin/psalm --init-ci
psalm:
stage: analyze
image: composer:2
before_script:
- composer install --no-interaction --no-progress
script:
- ./vendor/bin/psalm --no-progress --report=psalm.sarif --output-format=codeclimate > gl-code-quality-report.json
artifacts:
when: always
paths:
- psalm.sarif
reports:
codequality: gl-code-quality-report.json
Featuring a simply enormous number of new features and bug fixes
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.
Ja. Psalm und PHPStan finden unterschiedliche Fehler. PHPStan ist sehr schnell und hat ein großes Ökosystem an Extensions. Psalm bringt mit Version 7 eine eingebaute Security Analyse, ein genaues Modell für Seiteneffekte und eine Dead Code Erkennung über einen Graphen mit. Viele Teams lassen deshalb beide Tools in der Pipeline laufen und profitieren von der doppelten Absicherung.
Psalm gibt Coding Agents ein schnelles und eindeutiges Signal. Der Agent startet die Analyse nach jeder Änderung, liest die Meldungen und bessert selbst nach. Psalm 7 prüft dabei Typen, Sicherheit und toten Code in einem Lauf und liefert bei jedem Lauf das gleiche Ergebnis. Über unsuppressibleIssues legt ihr fest, welche Fehler ein Agent weder unterdrücken noch in die Baseline schieben kann.
Die Security Analyse läuft jetzt standardmäßig mit. Typprüfung, Taint Analyse und Dead Code Erkennung passieren in einem Durchgang. Laut Maintainern ist die Security Analyse bis zu zehnmal schneller als vorher. Dazu kommen neue Taint Arten für NoSQL Injection, Prompt Injection in LLM Aufrufe und manipulierte URL Bestandteile. Ihr bekommt diese Prüfungen ohne zusätzliche Konfiguration.
Psalm 7 läuft auf 64 Bit PHP 8.2 bis 8.6. Ältere Versionen wie PHP 8.1 werden nicht mehr unterstützt. Das betrifft die PHP Version, mit der ihr Psalm ausführt. Wenn euer Projekt noch auf einer älteren Version läuft, bleibt ihr vorerst bei Psalm 6 oder plant zuerst das PHP Upgrade.
Für die meisten Projekte reicht ein Composer Update mit vimeo/psalm in Version 7. Der größte Unterschied ist die Security Analyse, die jetzt immer läuft. Rechnet deshalb mit neuen Treffern beim ersten Lauf. Nehmt bekannte Fälle in die Baseline auf und arbeitet sie danach schrittweise ab. Eigene Plugins solltet ihr gegen die neue Plugin API prüfen.
Ja. Psalm 7 kennt den Fehler TaintedLlmPrompt. Er meldet, wenn eine Eingabe von außen ungeprüft in einen Prompt für ein Sprachmodell fließt. Das ist wichtig für PHP Anwendungen, die KI Funktionen einbauen. Psalm ersetzt dabei keine Prüfung der Modellantworten, deckt aber den häufigsten Fehler im eigenen Code früh auf.
Taint Analyse verfolgt Daten von unsicheren Quellen bis zu gefährlichen Stellen im Code. Quellen sind zum Beispiel $_GET, $_POST oder php://input. Gefährliche Stellen heißen Sinks, etwa SQL Abfragen, Shell Befehle oder HTML Ausgaben. Kommt eine ungeprüfte Eingabe an einem Sink an, meldet Psalm einen Fehler wie TaintedSql oder TaintedHtml.
Der errorLevel legt fest, wie streng Psalm prüft. Die Skala reicht von 1 bis 8, wobei 1 am strengsten ist. Für neue Projekte empfehlen wir einen strengen Level ab dem ersten Tag. Bei Legacy Code startet ihr lockerer, setzt eine Baseline und zieht den Level Schritt für Schritt an.
Mit --alter ändert Psalm euren Code automatisch. Es ergänzt fehlende Return Types, Parameter Types und in Psalm 7 auch Annotationen für Reinheit. Ihr wählt über --issues, welche Fehlerarten bearbeitet werden. Startet immer mit --dry-run und prüft den Diff, bevor ihr die Änderungen übernehmt und committet.
Ihr müsst es nicht mehr selbst installieren. Psalm 7 liefert die Plugins für Symfony, Laravel, PHPUnit und Mockery mit. Sie schalten sich automatisch ein, wenn eure composer.json die passende Bibliothek enthält. Steuern lässt sich das über die Option loadLibraryPlugins in der psalm.xml, die standardmäßig aktiv ist.
Aktiviert findUnusedCode in der psalm.xml. Psalm 7 baut dann einen Graphen aus allen Referenzen und meldet alles, was von keinem Einstiegspunkt erreichbar ist. Dazu gehören ungenutzte Klassen, Methoden, Konstanten und Variablen, auch wenn sie sich nur gegenseitig aufrufen. Löscht toten Code am besten erst, wenn Tests das bestehende Verhalten absichern.
Am schnellsten mit dem Befehl psalm --init-ci. Psalm 7 erzeugt damit einen fertigen Workflow, der das offizielle Docker Image nutzt und auf die Version aus eurer composer.lock gepinnt ist. Für Security Ergebnisse gibt es zusätzlich die Psalm Security Scan Action. Sie schickt die Treffer an GitHub Code Scanning.