Installare e Configurare Craft CMS nell'Ambiente ServBay

Panoramica

Craft CMS è un potente sistema di gestione dei contenuti (CMS), molto apprezzato dagli sviluppatori per la sua modellazione flessibile dei contenuti, l'interfaccia utente intuitiva e le funzionalità pensate per chi sviluppa. È ideale per la creazione di siti web complessi e altamente personalizzati.

Utilizzare ServBay come ambiente di sviluppo locale per Craft CMS offre numerosi vantaggi, tra cui PHP preconfigurato, database (come MySQL o PostgreSQL) e web server (Caddy o Nginx), oltre a Composer e strumenti da riga di comando integrati, che semplificano notevolmente il processo di installazione e configurazione.

Questa guida illustra passo dopo passo come installare e configurare un progetto Craft CMS con ServBay.

Prerequisiti

Prima di iniziare, assicurati di avere quanto segue:

1. ServBay installato e attivo: Verifica di aver installato ServBay su macOS con successo e che la versione di PHP richiesta (consulta i requisiti ufficiali di Craft CMS) e il database necessario (generalmente MySQL o PostgreSQL) siano in esecuzione. ServBay supporta più versioni di PHP e diversi database; puoi cambiare e configurare l'ambiente facilmente in base alle necessità di Craft CMS.
2. Familiarità con la linea di comando: Sarà necessario eseguire alcuni comandi da terminale, come creare directory e avviare Composer.
3. Conoscenze di Composer: Craft CMS utilizza Composer per la gestione delle dipendenze. Composer è già incluso in ServBay, ma dovrai sapere come eseguire il comando composer create-project.

Procedimento per l'Installazione di Craft CMS

Ecco nel dettaglio i passaggi per installare e configurare Craft CMS nell'ambiente ServBay.

Passo 1: Creare la directory del progetto

Per prima cosa, crea una nuova directory per il progetto nella cartella radice predefinita di ServBay /Applications/ServBay/www. Questa directory è già configurata in ServBay come root server, così potrai accedere facilmente al progetto dal browser.

Apri il terminale ed esegui:

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

Questo comando crea una nuova cartella chiamata servbay-craft-app sotto /Applications/ServBay/www e vi accede.

Passo 2: Creare il progetto Craft CMS con Composer

Poiché ServBay include Composer di default, puoi usarlo direttamente per creare un nuovo progetto Craft CMS nella directory appena creata. L'installazione tramite Composer è la modalità raccomandata ufficialmente da Craft CMS.

Dalla directory servbay-craft-app, esegui:

composer create-project craftcms/craft .

Questo comando scarica l'ultima versione di Craft CMS e tutte le sue dipendenze nella directory corrente (.). Attendi il completamento dell'operazione.

Passo 3: Creare database e utente

Craft CMS richiede un database per salvare contenuti e impostazioni. Useremo phpMyAdmin o Adminer forniti con ServBay per creare un database e un utente. Prenderemo come riferimento phpMyAdmin.

1. Accedi allo strumento di gestione database (phpMyAdmin)

   Apri il browser e accedi al pannello di sviluppo locale di ServBay: https://servbay.host/. Nel pannello, trova e clicca su "phpMyAdmin" per aprire lo strumento di gestione database.

   Suggerimento: L'utente predefinito di phpMyAdmin in ServBay è di solito root, con password ServBay.dev. Per maggiore sicurezza, consigliamo di cambiare subito la password di root o creare un nuovo utente amministratore dopo l'accesso.

2. Creare un nuovo utente database

   Anche se puoi connettere Craft CMS come utente root, per motivi di sicurezza e una migliore gestione dei permessi si consiglia di creare un utente dedicato per ogni applicazione.

   1. Vai alla pagina degli account utente

      Dalla home page di phpMyAdmin, clicca sulla scheda "Account utente" nel menu superiore.

   2. Aggiungi un nuovo account

      Clicca su "Aggiungi account utente" e compila i seguenti dati:

      • Nome utente: Inserisci un nome per l'utente che utilizzerai con Craft CMS, ad esempio craft_user.
      • Host: Seleziona localhost o locale per permettere all'utente di connettersi solo localmente.
      • Password: Inserisci una password sicura. Evita di usare password123, specialmente in ambienti di produzione. In locale puoi utilizzare una password più semplice, ma cerca comunque di mantenere buone pratiche di sicurezza.
      • Conferma password: Inserisci nuovamente la password.
      • Nella sezione "Crea un database denominato come l'utente e assegna tutti i privilegi", seleziona questa opzione. Verrà così creato automaticamente un database chiamato craft_user e assegnati tutti i permessi all'utente corrispondente.
      • Assicurati che sia spuntata l'opzione "Assegna tutti i privilegi".
      • In fondo alla pagina, clicca su "Esegui".

   Adesso hai creato l'utente database craft_user e il relativo database con i permessi necessari.

Passo 4: Configurazione del Web Server (creare il sito in ServBay)

Per permettere al server web di ServBay (Caddy o Nginx) di servire il progetto Craft CMS, devi aggiungere una nuova configurazione "Sito" in ServBay.

1. Apri l'applicazione ServBay

   Avvia ServBay.

2. Aggiungi un nuovo sito

   Dal menu laterale sinistro dell'app, clicca sulla voce "Siti" (in alcune versioni potrebbe essere chiamata “Host”). Poi clicca su "+" o sul bottone "Aggiungi sito" per aprire il modulo di configurazione.

   Compila questi campi:

   • Nome: Dai un nome riconoscibile al sito, ad esempio My Craft Site.
   • Dominio: Inserisci il dominio che vuoi usare in locale, per esempio servbay-craft.local. ServBay aggiornerà il DNS locale automaticamente per permettere la navigazione tramite questo dominio.
   • Tipo di sito: Scegli PHP.
   • Versione PHP: Seleziona la versione PHP compatibile con Craft CMS, come verificato nei prerequisiti. ServBay consente di installare e gestire più versioni di PHP in contemporanea.
   • Document Root: Questo passo è cruciale. I file accessibili pubblicamente di Craft CMS (come index.php) si trovano nella sottocartella web della directory del progetto. Per motivi di sicurezza, imposta la root del sito web sulla directory web e non sulla root dell'intero progetto. Inserisci: /Applications/ServBay/www/servbay-craft-app/web Assicurati che il path sia corretto e punti effettivamente alla sottocartella web creata nel passo 1.

3. Salva la configurazione

   Dopo aver compilato il modulo, clicca su "Salva". ServBay ricaricherà la configurazione del server web rendendo attiva la nuova impostazione. Potrai vedere il nuovo sito servbay-craft.local nella lista dei siti disponibili di ServBay.

Passo 5: Avviare l'installazione guidata di Craft CMS

Ora puoi accedere al dominio configurato dal browser per lanciare la procedura web di installazione di Craft CMS.

1. Accedi alla pagina di installazione

   Vai su https://servbay-craft.local/. Craft CMS rileverà che deve essere installato e ti reindirizzerà sulla procedura guidata, di solito a https://servbay-craft.local/index.php?p=admin/install.

2. Immetti i dati del database

   Nei passaggi di configurazione del database nella procedura di installazione di Craft CMS, inserisci le informazioni create nel passo 3:

   • Server database: localhost
   • Nome database: craft_user (o il nome del database che hai scelto)
   • Nome utente: craft_user (o l'utente che hai creato)
   • Password: La password impostata per craft_user.

   Prosegui. Craft CMS proverà la connessione. In caso di successo, passerà alla fase successiva.

3. Crea l'account amministratore

   Segui le istruzioni per creare un account amministratore di Craft CMS. Inserisci username, password ed email. Assicurati di scegliere una password sicura.

   Clicca su "Continua".

4. Configurazione sito

   Inserisci il nome del tuo sito e gli altri dati richiesti.

   Clicca su "Completa installazione (Finish Up)". Craft CMS porterà a termine i processi finali, come la creazione delle tabelle del database e la generazione dei file di configurazione.

   Terminata l'installazione, verrai reindirizzato alla schermata di login dell'area amministrativa di Craft CMS.

Passo 6: Prime configurazioni ed esplorazione

Una volta effettuato l'accesso al pannello amministrativo di Craft CMS puoi iniziare con alcune configurazioni rapide ed esplorare le sue funzionalità:

1. Verifica il file .env: Craft CMS gestisce le variabili di ambiente tramite il file .env, incluso il collegamento al database. Il file viene generato automaticamente nella root del progetto (servbay-craft-app/), e puoi modificarlo all'occorrenza, ad esempio per impostare CRAFT_ENVIRONMENT su dev.
2. Installa plugin: All'interno del pannello, clicca su "Plugin" per esplorare, installare e gestire le estensioni di Craft CMS.
3. Definisci la struttura dei contenuti: Visita la sezione "Impostazioni" per creare i tuoi campi personalizzati, sezioni, categorie e tag.
4. Configura l'invio delle email: Se vuoi testare l'invio di email in locale, puoi configurare Craft CMS per utilizzare Mailpit o Mailhog integrati in ServBay. Nel file .env o nella sezione dedicata del pannello, imposta l'invio con SMTP, indicando come server localhost e la porta SMTP visualizzata in ServBay sotto Mailpit/Mailhog.

Domande Frequenti (FAQ)

• D: Cosa fare in caso di errore di connessione al database durante l'installazione?
  • R: Verifica che i dati inseriti nell'installer di Craft CMS (indirizzo host, nome database, utente e password) corrispondano a quelli creati in phpMyAdmin. Assicurati inoltre che il servizio database (MySQL o PostgreSQL) sia attivo in ServBay.
• D: Visualizzo una pagina 404 o vuota all'indirizzo servbay-craft.local?
  • R:
    • Controlla che la "Document Root" del sito sia correttamente impostata su /Applications/ServBay/www/servbay-craft-app/web. Questo è l'errore più comune.
    • Assicurati che i servizi web server (Caddy o Nginx) e PHP siano in esecuzione.
    • Verifica che il sito servbay-craft.local sia abilitato nella lista dei siti di ServBay.
• D: Composer è lento o fallisce durante l'installazione di Craft CMS?
  • R: Potrebbe essere un problema di connessione o di mirror di Composer. Prova a cambiare il mirror di Composer impostando una sorgente italiana o alternativa, come Aliyun o Packagist China.
• D: Dopo l'installazione, manca lo stile grafico del backend o le immagini non vengono visualizzate?
  • R: Spesso dipende dai permessi sui file. Assicurati che i permessi di scrittura siano corretti sulle directory storage e web/cpresources. ServBay normalmente gestisce questi aspetti, ma se noti problemi controlla o ripristina manualmente i permessi.

Conclusione

Seguendo questi passaggi, dovresti essere riuscito a installare e configurare Craft CMS nel tuo ambiente locale ServBay. ServBay rende più semplice la gestione delle versioni di PHP, delle impostazioni del database e della configurazione del server web, permettendoti di concentrarti sullo sviluppo delle tue soluzioni con Craft CMS. Ora puoi sfruttare le potenti funzionalità di content modeling di Craft CMS per creare il tuo sito web o applicazione!