NCA Social Media
Erstellt:
Aktualisiert:
Autor:
Roland Golla
Grünes Scanner Tor stoppt roten Code Würfel unter gelbem Schild PSALM 7

Was ist Psalm?

Psalm ist ein Open Source Tool für statische Analyse in PHP, das Typfehler, toten Code und Sicherheitslücken findet, bevor der Code läuft. Mit Psalm 7 laufen Typprüfung, Security Analyse und Dead Code Erkennung in einem einzigen Durchgang.
Psalm liest euren Code, baut daraus ein Modell aller Typen und verfolgt, wie Daten durch die Anwendung fließen. So sieht es, wenn eine Eingabe aus $_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.
Im Agentic Coding wird Psalm zum schnellen Signal für den Agenten. Ein Coding Agent startet die Analyse nach jeder Änderung selbst, liest die Meldungen und bessert nach, bevor ein Mensch den Code sieht.
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

Psalm mit NCA richtig einordnen

Psalm gehört bei NCA fest zum PHP Stack. Es läuft neben PHPStan, PHPUnit und Rector in unseren Symfony und Sulu Projekten, als Quality Gate in GitHub Actions und GitLab CI. Roland Golla arbeitet seit über 20 Jahren mit Testing und Refactoring. Unsere Regel ist einfach. Die KI schreibt Code, die Quality Gates sorgen für Qualität. Coding Agents liefern viel Code in kurzer Zeit, und Psalm prüft jede Zeile davon gleich streng. Besonders genau schaut es darauf, wo Nutzerdaten hinfließen.
Wollt ihr Psalm einführen oder auf Version 7 heben, passt das zu unserem PHP Refactoring und zum PHP Update. Für alte Codebasen gibt es die Legacy Modernisierung für PHP und Symfony. Den Build richten wir in der CI CD Pipeline mit Docker und Staging ein. Wer mit Coding Agents arbeitet, findet die Regeln dazu in den NCA PHP AI Coding Guidelines. Die Leitplanken für Agenten in bestehenden Projekten setzen wir mit den NCA Agentic AI Coding Guardrails auf.

Was ist neu in Psalm 7

Psalm 7 ist ein großes Major Release. Die Maintainer haben die Security Analyse neu gebaut, ein neues Modell für Seiteneffekte eingeführt und die Dead Code Erkennung umgestellt. Psalm 7 läuft auf 64 Bit PHP 8.2 bis 8.6.
  • Security Analyse immer an. Typprüfung, Taint Analyse und Dead Code Erkennung laufen in einem Durchgang. Die Security Analyse ist laut Maintainern bis zu zehnmal schneller.
  • Neue Taint Arten. Psalm erkennt jetzt NoSQL Injection, Prompt Injection in LLM Aufrufe und Manipulation von URL Bestandteilen.
  • Capabilities statt Pure Annotationen. Ihr legt fest, welche Seiteneffekte eine Funktion haben darf, zum Beispiel io oder time.
  • Dead Code als Graph. Psalm findet auch Klassen, die sich nur gegenseitig aufrufen und sonst nirgends genutzt werden.
  • Template Defaults. Generics bekommen Standardwerte, Result<int> funktioniert ohne zweites Argument.
  • Plugins sind dabei. Die Plugins für PHPUnit, Symfony, Laravel und Mockery werden mitgeliefert und schalten sich selbst ein.
  • Tägliche Releases. Fixes kommen am Tag, an dem sie fertig sind.

Psalm 6 und Psalm 7 im Vergleich

Thema Psalm 6 Psalm 7
Security Analyse Eigener Lauf mit --taint-analysis Läuft standardmäßig mit, bis zu zehnmal schneller
Seiteneffekte @psalm-pure und @psalm-mutation-free Capabilities wie io, time oder write-props
Dead Code Einfache Referenzprüfung Erreichbarkeit über einen Graphen, auch Zyklen
Plugins Einzeln installieren und aktivieren PHPUnit, Symfony, Laravel und Mockery eingebaut
PHP Versionen PHP 8.1 bis 8.6 64 Bit PHP 8.2 bis 8.6
Releases Klassische Versionen Tägliche Releases

Psalm 7 macht Agentic Coding in PHP sicherer

Ein Coding Agent schreibt Code schneller, als ein Team ihn lesen kann. Beim Agentic Coding braucht der Agent deshalb ein Signal, das schnell kommt, eindeutig ist und sich nicht überreden lässt. Psalm 7 liefert genau das.
  • Ein Lauf, drei Antworten. Typen, Sicherheit und toter Code kommen in einem Durchgang zurück. Der Agent muss keine drei Tools abfragen.
  • Gleiches Ergebnis bei jedem Lauf. Die Ergebnisse ändern sich in Psalm 7 nicht mehr zwischen zwei Läufen oder mit der Zahl der Threads. Der Agent jagt keinen Fehlern nach, die es gar nicht gibt.
  • Kurze Ausgabe. Das neue Format compact und knappe Meldungen sparen Platz im Kontext des Agenten.
  • Schnell für eine Datei. Psalm 7 startet schneller und baut für einzelne Dateien nicht mehr die ganze Dateiliste des Projekts auf.
  • Security im selben Schritt. Reicht der Agent eine Nutzereingabe ungeprüft an SQL, Shell oder einen Prompt weiter, meldet Psalm das sofort.
So sieht der Loop in der Praxis aus. Der Agent ändert eine Datei und prüft sie sofort. Vor dem Commit läuft Psalm über das ganze Projekt. Schreibt beide Befehle in eure AGENTS.md, dann kennt sie ein Agent wie OpenCode von der ersten Aufgabe an.
Code:
          

# 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

Agenten nehmen gern die Abkürzung. Steht ein Fehler im Weg, setzen sie ein @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.
Code:
          

<!-- 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>

Startet mit den Taint Fehlern und nehmt weitere dazu, sobald die Baseline dafür leer ist. Die Regeln für den Agenten bleiben kurz. Psalm muss grün sein, bevor eine Aufgabe als fertig gilt. Die Baseline wird nicht neu gesetzt. Jede Änderung geht als Diff durch ein Review. Wie Regeln und Prüfungen zusammenspielen, zeigen die Quality Gates für KI Code und der Beitrag zu Code Qualität mit KI Agenten.

Typische Agenten Fehler und was Psalm 7 dagegen tut

Was Agenten oft falsch machen Prüfung in Psalm 7 Nutzen im Agentic Coding
Nutzereingabe landet ungeprüft in SQL, Shell oder Prompt Taint Analyse, standardmäßig an Die Lücke fällt im selben Lauf auf, vor dem Review
Erfundene Methoden, Klassen und falsche Typen Typprüfung mit UndefinedMethod und UndefinedClass Halluzinationen scheitern sofort an der Analyse
Versteckte Seiteneffekte in reinen Funktionen Capabilities wie pure, io oder time Verträge bleiben stabil, auch nach großen Umbauten
Liegen gebliebene Helfer und Klassen nach Umbauten Dead Code Erkennung über den Graphen Die Codebasis wächst nicht still mit
Fehler per Suppress oder Baseline stumm geschaltet unsuppressibleIssues und findUnusedPsalmSuppress Das Gate lässt sich nicht umgehen
Nachbessern auf Basis schwankender Meldungen Stabile Ergebnisse zwischen den Läufen Der Agent bekommt ein verlässliches Signal

Security Analyse läuft jetzt immer mit

Bisher war die Taint Analyse ein eigener Lauf. Viele Teams haben ihn deshalb nie gestartet. In Psalm 7 ist sie Standard. Psalm markiert jede Eingabe von außen als Quelle und verfolgt sie bis zur Stelle, an der sie Schaden anrichten kann. Das nennt man Sink, zum Beispiel eine SQL Abfrage, ein Shell Befehl oder ein Prompt an ein Sprachmodell.
Code:
          

<?php

$runCommand = function (string $command): void {
    shell_exec($command);
};

// Psalm 7 verfolgt den Wert jetzt auch durch die Closure
$runCommand((string) $_GET['cmd']); // TaintedShell

Neu sind Quellen wie 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.

Capabilities beschreiben, was eine Funktion darf

Die Annotationen @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.
Code:
          

<?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
}

Psalm leitet die Reinheit über den ganzen Call Graph ab. Mit 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.

Dead Code Erkennung über einen Graphen

Psalm baut einen Graphen aus allen Referenzen im Projekt. Code gilt nur dann als genutzt, wenn er von einem Einstiegspunkt aus erreichbar ist. Zwei Klassen, die sich nur gegenseitig aufrufen, fallen damit auf. Auch Exceptions, die erzeugt, aber nie geworfen werden, meldet Psalm jetzt.
Code:
          

<?php

final class Ping // UnusedClass
{
    public static function ping(): void { Pong::pong(); }
}

final class Pong // UnusedClass
{
    public static function pong(): void { Ping::ping(); }
}

Gerade in Legacy Projekten liegt viel solcher Code herum. Ihn zu löschen macht jedes spätere Rector Upgrade kleiner. Ergänzend helfen Unused Public und Class Leak. Löscht nur mit Tests im Rücken. Characterization Tests sichern das heutige Verhalten ab, bevor ihr aufräumt.

Pipe Operator und Partial Function Application typsicher prüfen

Psalm 7 kennt die neuen Sprachfeatures aus PHP 8.5 und 8.6. Der Pipe Operator reicht einen Wert durch mehrere Funktionen. Psalm leitet den Typ jeder Stufe ab und meldet, wenn eine Stufe nicht zur vorherigen passt. Bei der Partial Function Application kennt Psalm die Signatur jeder teilweise angewendeten Closure.
Code:
          

<?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
}

Plant ihr den Sprung auf die neue Version, hilft unser Leitfaden zum PHP 8.6 Upgrade. Alle Features von 8.0 bis 8.6 findet ihr im PHP 8 Versionen Vergleich.

Psalm und PHPStan im Vergleich

Kriterium Psalm 7 PHPStan 2
Strenge errorLevel 1 bis 8, 1 ist am strengsten Level 0 bis 10, 10 ist am strengsten
Security Analyse Taint Analyse eingebaut und standardmäßig an Nicht im Kern enthalten
Automatische Fixes psalm --alter für Typen und Annotationen Keine, Fixes laufen meist über Rector
Dead Code Eingebaut, als Graph mit Zyklen Über Extensions
Framework Support Plugins für Symfony, Laravel, PHPUnit mitgeliefert Extensions wie Larastan oder phpstan-symfony
Stärke Datenfluss, Reinheit, Generics Geschwindigkeit, großes Ökosystem

Psalm installieren und auf Version 7 heben

Psalm und PHPStan schließen sich nicht aus. Viele Teams nutzen beide, weil sie unterschiedliche Fehler finden. Für ein neues Projekt installiert ihr Psalm über Composer und erzeugt die Konfiguration.
Code:
          

composer require --dev vimeo/psalm
./vendor/bin/psalm --init

Für ein bestehendes Projekt reicht meist ein Composer Update. Prüft vorher, ob ihr auf 64 Bit PHP 8.2 oder neuer lauft.
Code:
          

composer require --dev vimeo/psalm:^7.0 -W

Eine schlanke 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.
Code:
          

<?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>

In Legacy Code meldet Psalm beim ersten Lauf oft hunderte Fehler. Friert sie mit einer Baseline ein und arbeitet sie Schritt für Schritt ab. Neue Fehler fallen trotzdem sofort auf.
Code:
          

./vendor/bin/psalm --set-baseline=psalm-baseline.xml
./vendor/bin/psalm --alter --issues=MissingReturnType,MissingParamType --dry-run

Prüft jede Änderung von --alter im Diff, bevor ihr sie committet. Wie gut eure Typen schon sind, zeigt euch Type Coverage.

Psalm in GitHub Actions und GitLab CI

Mit --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.
Code:
          

./vendor/bin/psalm --init-ci

In GitLab CI legt ihr einen eigenen Job an. Das Code Climate Format versteht GitLab als Code Quality Report und zeigt die Treffer direkt im Merge Request. Den SARIF Report könnt ihr zusätzlich für Security Dashboards ablegen.
Code:
          

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

Lasst Psalm vor den Tests laufen. Ein Fehler in der statischen Analyse ist billiger als ein roter PHPUnit Lauf. Lokal fängt GrumPHP viele Probleme schon vor dem Commit ab.

Featuring a simply enormous number of new features and bug fixes

Daniil Gentili, Maintainer von Psalm – Announcing Psalm 7, psalm.dev

NCA Erfahrung mit Psalm und Security Analyse

In unseren Projekten laufen Psalm und PHPStan nebeneinander. PHPStan ist schnell und deckt die Breite ab. Psalm schaut tiefer auf Datenflüsse und Reinheit. Mit Psalm 7 kommt die Security Analyse ohne Zusatzaufwand dazu. Gerade wenn Coding Agents viel Code schreiben, ist das ein wichtiger Filter. Eine KI baut schnell eine Abfrage, die Nutzereingaben ungeprüft weiterreicht.
Beim Agentic Coding gehört Psalm an zwei Stellen. Lokal hilft es dem Agenten beim Nachbessern, in der Pipeline entscheidet es über den Merge. Agenten arbeiten bei uns gegen dieselben Quality Gates wie wir selbst. Welche Lücken KI Code typischerweise mitbringt, zeigt unser Beitrag zu Vibe Coding Security.
Bei Legacy Projekten starten wir immer mit Quality Gates. Erst kommen PHPStan und Psalm mit Baseline, dann Functional Tests und Code Coverage. Erst danach wird mit Rector aufgeräumt. Die Baseline arbeiten wir Schritt für Schritt ab, von Hand mit KI Unterstützung und nie als autonomer Lauf eines Agenten. Sicherheitslücken in Abhängigkeiten deckt zusätzlich Composer Audit ab. Mehr zum Zusammenspiel der Tools zeigt unser PHP Glossar.
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 zu Psalm

Hier beantworten wir die Fragen, die Teams beim Einstieg in Psalm und beim Upgrade auf Psalm 7 am häufigsten stellen.
Lohnt sich Psalm 2026 neben PHPStan noch?

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.

Wie hilft Psalm 2026 beim Agentic Coding?

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.

Was ist 2026 die wichtigste Neuerung in Psalm 7?

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.

Welche PHP Versionen unterstützt Psalm 7 im Jahr 2026?

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.

Wie aufwendig ist das Upgrade auf Psalm 7 in 2026?

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.

Erkennt Psalm 2026 auch Prompt Injection in KI Anwendungen?

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.

Was ist Taint Analyse?

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.

Was bedeutet der errorLevel in Psalm?

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.

Was macht psalm --alter?

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.

Brauche ich in Psalm 7 noch das Symfony Plugin?

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.

Wie finde ich toten Code mit Psalm?

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.

Wie binde ich Psalm in GitHub Actions ein?

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.