PHP Quality & Security Tools

Statische Analyse, Code-Style-Prüfung und Security-Scanning für PHP. Stellt Codequalität, PSR-12 Konformität, Typsicherheit und OWASP-Compliance sicher.

Verwendung

# Prüfung (dev)
/opt/scripts/php-check.sh

# Prüfung (beliebiges Projekt)
/opt/scripts/php-check.sh /pfad/zum/projekt

# Mit automatischer Korrektur
/opt/scripts/php-check.sh /pfad/zum/projekt --fix

PHPStan + Strict Rules

Statische Analyse für Typsicherheit, Null-Safety und Bug-Erkennung.

PHP-CS-Fixer

Automatische Code-Formatierung nach PSR-12 Standard.

Regeln

• PSR-12 Basis
• Short Array Syntax []
• Single Quotes, Trailing Commas
• Sortierte Imports, keine ungenutzten

Semgrep (OWASP Security)

Pattern-basierter Security Scanner für OWASP-Vulnerabilities.

Erkannte Vulnerabilities

Direkt ausführen

/root/.local/bin/semgrep scan \
    --config /opt/php-tools/semgrep-security.yml \
    src app

Composer Audit

Prüft Composer-Dependencies auf bekannte CVEs.

composer audit --working-dir=/var/www/dev.campus.systemische-tools.de

PHPUnit

Unit-Testing Framework für PHP mit PHP 8 Attributen.

Verwendung

# Tests ausführen (dev)
/opt/scripts/php-test.sh

# Tests ausführen (beliebiges Projekt)
/opt/scripts/php-test.sh /pfad/zum/projekt

# Mit Coverage-Report
/opt/scripts/php-test.sh /pfad/zum/projekt --coverage

Test-Struktur

tests/
└── Unit/
    └── Domain/
        └── ValueObject/
            └── TaskStatusTest.php

Beispiel-Test

#[CoversClass(TaskStatus::class)]
class TaskStatusTest extends TestCase
{
    #[DataProvider('terminalStatusProvider')]
    public function testIsTerminal(TaskStatus $status, bool $expected): void
    {
        $this->assertSame($expected, $status->isTerminal());
    }
}

Automatisierung

PostToolUse Hook (nach jeder Dateiänderung)

Pre-Sync Check (vor Deployment)

Prinzipien & Prüfungen

Scripts im Detail

php-check.sh

Hauptscript für vollständige Qualitäts- und Sicherheitsprüfung. Führt alle 4 Checks sequentiell aus.

Checks

Verwendung

# Dev-Projekt prüfen
/opt/scripts/php-check.sh

# Beliebiges Projekt prüfen
/opt/scripts/php-check.sh /var/www/anderes-projekt

# Mit automatischer Style-Korrektur
/opt/scripts/php-check.sh /var/www/dev.campus.systemische-tools.de --fix

Ausgabe

=== PHP Quality & Security Check: Fri Dec 20 12:00:00 CET 2025 ===
Project: /var/www/dev.campus.systemische-tools.de

[1/4] PHPStan - Static Analysis + Strict Rules
✓ PHPStan: OK

[2/4] PHP-CS-Fixer - Code Style (PSR-12)
✓ PHP-CS-Fixer: OK

[3/4] Composer Audit - Dependency Vulnerabilities
✓ Composer Audit: No vulnerabilities

[4/4] Semgrep - OWASP Security Scan
✓ Semgrep: No vulnerabilities

=== Summary ===
All checks passed!

php-style-check.sh

Schnelle Style-Prüfung für einzelne Dateien. Wird vom PostToolUse Hook verwendet.

Verhalten

• Prüft nur *.php Dateien
• Überspringt View-Dateien (Templates)
• Verwendet PHP-CS-Fixer im Check-Mode
• Gibt nur Warnung aus, blockiert nicht

Verwendung

# Einzelne Datei prüfen
/opt/scripts/php-style-check.sh /var/www/dev.campus.systemische-tools.de/src/Controller/HomeController.php

php-test.sh

PHPUnit Test-Runner für Unit-Tests.

Verwendung

# Tests im dev-Projekt
/opt/scripts/php-test.sh

# Tests in anderem Projekt
/opt/scripts/php-test.sh /var/www/anderes-projekt

# Mit Coverage-Report
/opt/scripts/php-test.sh /var/www/dev.campus.systemische-tools.de --coverage

Ausgabe

=== PHP Unit Tests: Fri Dec 20 12:00:00 CET 2025 ===
Project: /var/www/dev.campus.systemische-tools.de

Found 3 test file(s)

PHPUnit 12.5.4

TaskStatus
 ✓ Is terminal with completed returns true
 ✓ Is terminal with failed returns true
 ✓ Is terminal with pending returns false

✓ All tests passed!

fix-permissions.sh

Setzt Dateiberechtigungen für Web-Verzeichnisse zurück.

Betroffene Verzeichnisse

• /var/www/dev.campus.systemische-tools.de
• /var/www/prod.campus.systemische-tools.de

Verwendung

# Als root ausführen
sudo /opt/scripts/fix-permissions.sh

Wann verwenden

• Nach manuellem Datei-Upload
• Nach Git-Operationen (falls verwendet)
• Bei Permission-Denied Fehlern
• Nach Änderungen durch andere Benutzer

Script-Übersicht

Python Quality Tools

Für die KI-Pipeline unter /opt/scripts/pipeline/ stehen zusätzliche Python-Tools bereit.

python-check.sh

Prüfscript für Python-Code.

Checks

Verwendung

# Prüfung
/opt/scripts/python-check.sh

# Auto-Fix Linting
/opt/scripts/pipeline/venv/bin/ruff check /opt/scripts/pipeline --fix

# Auto-Format
/opt/scripts/pipeline/venv/bin/ruff format /opt/scripts/pipeline