Installazione e configurazione di ExpressionEngine CMS nell'ambiente locale ServBay

Panoramica

ExpressionEngine è un sistema di gestione dei contenuti (CMS) potente e flessibile, ampiamente utilizzato per realizzare siti web e applicazioni web di ogni tipo e complessità. Offre funzionalità core avanzate e un'architettura altamente modulare, consentendo a sviluppatori e web designer di creare e personalizzare siti in modo estremamente flessibile.

ServBay è invece un ambiente di sviluppo web locale progettato specificamente per macOS, che fornisce una soluzione all-in-one integrando molti server web diffusi (come Nginx, Caddy, Apache), runtime di linguaggi di programmazione (PHP, Node.js, Python, Go, Java, Ruby, Rust, .NET), database (MySQL, PostgreSQL, MongoDB, Redis) e strumenti per sviluppatori (Composer, npm/yarn, phpMyAdmin/Adminer). Con ServBay, gli sviluppatori possono facilmente creare e gestire ambienti di sviluppo locali.

In questa guida ti mostreremo nel dettaglio come installare e configurare ExpressionEngine nell'ambiente ServBay, per aiutarti ad avviare rapidamente un progetto ExpressionEngine.

Perché scegliere ServBay per installare ExpressionEngine?

Utilizzare ServBay per installare ExpressionEngine in locale offre diversi vantaggi:

• Ambiente integrato: ServBay include tutto ciò che serve a ExpressionEngine: runtime PHP, database MySQL e server web, senza dover installare o configurare nulla separatamente.
• Supporto multi-versione: Puoi scegliere o cambiare facilmente la versione PHP tramite ServBay in base ai requisiti di ExpressionEngine.
• Gestione database semplificata: ServBay include phpMyAdmin o Adminer per creare e gestire il database necessario a ExpressionEngine in modo semplice e immediato.
• Configurazione del sito rapida: Mediante l'interfaccia grafica di ServBay puoi creare e configurare rapidamente un sito locale puntato alla cartella del tuo progetto ExpressionEngine.
• Isolamento e gestione: Con ServBay puoi creare una configurazione separata per ciascun progetto, evitando conflitti tra ambienti diversi.

Prerequisiti

Prima di iniziare, assicurati di avere:

1. ServBay installato e funzionante su macOS. Se non lo hai ancora installato, visita il sito ufficiale di ServBay per la guida all'installazione.
2. Un minimo di familiarità con la riga di comando del terminale.
3. Nozioni basilari di database (concetti come database, utenti).
4. Permessi di scrittura sulla directory radice dei siti di ServBay: /Applications/ServBay/www.

Procedura di installazione

Andremo a eseguire i seguenti passaggi per installare e configurare ExpressionEngine nell'ambiente ServBay.

Passo 1: Preparare la directory del progetto e scaricare ExpressionEngine

Per prima cosa, apri il terminale. Naviga nella cartella radice dei siti di ServBay (/Applications/ServBay/www), crea una nuova cartella per il progetto (ad esempio servbay-ee-app) ed entra nella directory appena creata.

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

Poi, utilizza il comando curl per scaricare l'ultima versione di ExpressionEngine nella directory corrente. L'opzione -L segue i redirect, -o specifica il nome del file di output.

curl -L https://expressionengine.com/latest -o expressionengine.zip

Passo 2: Estrarre i file di ExpressionEngine

Al termine del download, decomprimi il file expressionengine.zip appena scaricato nella cartella servbay-ee-app. Dopo aver estratto i file, puoi eliminare l'archivio zip.

unzip expressionengine.zip
rm expressionengine.zip

La struttura dei file di ExpressionEngine sarà ora presente all'interno della cartella servbay-ee-app.

Passo 3: Creare database e utente per ExpressionEngine

ExpressionEngine richiede un database per memorizzare contenuti e configurazioni. ServBay include MySQL e phpMyAdmin per gestire con semplicità il database.

1. Accedi a phpMyAdmin fornito da ServBay

   Apri il browser e vai all'indirizzo degli strumenti locali di ServBay: https://servbay.host/. Sul sito, cerca il link a "phpMyAdmin" e cliccaci sopra per accedere alla schermata di login. Utilizza le credenziali di default fornite da ServBay (di norma l'accesso a localhost non richiede password, salvo configurazioni particolari).

2. Crea un nuovo utente e database

   Dopo aver effettuato l'accesso a phpMyAdmin, crea un utente e un database specifici per ExpressionEngine.

   • Accedi alla pagina degli utenti: Dalla home page di phpMyAdmin, clicca su "Account utente" nella barra di navigazione in alto.
   • Aggiungi un nuovo utente: Clicca su "Aggiungi account utente".
   • Compila i dati utente e database:
     • Nome utente: inserisci un nome dedicato per l'accesso di ExpressionEngine, ad esempio ee_user.
     • Host: scegli localhost, così l'utente potrà collegarsi solo localmente al database (più sicuro).
     • Password: inserisci una password sicura che userai anche durante la configurazione di ExpressionEngine. Prendi nota del valore scelto. In questo esempio useremo password123 (ma per ambienti produttivi usa sempre una password complessa).
     • Reinserisci la password: ridigita la password per confermare.
     • Crea database con lo stesso nome dell’utente e concedi tutti i privilegi: seleziona l’opzione per creare un database chiamato come l’utente e assegna tutti i permessi al nuovo utente su quel database.
   • Conferma i privilegi: Assicurati di non assegnare permessi globali superflui (sono sufficienti i privilegi concessi sopra).
   • Conferma: clicca su "Esegui" in fondo alla pagina per completare la creazione di utente e database.

   Ora hai un database chiamato ee_user e un utente col medesimo nome, che ha tutti i permessi sul database.

Passo 4: Configurare il sito in ServBay

Adesso bisogna indicare a ServBay come gestire le richieste a uno specifico dominio locale (ad esempio servbay-ee.local) e indirizzarle alla directory del progetto ExpressionEngine.

1. Apri ServBay e aggiungi un nuovo sito

   Avvia l’interfaccia grafica di ServBay. Nel menu laterale clicca su "Siti web" e poi sul pulsante "+" (o "Aggiungi") per inserire una nuova configurazione di sito.

   • Nome: scegli un nome descrittivo per il sito, ad esempio My ExpressionEngine Site.
   • Dominio: inserisci il dominio che vuoi usare per accedere in locale, ad esempio servbay-ee.local. ServBay aggiornerà automaticamente il file hosts per indirizzare il dominio a 127.0.0.1.
   • Tipo: seleziona PHP, dato che ExpressionEngine è sviluppato in PHP.
   • Versione PHP: seleziona la versione PHP compatibile con la versione di ExpressionEngine che hai scaricato. Puoi scegliere facilmente tra le versioni disponibili.
   • Root del sito: clicca sul pulsante per selezionare la cartella del progetto creata nel Passo 1, ovvero /Applications/ServBay/www/servbay-ee-app.
   • Server Web: puoi scegliere tra i server supportati (Nginx, Caddy o Apache). ServBay genererà in automatico il file di configurazione adatto. Per la maggior parte dei casi va bene l'opzione di default.

2. Salva e applica la configurazione

   Dopo aver inserito tutti i dati, clicca su "Salva" o "Applica". Potrebbe essere necessario riavviare il server web di ServBay per caricare la nuova configurazione: segui le istruzioni sullo schermo e attendi la fine del riavvio.

   Ora, quando visiti https://servbay-ee.local/ tramite browser, ServBay indirizzerà le richieste verso la directory del tuo progetto ExpressionEngine.

Passo 5: Avviare la procedura guidata di installazione Web di ExpressionEngine

ExpressionEngine offre una procedura di installazione guidata via web per completare la configurazione finale.

1. Accedi alla pagina di installazione

   Dal browser, visita il dominio configurato in ServBay aggiungendo il file di ingresso al programma di installazione admin.php. Di default l’installer è accessibile a /admin.php.

   Indirizzo da visitare: https://servbay-ee.local/admin.php

   Dovresti vedere la pagina di benvenuto o la procedura guidata di installazione di ExpressionEngine.

2. Configura ExpressionEngine seguendo la procedura guidata

   L’installer chiederà le seguenti informazioni chiave:

   • Dettagli connessione database:
     • Host database: localhost
     • Nome database: ee_user (quello creato nel Passo 3)
     • Nome utente database: ee_user (lo stesso nome scelto prima)
     • Password database: inserisci la password definita per ee_user.
   • Account amministratore: crea l’account super-amministratore per il backend di ExpressionEngine (scegli username, password sicura ed email).
   • Configurazione sito: imposta nome sito, URL e altre informazioni base.

3. Completare l’installazione

   Verifica di aver inserito dati corretti e clicca sul pulsante "Installa" o equivalente per procedere. ExpressionEngine creerà le tabelle necessarie e porterà a termine la configurazione.

   Al termine, verrai generalmente reindirizzato alla schermata di login o alla dashboard di amministrazione.

Passo 6: Configurazione di base post-installazione

Conclusa l’installazione di ExpressionEngine, puoi installare plugin, template e apportare le prime personalizzazioni.

1. Accedi al backend di ExpressionEngine

   Accedi alla dashboard amministrativa con le credenziali definite in fase di installazione, visitando https://servbay-ee.local/admin.php e inserendo username e password.

2. Installa plugin

   Nel backend, vai su "Sviluppatore (Developer)" -> "Add-Ons" -> "Plugins". Sfoglia la lista dei plugin disponibili e installa quelli utili per il tuo progetto.

3. Installa e configura i template

   Vai su "Design" -> "Templates" per creare gruppi template, nuovi template e scrivere il codice HTML/CSS/EE per presentare i contenuti del sito.

Realizzare il tuo sito web con ExpressionEngine

A questo punto, hai installato e configurato correttamente ExpressionEngine nell’ambiente ServBay. Ora puoi cominciare a sviluppare e gestire i contenuti del tuo sito. Ecco alcune azioni di base per muovere i primi passi:

Creazione di canali e voci

Alla base di ExpressionEngine ci sono "Canali" e "Voci". I canali definiscono la tipologia e la struttura dei contenuti, mentre le voci sono le istanze concrete di contenuto.

1. Crea un canale: Dal backend di ExpressionEngine, vai su "Content Structure" -> "Channels". Clicca su "Create New Channel", inserisci nome del canale, gruppo campi, ecc., quindi salva con "Save Channel".
2. Crea una voce: Vai su "Content" -> "Publish". Seleziona il canale appena creato, compila i dati richiesti e salva.

Configurare il menu di navigazione

La navigazione si realizza tipicamente tramite i template.

1. Crea o modifica un template: In "Design" -> "Templates", individua o crea un template per la navigazione del sito (ad esempio, nel gruppo site, crea il template nav).
2. Sviluppa il codice di navigazione: Nei template usa i tag di ExpressionEngine per interrogare canali o pagine e generare la struttura HTML della navigazione.
3. Includi il template nella struttura: Nel template principale della pagina usa {% include 'site:nav' %} (se usi Blade) oppure il tag adeguato per includere la navigazione.

Personalizzare widget e sidebar

Come per la navigazione, anche le sidebar e le aree widget si gestiscono tramite template.

1. Crea un template per i widget: In "Design" -> "Templates", crea un template dedicato ai widget (ad esempio site:sidebar).
2. Sviluppa il codice del widget: Nel template visualizza voci recenti, categorie, banner o altre informazioni utili.
3. Includi il widget nella struttura delle pagine: Aggiungi l’inclusione del template dove vuoi visualizzare il widget nel layout.

FAQ - Domande Frequenti

• Domanda: Vedendo https://servbay-ee.local/ ottengo un errore di permessi. Come risolvere?
  • Risposta: Verifica i permessi della cartella del progetto (/Applications/ServBay/www/servbay-ee-app) e dei suoi contenuti. Assicurati che l’utente con cui esegui ServBay abbia permessi di lettura/scrittura. Puoi sistemare i permessi tramite i comandi chmod o chown, ad esempio: sudo chown -R tuo_utente:tuo_gruppo /Applications/ServBay/www/servbay-ee-app.
• Domanda: L’installer di ExpressionEngine non riesce a collegarsi al database. Cosa posso fare?
  • Risposta: Controlla che le informazioni di connessione (host: localhost, nome database, utente, password) coincidano esattamente con quelle impostate in phpMyAdmin. Inoltre, assicurati che il servizio MySQL/MariaDB sia attivo in ServBay.
• Domanda: Posso usare altri database come PostgreSQL con ServBay?
  • Risposta: ExpressionEngine supporta principalmente MySQL/MariaDB. Se ExpressionEngine supporta ufficialmente PostgreSQL, e hai i driver/configurazioni necessari, puoi sfruttare il servizio PostgreSQL di ServBay, ma dipende dalla compatibilità di ExpressionEngine stesso. Consulta la documentazione ufficiale per confermare i database supportati.

Conclusioni

Seguendo passo passo questa guida, dovresti essere riuscito ad installare e configurare ExpressionEngine CMS nell'ambiente di sviluppo locale ServBay. ServBay offre un ecosistema comodo e integrato per lo sviluppo locale con ExpressionEngine, completo di tutti i componenti necessari. Ora puoi iniziare a sfruttare la potenza di ExpressionEngine per realizzare il tuo sito web o applicativo! Buon lavoro!