Installare e Configurare Drupal nell’Ambiente di Sviluppo Locale ServBay

Panoramica

Drupal è un potente, flessibile ed estensibile sistema di gestione dei contenuti (CMS) open source, molto usato per creare ogni tipo di sito web: dai blog personali e siti aziendali alle grandi piattaforme enterprise e applicazioni web complesse. Offre strumenti avanzati per la gestione dei contenuti, un controllo granulare dei permessi utente e un'architettura modulare ideale per sviluppatori che richiedono flessibilità e prestazioni elevate.

ServBay è uno strumento di ambiente di sviluppo locale progettato appositamente per macOS che integra i principali server web (come Caddy, Nginx), diversi runtime per linguaggi di programmazione (PHP, Node.js, Python, Go, Java, ecc.), database (MySQL, PostgreSQL, MongoDB, Redis) e strumenti di supporto come Composer, npm, ecc. Installare e configurare Drupal su ServBay fornisce una piattaforma locale stabile, semplice e completa per lo sviluppo web.

Questa guida ti mostrerà passo passo come installare e configurare Drupal in ServBay, aiutandoti a creare velocemente il tuo ambiente di sviluppo locale Drupal.

Prerequisiti

Prima di iniziare l’installazione di Drupal, assicurati di avere:

1. ServBay installato e funzionante: Verifica di aver installato correttamente ServBay su macOS e che sia attivo.
2. Conoscenza base di ServBay: Sapere come gestire i pacchetti, aggiungere siti e accedere agli strumenti integrati (come phpMyAdmin) tramite la UI di ServBay.
3. PHP e MySQL/MariaDB installati: ServBay include diversi PHP e MySQL o MariaDB di default. Assicurati che la versione di PHP che vuoi usare sia abilitata e che il servizio database sia in esecuzione.
4. Composer installato: ServBay integra Composer di default, strumento chiave per la gestione delle dipendenze nei progetti PHP. In questa guida useremo Composer per creare il progetto Drupal.

Passaggi per Installare Drupal

Ecco la procedura dettagliata per installare e configurare Drupal all’interno di ServBay:

Passaggio 1: Crea la Cartella del Progetto

Per prima cosa, crea una cartella dedicata al tuo progetto Drupal nella root dei siti di ServBay: /Applications/ServBay/www.

Apri il Terminale ed esegui:

cd /Applications/ServBay/www
mkdir servbay-drupal-app
cd servbay-drupal-app

In questo modo crei una nuova cartella chiamata servbay-drupal-app nella directory /Applications/ServBay/www e ci entri.

Passaggio 2: Crea il Progetto Drupal con Composer

Composer è già integrato in ServBay; non serve installarne una copia aggiuntiva. Drupal consiglia ufficialmente l’uso di Composer per gestire il progetto e le sue dipendenze.

Dalla directory servbay-drupal-app, lancia il seguente comando:

composer create-project drupal/recommended-project .

Questo comando imposterà un nuovo progetto Drupal nella directory corrente (.) usando il template drupal/recommended-project. Composer scaricherà automaticamente il core di Drupal e tutte le dipendenze. La durata dipende dalla velocità della connessione internet.

Il template drupal/recommended-project organizza i file pubblicamente accessibili (come index.php, file CSS, JavaScript, ecc.) in una sotto-cartella chiamata web. Questo è lo schema standard per i progetti Drupal moderni e ne aumenta la sicurezza.

Passaggio 3: Crea il Database e l’Utente

Drupal richiede un database dove memorizzare contenuti, configurazioni e dati utente. Useremo phpMyAdmin, incluso in ServBay, per creare un nuovo database e un utente dedicato.

1. Accedi a phpMyAdmin di ServBay

   Apri il browser e visita l’indirizzo della dashboard di ServBay: https://servbay.host/. Trova e fai clic su “phpMyAdmin” (di solito nella sezione “Strumenti” o “Database”) per accedere all’interfaccia di phpMyAdmin.

   servbay.host è il dominio dedicato alla gestione di ServBay per lo sviluppo locale.

2. Crea un Utente Database

   Per motivi di sicurezza e gestione dei permessi, si consiglia di creare un utente database specifico per Drupal.

   • Vai alla pagina Utenti: Nella home di phpMyAdmin, clicca su “Account utente” nella barra di navigazione in alto.
   • Aggiungi un nuovo utente: Clicca su “Aggiungi account utente”.
   • Compila i dettagli:
     • Nome utente: Inserisci il nome dell’account, ad esempio drupal_user.
     • Host: Scegli o inserisci localhost per consentire l’accesso solo dalla macchina locale (opzione raccomandata).
     • Password: Scegli una password sicura. Non usare password deboli (nell’esempio password123 è solo illustrativo). Usa in pratica un generatore di password robuste.
     • Reinserisci password: Conferma la password scelta.
   • Permessi del database: Nella sezione “Database per account utente”, seleziona “Crea database con lo stesso nome e garantisci tutti i privilegi”. Questo crea automaticamente un database con lo stesso nome utente (drupal_user) e assegna tutti i privilegi a tale utente sul suo database.
   • Permessi globali: Assicurati che NON sia selezionata l’opzione “Concedi tutti i privilegi globali” (a meno che tu non ne abbia davvero bisogno). Basta che l’utente abbia pieni diritti SOLO sul proprio database.
   • Conferma: Dopo aver verificato tutti i dati, clicca su “Esegui” in basso a destra.

   Ora hai sia un database che un utente chiamati drupal_user, e quest’ultimo ha pieni permessi solo sul suo database.

Passaggio 4: Configura il Server Web (Aggiungi il Sito in ServBay)

Ora devi configurare un nuovo sito in ServBay, associando un dominio locale alla cartella web del tuo progetto Drupal.

1. Avvia ServBay UI: Apri l’interfaccia grafica di ServBay.
2. Aggiungi nuovo sito: Nella barra laterale, clicca su “Siti”.
3. Clicca su Aggiungi: Sulla pagina che mostra i siti, clicca su “+” o sul pulsante per aggiungere un nuovo sito.
4. Compila i dettagli del sito:
   • Nome: Assegna un nome facile da riconoscere, ad esempio My Drupal Site.
   • Dominio: Inserisci il dominio locale che vuoi usare per accedere al sito, es. servbay-drupal.local. ServBay supporta nomi .local senza modificare manualmente il file hosts.
   • Tipo di sito: Seleziona PHP.
   • Versione PHP: Scegli la versione di PHP richiesta, compatibile con la versione di Drupal che installi (consulta la documentazione ufficiale Drupal per i requisiti).
   • Directory root del sito: Questo è molto importante. Indica la sotto-cartella contenente il file di ingresso di Drupal (index.php), ovvero la directory web creata da Composer: /Applications/ServBay/www/servbay-drupal-app/web.
5. Salva la configurazione: Dopo aver inserito tutte le informazioni, clicca su “Salva” (o simile) per completare la configurazione. ServBay aggiornerà automaticamente i file di configurazione del server web.

Passaggio 5: Avvia l’Installer di Drupal

Ora puoi lanciare la procedura di installazione web di Drupal tramite il browser.

1. Accedi alla pagina di installazione

   Apri il browser e visita il dominio locale che hai configurato, aggiungendo /core/install.php: https://servbay-drupal.local/core/install.php.

   Dovresti vedere il wizard di installazione di Drupal.

2. Seleziona la lingua

   Scegli la lingua predefinita con cui vuoi installare Drupal, quindi clicca su “Salva e continua”.

3. Tipo di installazione

   Scegli il tipo di installazione desiderato. In genere si consiglia “Standard” per avere una configurazione base già pronta. Clicca su “Salva e continua”.

4. Imposta i dati del database

   L’installer ti chiederà i dettagli di connessione al database. Inserisci quanto hai creato nel Passaggio 3:

   • Tipo database: Seleziona MySQL, MariaDB, Percona Server, o equivalente.
   • Nome database: drupal_user (come il nome del database appena creato).
   • Nome utente database: drupal_user (uguale all’utente).
   • Password database: la password scelta per drupal_user.
   • Host database: localhost.
   • Opzioni avanzate: Normalmente possono essere lasciate invariate, salvo tu abbia configurazioni specifiche (porta non standard, ecc.).

   Dopo aver compilato tutto, clicca su “Salva e continua”. Drupal si connetterà al database e importerà i dati di default.

5. Configura le informazioni del sito

   Se la connessione va a buon fine, accedi alla fase di configurazione del sito. Completa i seguenti campi:

   • Nome del sito: Il titolo del tuo sito Drupal.
   • Email del sito: L’indirizzo email usato da Drupal per le notifiche.
   • Nome utente amministratore: L’username da usare per entrare nel backend.
   • Password amministratore: Scegli una password sicura per l’amministrazione.
   • Paese: Scegli il paese di riferimento.
   • Fuso orario: Imposta il fuso orario.

   Quando hai finito, clicca su “Salva e continua”. Drupal completa i passaggi finali e genera i file di configurazione essenziali.

6. Fine installazione

   Al termine, verrai indirizzato alla homepage del nuovo sito Drupal. Complimenti! Drupal è installato e funzionante in ServBay.

Passaggio 6: Installa Moduli e Temi (Introduzione)

Il vero punto di forza di Drupal è il suo ecosistema di moduli e temi. Dopo aver installato il core, puoi ampliare facilmente le funzionalità e l’aspetto del sito.

1. Fai login nel backend: Vai su https://servbay-drupal.local/user oppure https://servbay-drupal.local/admin ed effettua il login con le credenziali scelte nel Passaggio 5.
2. Installa moduli: Una volta loggato, nel menu amministrativo trova la voce “Estendi” (Extend) per sfogliare, cercare e installare nuovi moduli.
3. Installa temi: Vai in “Aspetto” (Appearance) per installare e scegliere nuovi temi grafici.

Configurazioni Aggiuntive e Utilizzo Post-Installazione

Dopo aver installato Drupal puoi iniziare a costruire il tuo sito. Ecco alcune azioni comuni da cui partire:

Crea Tipi di Contenuto e Inserisci Dati

Il cuore di Drupal sono i tipi di contenuto, che definiscono la struttura di articoli, pagine, ecc.

1. Crea tipi di contenuto: Dal backend vai in “Struttura” → “Tipi di contenuto”. Puoi modificare i tipi esistenti o crearne di nuovi, impostando i campi come titolo, testo, immagini, ecc.
2. Crea contenuti: Vai su “Contenuti” → “Aggiungi contenuto”, seleziona il tipo desiderato, compila i campi e clicca su “Salva e pubblica”.

Configura i Menu di Navigazione

I menu servono per organizzare la navigazione del sito.

1. Crea menu: Nel backend, vai su “Struttura” → “Menu”. Puoi crearne di nuovi o modificare quelli esistenti.
2. Aggiungi voci al menu: Entra in un menu e clicca su “Aggiungi collegamento”, inserisci il nome e il percorso (ad esempio /node/1 o una URL esterna) e salva.

Personalizza la Disposizione dei Blocchi

I blocchi sono elementi di contenuto che puoi posizionare nelle aree del sito (come sidebar o footer).

1. Aggiungi blocchi: In “Struttura” → “Blocchi”, visualizzerai le aree previste dal tema. Puoi distribuire blocchi standard (menu, contenuti personalizzati, ecc.) trascinandoli nelle varie aree.
2. Configura blocchi: Clicca su “Configura” accanto al blocco per modificarne titolo, visibilità per pagina o ruolo utente, ecc.

Note e Domande Frequenti (FAQ)

• Come modificare la configurazione di PHP? Se Drupal richiede estensioni PHP specifiche o limiti di memoria maggiori (memory_limit), nella UI di ServBay seleziona il PHP desiderato nella sezione “Pacchetti” e modifica il file php.ini tramite il pulsante configurazione. Dopo le modifiche riavvia il servizio PHP (ServBay mostrerà eventuali avvisi o lo farà automaticamente).
• Perché il sito non è raggiungibile?
  • Assicurati che ServBay sia in esecuzione.
  • Ricontrolla che la configurazione del sito (dominio, root) sia corretta. La root deve puntare a .../servbay-drupal-app/web.
  • Verifica che il server web (Caddy o Nginx) sia attivo.
  • Accertati di accedere a https://servbay-drupal.local e al percorso giusto (durante l’installazione: https://servbay-drupal.local/core/install.php).
• Problema di connessione col database?
  • Controlla che nome, utente e password inseriti per il database corrispondano a quelli creati in phpMyAdmin.
  • Verifica che come host sia impostato localhost.
  • Assicurati che MySQL/MariaDB sia in funzione su ServBay.
• Errori con le dipendenze Composer? Controlla la connessione internet, assicurati che Composer acceda a packagist.org. In caso di problemi, svuota la cache di Composer o aggiorna Composer (ServBay lo aggiorna periodicamente).
• Problemi di permessi sui file? Drupal necessita di permessi di scrittura su alcune directory come web/sites/default/files e web/sites/default/settings.php. ServBay usa di default l’utente corrente macOS, prevenendo solitamente problemi di permessi. Se capitano errori, controlla manualmente i permessi su queste cartelle.

Conclusione

Seguendo questa guida, hai installato e configurato Drupal con successo nell’ambiente di sviluppo locale ServBay. ServBay offre una piattaforma efficace e completa per sviluppare con Drupal, integrando tutti i componenti necessari in modo rapido e gestibile. Ora puoi sfruttare Drupal per costruire il tuo sito e usare ServBay per sviluppare, testare e effettuare debugging in locale. Quando crescerai insieme a Drupal, la flessibilità di ServBay ti consentirà di gestire facilmente versioni PHP diverse, database e altre tecnologie, adattandosi perfettamente alle esigenze dei tuoi progetti.