Installare e Configurare Bedrock nell'Ambiente ServBay

Panoramica

Questo documento ti guiderà passo passo nell'installazione e nella configurazione di Bedrock nell'ambiente di sviluppo locale di ServBay. Bedrock offre una struttura moderna per i progetti WordPress, gestendo le dipendenze tramite Composer, ottimizzando la gestione della configurazione e seguendo le migliori pratiche per migliorare efficienza e sicurezza nello sviluppo, nel deploy e nella manutenzione di progetti WordPress. Grazie alla potente ed intuitiva gestione ambientale di ServBay, potrai creare rapidamente un ambiente di sviluppo Bedrock.

Che cos’è Bedrock?

Bedrock è una struttura di progetto WordPress creata dal team Roots, progettata per migliorare l’esperienza di sviluppo WordPress. Si distingue notevolmente dalla struttura tradizionale di WordPress, offrendo vantaggi come:

• Gestione delle dipendenze con Composer: il core di WordPress, temi e plugin possono essere gestiti tramite Composer, semplificando aggiornamenti e conflitti.
• Gestione delle configurazioni migliorata: seguendo i principi Twelve-Factor App, utilizza un file .env per la gestione delle variabili d’ambiente, separando configurazione e codice per maggiore sicurezza e flessibilità.
• Migliore organizzazione del progetto: il core di WordPress è posizionato in una sottocartella (web/wp), mentre temi e plugin si trovano in web/app, rendendo la struttura più ordinata.
• Sicurezza potenziata: include misure di sicurezza di default, come l’occultamento dei percorsi dei file core.

Bedrock è la scelta ideale per sviluppare applicazioni WordPress robuste, moderne e facilmente manutenibili.

Perché scegliere ServBay per sviluppare con Bedrock?

ServBay è uno strumento di ambiente di sviluppo web locale creato appositamente per macOS. Integra server web principali (Caddy/Nginx/Apache), diversi versioni di PHP, database (MySQL/PostgreSQL/MongoDB) e ambienti per sviluppare con Node.js, Python, Go, Java e altro. Utilizzare ServBay insieme a Bedrock ti permette di:

• Configurazione veloce dell’ambiente: PHP, Composer e database necessari sono già preinstallati in ServBay, non occorre configurare nulla a parte.
• Cambio di versione flessibile: puoi facilmente cambiare la versione di PHP per testare la compatibilità di Bedrock su vari ambienti.
• Gestione database integrata: crea e gestisci con facilità i database necessari a Bedrock tramite phpMyAdmin o Adminer integrati.
• Configurazione sito semplificata: puoi configurare rapidamente il sito (virtual host) del progetto Bedrock con l’interfaccia grafica di ServBay, puntando alla corretta directory di root del sito.
• Gestione unificata: tutto il software e i siti necessari allo sviluppo locale sono gestiti all’interno di una sola app.

Prerequisiti

Prima di iniziare l’installazione, assicurati di aver soddisfatto questi requisiti:

• ServBay è installato e in esecuzione su macOS.
• Hai una conoscenza di base dell’uso della linea di comando.
• Hai una conoscenza fondamentale di Composer (questo documento include comunque i comandi da usare).

Passaggi per Installare Bedrock

Questa sezione illustra nel dettaglio come installare e configurare un progetto Bedrock nell’ambiente ServBay.

Passo 1: Crea la directory del progetto

Per prima cosa naviga nella directory predefinita dei siti di ServBay /Applications/ServBay/www e crea una nuova cartella per il tuo progetto. Si consiglia un nome descrittivo, ad esempio servbay-bedrock-app.

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

Questa cartella sarà la root del tuo progetto Bedrock.

Passo 2: Crea il progetto Bedrock usando Composer

ServBay include già Composer, quindi puoi usare direttamente il comando composer nel terminale. Dalla cartella appena creata (/Applications/ServBay/www/servbay-bedrock-app), esegui il seguente comando per creare il progetto Bedrock:

composer create-project roots/bedrock .

Questo comando scaricherà l’ultima versione di Bedrock e tutte le sue dipendenze nella directory corrente. Il tempo di download dipende dalla velocità della tua connessione internet.

Passo 3: Crea database e utente

Bedrock e WordPress richiedono un database per memorizzare contenuti e impostazioni del sito. Useremo phpMyAdmin integrato in ServBay per creare database e utente.

1. Accedi a phpMyAdmin fornito da ServBay

   Apri il browser e vai all’indirizzo locale di ServBay https://servbay.host/. Nella pagina di benvenuto, clicca su “phpMyAdmin” per accedere allo strumento di gestione database.

2. Crea l’utente del database

   Per maggiore sicurezza e organizzazione, crea un utente e un database dedicati a ciascun progetto.

   1. Vai alla pagina degli account utente

      Dalla pagina principale di phpMyAdmin, clicca su “Account utente” nel menu di navigazione in alto.

   2. Aggiungi un nuovo utente

      Clicca su “Aggiungi account utente” e inserisci quanto segue:

      • Nome utente: Ad esempio bedrock_user.
      • Host: Scegli localhost, così l’utente potrà connettersi solo localmente.
      • Password: Imposta una password sicura. Annotala. Ad esempio, per test locale, puoi usare password123, ma in produzione scegli sempre una password robusta.
      • Reinserisci: Conferma la password appena inserita.

      Nella sezione “Database per l’utente”, seleziona “Crea un database con lo stesso nome e concedi tutti i privilegi”. In questo modo verrà creato automaticamente un database bedrock_user, e l’utente avrà pieni permessi su di esso.

      Assicurati che “Concedi tutti i privilegi” sia selezionato.

      Clicca su “Esegui” in fondo alla pagina per completare la creazione.

Passo 4: Configura Bedrock

Bedrock utilizza variabili d’ambiente, tipicamente contenute nel file .env nella directory principale del progetto.

1. Modifica il file di configurazione dell’ambiente

   Nella directory principale di Bedrock (/Applications/ServBay/www/servbay-bedrock-app) troverai il file esempio .env.example. Copialo e rinominalo in .env:

   cp .env.example .env

   Il file .env conterrà la configurazione effettiva del tuo progetto, .env.example è solo di riferimento e non include dati sensibili.

2. Modifica il file .env

   Con il tuo editor preferito (VS Code, Sublime Text, Nano ecc.) apri .env. Individua le sezioni relative alla connessione del database e sostituisci i valori con quelli scelti al Passaggio 3:

   # Database
   DB_NAME='bedrock_user' # Nome del database, lo stesso dell’utente
   DB_USER='bedrock_user' # Nome utente del database
   DB_PASSWORD='password123' # Password del database
   DB_HOST='localhost' # Host del database, di solito localhost con ServBay
   DB_PREFIX='wp_' # Prefisso delle tabelle, puoi lasciarlo invariato o cambiarlo
   
   # WordPress Environment
   WP_ENV='development' # Ambiente attuale: development, staging, production, ecc.
   
   # Site URLs
   WP_HOME='http://servbay-bedrock.local' # URL completo del sito
   WP_SITEURL='${WP_HOME}/wp' # URL dei file core di WordPress

   Modifica DB_PASSWORD con la password creata in phpMyAdmin e, se usato un altro nome per database/utente, aggiorna anche quelli.

   WP_HOME e WP_SITEURL specificano l’URL con cui accederai al sito dal browser. servbay-bedrock.local è una scelta comune per l’ambiente locale, ma puoi modificarlo. WP_SITEURL deve puntare alla sottocartella web/wp.

   Puoi anche configurare altre impostazioni Bedrock e WordPress nella .env, come definizioni di costanti o configurazioni email.

Passo 5: Configura il server web (sito ServBay)

Perché il server web di ServBay indichi correttamente il tuo progetto, aggiungi un nuovo sito (virtual host) in ServBay.

1. Aggiungi un nuovo sito

   Apri ServBay, seleziona la voce “Siti” nella barra di navigazione a sinistra e clicca sul simbolo “+” o su “Aggiungi sito” per creare una nuova configurazione. Compila così:

   • Nome: Un identificativo, es. My Bedrock Site (solo per uso interno a ServBay).
   • Dominio: Inserisci il dominio usato nella variabile WP_HOME del file .env, es. servbay-bedrock.local. ServBay mapperà il dominio a 127.0.0.1.
   • Tipo di sito: Seleziona PHP.
   • Versione PHP: Scegli una versione compatibile con Bedrock, meglio se aggiornata.
   • Root del sito: Attenzione! La root NON deve essere la cartella principale, ma la sottocartella web del progetto, quindi imposta: /Applications/ServBay/www/servbay-bedrock-app/web.

2. Salva la configurazione

   Una volta inseriti tutti i dati, clicca su salva. ServBay aggiornerà la configurazione. Se richiesto, riavvia i servizi secondo indicazioni.

Passo 6: Completare l’installazione di WordPress

Il progetto Bedrock è pronto e il sito è configurato in ServBay. Ora puoi completare l’installazione tradizionale di WordPress tramite interfaccia web.

1. Accedi alla pagina di installazione

   Dal browser, vai all’indirizzo indicato in WP_SITEURL del file .env e dalla configurazione ServBay, es. http://servbay-bedrock.local/wp. Se tutto è corretto, vedrai la schermata guidata di installazione WordPress.

2. Inserisci i dati del database

   La procedura guidata ti chiederà di inserire le informazioni di accesso al database create in precedenza:

   • Nome database: bedrock_user
   • Nome utente: bedrock_user
   • Password: la password impostata (esempio: password123)
   • Host database: localhost
   • Prefisso tabelle: wp_ (lascialo così se non hai esigenze particolari)

   Clicca su “Invia” e WordPress tenterà la connessione.

3. Inserisci le informazioni del sito

   Se la connessione va a buon fine, accedi alla schermata per impostare le informazioni del sito:

   • Titolo sito: Il nome che desideri.
   • Nome utente: Username dell’amministratore.
   • Password: Una password sicura per l’amministratore.
   • Email: L'indirizzo email amministratore.
   • Visibilità sui motori di ricerca: In locale, di solito attiva l’opzione “Blocca i motori di ricerca”.

4. Completa l’installazione

   Premi “Installa WordPress”. Verranno creati le tabelle e dati di base. A installazione terminata, vedrai la pagina di conferma e potrai loggarti nella bacheca di WordPress.

Passo 7: Installare temi e plugin (tramite Composer)

Bedrock privilegia la gestione di temi e plugin tramite Composer, rispetto al caricamento via backend.

1. Trova il nome del pacchetto Composer del tema/plugin

   Molti temi e plugin WordPress sono disponibili su Packagist (packagist.org) o WordPress Packagist (wpackagist.org), con nome vendor/package-name, es: wpackagist-theme/twentytwentyone o wpackagist-plugin/wordpress-seo.

2. Installa con Composer

   Dalla root del progetto (/Applications/ServBay/www/servbay-bedrock-app) usa Composer:

   Per i temi:

   composer require wpackagist-theme/your-theme-name

   Per i plugin:

   composer require wpackagist-plugin/your-plugin-name

   Sostituisci your-theme-name e your-plugin-name coi nomi effettivi. I temi verranno installati in web/app/themes, i plugin in web/app/plugins.

3. Attiva dal backend WordPress

   Accedi a /wp/wp-admin/ (es: http://servbay-bedrock.local/wp/wp-admin/):

   • Temi: menu “Aspetto” > “Temi”, individua e attiva quello desiderato.
   • Plugin: menu “Plugin” > “Plugin installati”, individua e attiva.

   È ancora possibile installare temi e plugin caricando file .zip dal backend, ma l’approccio Composer è il metodo moderno e raccomandato da Bedrock.

Realizzare il tuo sito con Bedrock

Ora hai installato e configurato con successo Bedrock in ServBay. Puoi costruire il tuo sito come con uno WordPress tradizionale, ma avvantaggiandoti delle caratteristiche moderne offerte da Bedrock.

• Crea pagine e articoli: Accedi al backend WordPress, usa i menu “Pagine” e “Articoli”.
• Configura i menu di navigazione: Trova l'opzione in “Aspetto” > “Menu”.
• Personalizza i widget: Gestisci le aree laterali e widget da “Aspetto” > “Widget”.
• Sviluppo temi e plugin: Se sei uno sviluppatore, puoi lavorare direttamente nelle directory web/app/themes e web/app/plugins del progetto.
• Gestione configurazioni: Usa .env per gestire configurazioni separate per sviluppo, staging e produzione.

Domande Frequenti (FAQ)

• Domanda: Quando accedo a http://servbay-bedrock.local ricevo errore 404, che fare?
  • Risposta: Verifica che il dominio configurato in ServBay corrisponda a quello che stai usando per l’accesso.
  • Risposta: Controlla che la root del sito punti esattamente a /Applications/ServBay/www/servbay-bedrock-app/web.
  • Risposta: Assicurati che il server web in ServBay sia avviato.
  • Risposta: Verifica la correttezza della variabile WP_HOME nel file .env.
• Domanda: Accedendo a http://servbay-bedrock.local/wp vedo un errore di connessione al database. Soluzioni?
  • Risposta: Controlla che i dati in .env (DB_NAME, DB_USER, DB_PASSWORD, DB_HOST) corrispondano esattamente a quanto creato con phpMyAdmin.
  • Risposta: Accertati che il servizio MySQL (o altro database usato) di ServBay sia avviato.
  • Risposta: L’utente ha tutti i privilegi sul proprio database? Controlla in phpMyAdmin.
• Domanda: Ho installato tema/plugin ma non lo vedo nel backend. Perché?
  • Risposta: Se hai usato Composer, controlla di aver eseguito composer install o composer require dalla root del progetto, e che non ci siano errori.
  • Risposta: Temi installati tramite Composer si trovano in web/app/themes, i plugin in web/app/plugins. Verifica che i file siano lì.
  • Risposta: Dal backend, vai in “Aspetto” > “Temi” o “Plugin” > “Plugin installati” per attivare ciò che ti serve.
• Domanda: Come aggiorno Bedrock, WordPress core, temi o plugin?
  • Risposta: Bedrock usa Composer per la gestione dei pacchetti, quindi opera nella root del progetto con composer update per aggiornare tutto, o composer update vendor/package-name per elementi specifici. Dopo l’aggiornamento, potresti dover eseguire eventuali aggiornamenti del database via backend.

Conclusioni

Seguendo questi passaggi, hai creato con successo un progetto Bedrock nell’ambiente di sviluppo locale ServBay. Unendo la praticità di ServBay con la modernità del workflow Bedrock, potrai sviluppare e mantenere progetti WordPress in modo più efficiente e sicuro. Ora puoi sfruttare al massimo i vantaggi di Bedrock per realizzare il tuo prossimo sito WordPress!