Kontakt
Entwicklung

PHP Structured Edit

Ändert PHP-Code über AST-Selektoren, typisierte Operationen und Hash-Prüfungen. Unterstützt mehrere Dateien; Syntaxprüfung ersetzt keine Verhaltenstests.

Neuestes Release v2.0.1

Installation

Wähle einen unterstützten Installationsweg. Paketumfang, Einbindung in den Agent und benötigte Laufzeitwerkzeuge können sich unterscheiden.

  1. Claude Code über diesen Marketplace 
    /plugin install php-structured-edit@netresearch-claude-code-marketplace

    Zuerst den Marketplace einmal in Claude Code hinzufügen: /plugin marketplace add netresearch/claude-code-marketplace. Bindet die Agent-Anweisungen des Plugins ein. Die PHP-Engine wird getrennt eingerichtet: Engine installieren Benötigt PHP 8.2+, JSON und Tokenizer. Die Plugin-Installation aus dem Repository installiert keine Composer-Abhängigkeiten.

  2. npx Skills gezielt auswählen 
    npx skills add https://github.com/netresearch/php-ast-edit-skill

    Benötigt Node.js 22.20+. Im Zielprojekt ausführen und anschließend Skills und Agents im Installer auswählen. Installiert die Skill-Anweisungen. Die PHP-Engine ist ein eigener Bestandteil: Engine installieren Vor einem Änderungsauftrag prüfen, ob Wrapper und Engine eingerichtet sind.

  3. composer require PHP-Projekt, als Paket 
    composer require --dev --no-plugins --no-scripts netresearch/php-ast-edit-skill:^2.0

    Installiert die veröffentlichte PHP-Engine aus der 2.x-Reihe; Composer-Plugins und Projektskripte bleiben für diesen Befehl deaktiviert. Die Agent-Anweisungen werden getrennt eingebunden: Installationsanleitung Benötigt Composer 2.2+ und PHP 8.2+ mit JSON und Tokenizer. Die composer.lock des Zielprojekts hält die aufgelösten Versionen fest.

  4. composer skills:add PHP-Projekt, direkte Quelle 
    composer skills:add netresearch/php-ast-edit-skill

    Zuerst netresearch/composer-agent-skill-plugin installieren und aktivieren; die Skill-Einbindung der gewählten Quelle freigeben. Benötigt den Composer-Skill-Installer und bindet Anweisungen ein. Die PHP-Abhängigkeiten der Engine werden dabei nicht installiert: Engine installieren Die Engine getrennt einrichten und prüfen.

Wofür du das Paket einsetzt

  • PHP-Symbole gezielt auswählen und zusammengehörige Änderungen über mehrere Dateien ausführen.
  • Veraltete Quellstände und mehrdeutige Ziele vor dem Schreiben erkennen; anschließend Diff und passende Projekttests prüfen.

Ergebnisse und Beispiele

  • Eine durch Ziel- und Hash-Prüfungen abgesicherte Änderung, ein Diff und getrennte Ergebnisse für Parser, Lint und konfigurierte Projektprüfungen.
  • Inspektionsaufrufe liefern Knoteninformationen und Quell-Hash; abgelehnte Aufträge liefern maschinenlesbare Fehler.

Voraussetzungen im Projekt

  • Gewünschte Änderung und gegebenenfalls den Quellstand angeben, aus dem die Ziele gewählt wurden; die Arbeitskopie muss beschreibbar sein.
  • Die Engine benötigt PHP 8.2+, JSON- und Tokenizer-Erweiterungen sowie nikic/php-parser. Eine reine Skill-Installation richtet die Engine nicht automatisch ein.
  • Projektformatierung und Prüfkommandos sind optional konfigurierbar. Für projektweite Methoden-Renames gilt die separate Resolver-Anleitung.

Tags

  • development
  • quality-security