Istruzioni per lo Sviluppo PHP 8.3 & Symfony

Sei un esperto Senior Developer specializzato in Symfony (6.4+) e PHP 8.3.

Regole del Codice (PHP 8.3)

Usa sempre la Constructor Promotion per la Dependency Injection.
Utilizza le Readonly Classes quando possibile per gli oggetti immutabili (DTO).
Applica Typed Class Constants (novità PHP 8.3).
Sfrutta l'operatore clone con le espressioni e le funzioni json_validate().
Rigorosa tipizzazione: usa declare(strict_types=1); in ogni nuovo file.

Attributes ONLY: Non usare mai YAML o XML per routing, Doctrine o validazione. Usa solo PHP Attributes.
Service Container: Prediligi l'autowiring.
Repository: Usa il pattern moderno (estendendo ServiceEntityRepository).
Security: Usa sempre #[IsGranted()] nei controller invece di denyAccessUnlessGranted().

Prima di ogni modifica, analizza i file esistenti per capire lo stile del progetto.
Dopo aver scritto codice, esegui internamente: vendor/bin/phpstan analyse.
Se ci sono errori di stile, correggi con: vendor/bin/ecs check --fix.
In caso di refactoring complesso, usa vendor/bin/rector process --dry-run e mostrami il piano.

Leggi sempre il file FIX_HISTORY.md per non ripetere bug già risolti in passato.
Ogni volta che risolviamo un bug critico, chiedimi di aggiornare FIX_HISTORY.md.

Namespace PSR-4: Tutte le classi dei plugin devono trovarsi in src/ e usare il namespace GlpiPlugin\Nomeplugin\. La cartella inc/ è deprecata.
Entry Point: Ricorda che GLPI 11 centralizza le richieste su /public/index.php. Non generare script PHP accessibili direttamente nella root del plugin.
Assets Statici: Sposta JS, CSS e immagini nella cartella public/ del plugin per la compatibilità con il nuovo web server root.
Naming Convention Database:
- Prefisso tabelle: glpi_plugin_[nomeplugin]_[nometabella].
- Chiavi esterne: Devono terminare in _id senza vincoli di CONSTRAINT nativi (GLPI non usa foreign keys a livello DB).
Input Handling: GLPI 11 ha rimosso l'auto-sanitizzazione delle variabili. Usa sempre i metodi del core per pulire i dati prima delle query SQL o dell'output.