{
"tool_response": [
{
"type": "text",
"text": "{\n \"success\": true,\n \"doc\": {\n \"id\": 62,\n \"parent_id\": 61,\n \"slug\": \"php-quality\",\n \"path\": \"\/qualitaet\/php-quality\",\n \"title\": \"PHP-Quality\",\n \"description\": \"Statische Analyse, Code-Style-Prüfung und Security-Scanning für PHP. Stellt Codequalität, PSR-12 Konformität, Typsicherheit und OWASP-Compliance sicher.\",\n \"content\": \"<nav class=\\\"breadcrumb\\\">\\n <a href=\\\"\/docs\\\">Dokumentation<\/a> » <a href=\\\"\/docs\/anwendungen\\\">Anwendungen<\/a> » PHP Quality Tools\\n<\/nav>\\n\\n<h1>PHP Quality & Security Tools<\/h1>\\n<p>Statische Analyse, Code-Style-Prüfung und Security-Scanning für PHP. Stellt Codequalität, PSR-12 Konformität, Typsicherheit und OWASP-Compliance sicher.<\/p>\\n\\n<table>\\n <tr><th>PHPStan<\/th><td>2.1.33 + Strict Rules<\/td><\/tr>\\n <tr><th>PHP-CS-Fixer<\/th><td>3.92.3<\/td><\/tr>\\n <tr><th>Semgrep<\/th><td>1.146.0 (OWASP Scanner)<\/td><\/tr>\\n <tr><th>PHPUnit<\/th><td>12.5.4<\/td><\/tr>\\n <tr><th>Composer Audit<\/th><td>CVE-Check für Dependencies<\/td><\/tr>\\n <tr><th>Installation<\/th><td>\/opt\/php-tools\/<\/td><\/tr>\\n <tr><th>Scripts<\/th><td>php-check.sh, php-style-check.sh, php-test.sh, fix-permissions.sh<\/td><\/tr>\\n<\/table>\\n\\n<h2>Verwendung<\/h2>\\n<pre><code># Prüfung (dev)\\n\/opt\/scripts\/php-check.sh\\n\\n# Prüfung (beliebiges Projekt)\\n\/opt\/scripts\/php-check.sh \/pfad\/zum\/projekt\\n\\n# Mit automatischer Korrektur\\n\/opt\/scripts\/php-check.sh \/pfad\/zum\/projekt --fix<\/code><\/pre>\\n\\n<h2>PHPStan + Strict Rules<\/h2>\\n<p>Statische Analyse für Typsicherheit, Null-Safety und Bug-Erkennung.<\/p>\\n<table>\\n <tr><th>Level<\/th><td>5 (von 10)<\/td><\/tr>\\n <tr><th>Strict Rules<\/th><td>phpstan-strict-rules 2.0.7<\/td><\/tr>\\n <tr><th>Konfig<\/th><td>\/opt\/php-tools\/phpstan.neon<\/td><\/tr>\\n <tr><th>Scope<\/th><td>src\/, app\/ (ohne View\/)<\/td><\/tr>\\n<\/table>\\n\\n<h2>PHP-CS-Fixer<\/h2>\\n<p>Automatische Code-Formatierung nach PSR-12 Standard.<\/p>\\n<table>\\n <tr><th>Standard<\/th><td>PSR-12<\/td><\/tr>\\n <tr><th>Konfig<\/th><td>\/opt\/php-tools\/.php-cs-fixer.php<\/td><\/tr>\\n<\/table>\\n\\n<h3>Regeln<\/h3>\\n<ul>\\n <li>PSR-12 Basis<\/li>\\n <li>Short Array Syntax <code>[]<\/code><\/li>\\n <li>Single Quotes, Trailing Commas<\/li>\\n <li>Sortierte Imports, keine ungenutzten<\/li>\\n<\/ul>\\n\\n<h2>Semgrep (OWASP Security)<\/h2>\\n<p>Pattern-basierter Security Scanner für OWASP-Vulnerabilities.<\/p>\\n<table>\\n <tr><th>Version<\/th><td>1.146.0<\/td><\/tr>\\n <tr><th>Konfig<\/th><td>\/opt\/php-tools\/semgrep-security.yml<\/td><\/tr>\\n <tr><th>Installation<\/th><td>\/root\/.local\/bin\/semgrep (pipx)<\/td><\/tr>\\n<\/table>\\n\\n<h3>Erkannte Vulnerabilities<\/h3>\\n<table>\\n <tr><th>Typ<\/th><th>OWASP<\/th><th>CWE<\/th><\/tr>\\n <tr><td>Cross-Site Scripting (XSS)<\/td><td>A03:2021<\/td><td>CWE-79<\/td><\/tr>\\n <tr><td>XML External Entity (XXE)<\/td><td>A05:2021<\/td><td>CWE-611<\/td><\/tr>\\n <tr><td>Server-Side Template Injection (SSTI)<\/td><td>A03:2021<\/td><td>CWE-1336<\/td><\/tr>\\n <tr><td>Server-Side Request Forgery (SSRF)<\/td><td>A10:2021<\/td><td>CWE-918<\/td><\/tr>\\n <tr><td>Cross-Site Request Forgery (CSRF)<\/td><td>A01:2021<\/td><td>CWE-352<\/td><\/tr>\\n <tr><td>Command Injection<\/td><td>A03:2021<\/td><td>CWE-78<\/td><\/tr>\\n <tr><td>SQL Injection<\/td><td>A03:2021<\/td><td>CWE-89<\/td><\/tr>\\n <tr><td>File Inclusion<\/td><td>A03:2021<\/td><td>CWE-98<\/td><\/tr>\\n <tr><td>Path Traversal<\/td><td>A01:2021<\/td><td>CWE-22<\/td><\/tr>\\n <tr><td>Eval\/Code Injection<\/td><td>A03:2021<\/td><td>CWE-94<\/td><\/tr>\\n <tr><td>Unsafe Deserialization<\/td><td>A08:2021<\/td><td>CWE-502<\/td><\/tr>\\n <tr><td>Header Injection<\/td><td>A03:2021<\/td><td>CWE-113<\/td><\/tr>\\n <tr><td>LDAP Injection<\/td><td>A03:2021<\/td><td>CWE-90<\/td><\/tr>\\n<\/table>\\n\\n<h3>Direkt ausführen<\/h3>\\n<pre><code>\/root\/.local\/bin\/semgrep scan \\\\\\n --config \/opt\/php-tools\/semgrep-security.yml \\\\\\n src app<\/code><\/pre>\\n\\n<h2>Composer Audit<\/h2>\\n<p>Prüft Composer-Dependencies auf bekannte CVEs.<\/p>\\n<pre><code>composer audit --working-dir=\/var\/www\/dev.campus.systemische-tools.de<\/code><\/pre>\\n\\n<h2>PHPUnit<\/h2>\\n<p>Unit-Testing Framework für PHP mit PHP 8 Attributen.<\/p>\\n<table>\\n <tr><th>Version<\/th><td>12.5.4<\/td><\/tr>\\n <tr><th>Konfig<\/th><td>\/opt\/php-tools\/phpunit.xml<\/td><\/tr>\\n <tr><th>Bootstrap<\/th><td>\/opt\/php-tools\/bootstrap.php<\/td><\/tr>\\n <tr><th>Script<\/th><td>\/opt\/scripts\/php-test.sh<\/td><\/tr>\\n<\/table>\\n\\n<h3>Verwendung<\/h3>\\n<pre><code># Tests ausführen (dev)\\n\/opt\/scripts\/php-test.sh\\n\\n# Tests ausführen (beliebiges Projekt)\\n\/opt\/scripts\/php-test.sh \/pfad\/zum\/projekt\\n\\n# Mit Coverage-Report\\n\/opt\/scripts\/php-test.sh \/pfad\/zum\/projekt --coverage<\/code><\/pre>\\n\\n<h3>Test-Struktur<\/h3>\\n<pre><code>tests\/\\n└── Unit\/\\n └── Domain\/\\n └── ValueObject\/\\n └── TaskStatusTest.php<\/code><\/pre>\\n\\n<h3>Beispiel-Test<\/h3>\\n<pre><code>#[CoversClass(TaskStatus::class)]\\nclass TaskStatusTest extends TestCase\\n{\\n #[DataProvider('terminalStatusProvider')]\\n public function testIsTerminal(TaskStatus $status, bool $expected): void\\n {\\n $this->assertSame($expected, $status->isTerminal());\\n }\\n}<\/code><\/pre>\\n\\n<h2>Automatisierung<\/h2>\\n\\n<h3>PostToolUse Hook (nach jeder Dateiänderung)<\/h3>\\n<table>\\n <tr><th>Trigger<\/th><td>Edit, Write auf *.php<\/td><\/tr>\\n <tr><th>Script<\/th><td>\/opt\/scripts\/php-style-hook.py<\/td><\/tr>\\n <tr><th>Prüfung<\/th><td>PHP-CS-Fixer (nur Style)<\/td><\/tr>\\n <tr><th>Verhalten<\/th><td>Warnung, kein Block<\/td><\/tr>\\n<\/table>\\n\\n<h3>Pre-Sync Check (vor Deployment)<\/h3>\\n<table>\\n <tr><th>Trigger<\/th><td>\/opt\/scripts\/sync-dev-prod.sh<\/td><\/tr>\\n <tr><th>Prüfung<\/th><td>PHPStan + PHP-CS-Fixer + Composer Audit + Semgrep + PHPUnit<\/td><\/tr>\\n <tr><th>Verhalten<\/th><td>Blockiert bei Fehlern oder fehlgeschlagenen Tests<\/td><\/tr>\\n<\/table>\\n\\n<h2>Prinzipien & Prüfungen<\/h2>\\n<table>\\n <tr><th>Prinzip<\/th><th>Bedeutung<\/th><th>Tool<\/th><\/tr>\\n <tr><td>PSR-12<\/td><td>Code Style<\/td><td>PHP-CS-Fixer<\/td><\/tr>\\n <tr><td>Type Safety<\/td><td>Typsicherheit<\/td><td>PHPStan + Strict Rules<\/td><\/tr>\\n <tr><td>OWASP<\/td><td>Security Vulnerabilities<\/td><td>Semgrep<\/td><\/tr>\\n <tr><td>CVE<\/td><td>Dependency Vulnerabilities<\/td><td>Composer Audit<\/td><\/tr>\\n <tr><td>Unit Tests<\/td><td>Verhaltens-Verifikation<\/td><td>PHPUnit<\/td><\/tr>\\n <tr><td>DRY\/KISS\/YAGNI<\/td><td>Clean Code<\/td><td>Manuell \/ Review<\/td><\/tr>\\n<\/table>\\n\\n<h2>Scripts im Detail<\/h2>\\n\\n<h3>php-check.sh<\/h3>\\n<p>Hauptscript für vollständige Qualitäts- und Sicherheitsprüfung. Führt alle 4 Checks sequentiell aus.<\/p>\\n<table>\\n <tr><th>Pfad<\/th><td>\/opt\/scripts\/php-check.sh<\/td><\/tr>\\n <tr><th>Default-Projekt<\/th><td>\/var\/www\/dev.campus.systemische-tools.de<\/td><\/tr>\\n <tr><th>Exit-Code<\/th><td>0 = alle OK, 1 = mindestens ein Fehler<\/td><\/tr>\\n<\/table>\\n\\n<h4>Checks<\/h4>\\n<table>\\n <tr><th>#<\/th><th>Check<\/th><th>Prüft<\/th><th>Blockiert bei<\/th><\/tr>\\n <tr><td>1<\/td><td>PHPStan<\/td><td>Typen, Null-Safety, Bugs<\/td><td>Errors<\/td><\/tr>\\n <tr><td>2<\/td><td>PHP-CS-Fixer<\/td><td>PSR-12 Code Style<\/td><td>Style Issues<\/td><\/tr>\\n <tr><td>3<\/td><td>Composer Audit<\/td><td>Dependency CVEs<\/td><td>Vulnerabilities<\/td><\/tr>\\n <tr><td>4<\/td><td>Semgrep<\/td><td>OWASP Security<\/td><td>Security Findings<\/td><\/tr>\\n<\/table>\\n\\n<h4>Verwendung<\/h4>\\n<pre><code># Dev-Projekt prüfen\\n\/opt\/scripts\/php-check.sh\\n\\n# Beliebiges Projekt prüfen\\n\/opt\/scripts\/php-check.sh \/var\/www\/anderes-projekt\\n\\n# Mit automatischer Style-Korrektur\\n\/opt\/scripts\/php-check.sh \/var\/www\/dev.campus.systemische-tools.de --fix<\/code><\/pre>\\n\\n<h4>Ausgabe<\/h4>\\n<pre><code>=== PHP Quality & Security Check: Fri Dec 20 12:00:00 CET 2025 ===\\nProject: \/var\/www\/dev.campus.systemische-tools.de\\n\\n[1\/4] PHPStan - Static Analysis + Strict Rules\\n✓ PHPStan: OK\\n\\n[2\/4] PHP-CS-Fixer - Code Style (PSR-12)\\n✓ PHP-CS-Fixer: OK\\n\\n[3\/4] Composer Audit - Dependency Vulnerabilities\\n✓ Composer Audit: No vulnerabilities\\n\\n[4\/4] Semgrep - OWASP Security Scan\\n✓ Semgrep: No vulnerabilities\\n\\n=== Summary ===\\nAll checks passed!<\/code><\/pre>\\n\\n<h3>php-style-check.sh<\/h3>\\n<p>Schnelle Style-Prüfung für einzelne Dateien. Wird vom PostToolUse Hook verwendet.<\/p>\\n<table>\\n <tr><th>Pfad<\/th><td>\/opt\/scripts\/php-style-check.sh<\/td><\/tr>\\n <tr><th>Verwendung<\/th><td>PostToolUse Hook (nach Edit\/Write)<\/td><\/tr>\\n <tr><th>Exit-Code<\/th><td>0 = OK, 1 = Style Issues (Warnung)<\/td><\/tr>\\n<\/table>\\n\\n<h4>Verhalten<\/h4>\\n<ul>\\n <li>Prüft nur *.php Dateien<\/li>\\n <li>Überspringt View-Dateien (Templates)<\/li>\\n <li>Verwendet PHP-CS-Fixer im Check-Mode<\/li>\\n <li>Gibt nur Warnung aus, blockiert nicht<\/li>\\n<\/ul>\\n\\n<h4>Verwendung<\/h4>\\n<pre><code># Einzelne Datei prüfen\\n\/opt\/scripts\/php-style-check.sh \/var\/www\/dev.campus.systemische-tools.de\/src\/Controller\/HomeController.php<\/code><\/pre>\\n\\n<h3>php-test.sh<\/h3>\\n<p>PHPUnit Test-Runner für Unit-Tests.<\/p>\\n<table>\\n <tr><th>Pfad<\/th><td>\/opt\/scripts\/php-test.sh<\/td><\/tr>\\n <tr><th>Default-Projekt<\/th><td>\/var\/www\/dev.campus.systemische-tools.de<\/td><\/tr>\\n <tr><th>Tests-Verzeichnis<\/th><td>tests\/<\/td><\/tr>\\n <tr><th>Coverage-Output<\/th><td>coverage\/ (HTML)<\/td><\/tr>\\n<\/table>\\n\\n<h4>Verwendung<\/h4>\\n<pre><code># Tests im dev-Projekt\\n\/opt\/scripts\/php-test.sh\\n\\n# Tests in anderem Projekt\\n\/opt\/scripts\/php-test.sh \/var\/www\/anderes-projekt\\n\\n# Mit Coverage-Report\\n\/opt\/scripts\/php-test.sh \/var\/www\/dev.campus.systemische-tools.de --coverage<\/code><\/pre>\\n\\n<h4>Ausgabe<\/h4>\\n<pre><code>=== PHP Unit Tests: Fri Dec 20 12:00:00 CET 2025 ===\\nProject: \/var\/www\/dev.campus.systemische-tools.de\\n\\nFound 3 test file(s)\\n\\nPHPUnit 12.5.4\\n\\nTaskStatus\\n ✓ Is terminal with completed returns true\\n ✓ Is terminal with failed returns true\\n ✓ Is terminal with pending returns false\\n\\n✓ All tests passed!<\/code><\/pre>\\n\\n<h3>fix-permissions.sh<\/h3>\\n<p>Setzt Dateiberechtigungen für Web-Verzeichnisse zurück.<\/p>\\n<table>\\n <tr><th>Pfad<\/th><td>\/opt\/scripts\/fix-permissions.sh<... [TRUNCATED-e485843c94e7947f]"
}
]
}