Riferimenti tecnici

Chi sviluppa con Drupal lavora su uno stack che va oltre il CMS: Symfony, Composer, Twig, strumenti di sviluppo locale, pipeline di test. Questa pagina raccoglie i riferimenti esterni più utili per area, senza pretesa di essere esaustiva. L'obiettivo è ridurre il tempo che si passa a cercare prima di trovare la fonte giusta.

Drupal e Symfony

Drupal è costruito sopra Symfony e conoscere i componenti che il framework mette a disposizione è indispensabile per capire come funziona il core dall'interno.

symfony.com/doc è la documentazione ufficiale di Symfony. Le sezioni più rilevanti per chi lavora con Drupal riguardano il service container e la dependency injection, gli event subscriber, il routing e la gestione delle richieste HTTP. Non tutto si applica direttamente a Drupal, che usa Symfony come libreria e non come framework completo, ma la comprensione di questi componenti fa una differenza concreta durante il debug e lo sviluppo di moduli complessi.

packagist.org è il repository centrale di Composer, dove sono pubblicati tutti i pacchetti PHP dell'ecosistema Drupal. È utile per verificare le versioni disponibili di un modulo, leggere il suo composer.json e controllare le dipendenze transitive prima di installarlo.

Strumenti di sviluppo locale

ddev.com/get-started è il punto di partenza per configurare DDEV, lo strumento raccomandato dalla community per gli ambienti di sviluppo locali. Gestisce PHP, il server web, il database e Drush in container Docker preconfigurati. La documentazione è ben strutturata e copre anche scenari avanzati come la configurazione di servizi aggiuntivi e l'integrazione con PhpStorm.

drush.org/commands è un riferimento rapido ai comandi Drush, organizzato per categoria. Utile quando si conosce l'operazione che si vuole eseguire ma non si ricorda la sintassi esatta del comando.

Frontend e theming

twig.symfony.com è la documentazione ufficiale di Twig, il motore di template usato da Drupal per tutti i suoi layer di presentazione. Covers filtri, funzioni, tag di controllo e l'estensione del linguaggio. Chi scrive template Drupal vi si trova a tornare spesso.

drupal.org/docs/theming-drupal è la guida ufficiale al theming, aggiornata per coprire i Single Directory Components (SDC) e il tema base Starterkit introdotto con Drupal 10. È il riferimento da seguire per chi costruisce temi custom su installazioni moderne.

Testing e qualità del codice

drupal.org/docs/automated-testing documenta il sistema di test automatizzati di Drupal, basato su PHPUnit. Copre i diversi tipi di test disponibili, dai test unitari ai test funzionali con browser, con indicazioni su come strutturarli e come eseguirli in locale e in CI.

phpstan.org è lo strumento di analisi statica del codice PHP più diffuso nell'ecosistema Drupal moderno. Individua errori di tipo, chiamate a metodi inesistenti e incompatibilità prima ancora di eseguire il codice. I progetti Drupal ben mantenuti lo integrano nelle pipeline di CI insieme a PHP_CodeSniffer per l'analisi degli standard di codice.

L'ecosistema Drupal evolve con cadenza regolare: nuove versioni del core, aggiornamenti dei tool, deprecazioni. I riferimenti in questa pagina vengono revisionati periodicamente per restare allineati con le pratiche correnti.