Configurazione dell’ambiente a livello di progetto con il file .servbay.config

Panoramica

ServBay è un potente strumento di sviluppo web locale che consente agli sviluppatori di configurare ambienti di esecuzione indipendenti per progetti diversi. Il cuore di questa funzione è la possibilità di creare, nella directory di ciascun progetto, un file chiamato .servbay.config.

Grazie al file .servbay.config, puoi facilmente specificare per ogni progetto la versione di linguaggi come PHP, Node.js, Python, Go, Java, ecc., oltre a impostare indirizzi dei registry e directory cache dei gestori di pacchetti Node.js (come NPM e Yarn). Questo controllo dettagliato a livello di progetto aumenta fortemente l’efficienza e la comodità dello sviluppo, assicurando che ciascun progetto venga eseguito nell’ambiente richiesto, evitando conflitti di versione.

Come funziona il file .servbay.config

Quando ServBay viene avviato o si ricarica un sito, verifica la presenza di un file .servbay.config nella directory principale del sito. Se il file esiste, ServBay legge le configurazioni specificate e le applica solo a quell’ambiente. Tali impostazioni a livello di progetto sovrascrivono i parametri corrispondenti definiti in modo globale nelle impostazioni di ServBay. Se il file .servbay.config non esiste oppure alcune opzioni non sono specificate, ServBay utilizzerà le configurazioni predefinite globali.

Grazie a questo meccanismo, il passaggio tra progetti diversi avviene in modo del tutto trasparente, dato che ciascun progetto porta con sé la propria configurazione d’ambiente.

Come creare e configurare .servbay.config

Creare e configurare un file .servbay.config è molto semplice.

Dove posizionare il file

Crea un file chiamato .servbay.config nella root del tuo progetto. In genere, la root del progetto si trova all'interno della cartella di siti di ServBay, ad esempio /Applications/ServBay/www/il-tuo-progetto/.

Sintassi delle configurazioni

Il file .servbay.config adotta la semplice sintassi CHIAVE=VALORE, con una coppia per riga. Puoi inserire commenti usando il simbolo # per rendere la configurazione più leggibile.

Esempio di opzioni di configurazione

Ecco un esempio di file .servbay.config che mostra come impostare differenti versioni ambientali e opzioni dei gestori di pacchetti:

# Esempio di file .servbay.config

# Specifica la versione di PHP da utilizzare. Assicurati che questa versione sia installata in ServBay.
PHP_VERSION=8.5

# Specifica la versione di Node.js da utilizzare. Assicurati che questa versione sia installata in ServBay.
NODE_VERSION=20

# Configura l'indirizzo mirror del registry di Yarn per velocizzare il download delle dipendenze.
YARN_CONFIG_REGISTRY=https://npmreg.proxy.ustclug.org/

# Configura l'indirizzo mirror del registry di NPM per velocizzare il download delle dipendenze.
NPM_CONFIG_REGISTRY=https://npmreg.proxy.ustclug.org/

# Specifica la directory locale della cache di NPM. Nota: questo percorso è relativo alla cartella di installazione di ServBay.
NPM_CONFIG_CACHE=/Applications/ServBay/tmp/npm/cache

# Specifica la directory locale della cache di Yarn. Nota: questo percorso è relativo alla cartella di installazione di ServBay.
YARN_CONFIG_CACHE=/Applications/ServBay/tmp/yarn/cache

# Specifica la versione di Ruby da utilizzare. Assicurati che questa versione sia installata in ServBay.
RUBY_VERSION=2.7

# Specifica la versione di Java (OpenJDK) da utilizzare. Assicurati che questa versione sia installata in ServBay.
JAVA_VERSION=21

# Specifica la versione di Python da utilizzare. Assicurati che questa versione sia installata in ServBay.
PYTHON_VERSION=3.11

# Specifica la versione di .NET da utilizzare. Assicurati che questa versione sia installata in ServBay.
DOTNET_VERSION=5.0

# Specifica la versione di Go da utilizzare. Assicurati che questa versione sia installata in ServBay.
GO_VERSION=1.12

# Configura il server proxy dei moduli Go per velocizzare il download dei moduli.
GOPROXY=https://goproxy.cn,direct

Nota: I numeri di versione presenti negli esempi (come PHP_VERSION=8.5, NODE_VERSION=20, ecc.) servono solo a scopo illustrativo. Per il tuo caso d’uso, imposta tutti i valori in base alle effettive esigenze del tuo progetto e alle versioni effettivamente installate/supported in ServBay. Se la versione indicata non è installata, ServBay potrebbe utilizzare quella predefinita oppure mostrare un errore.

Tipologie di configurazioni supportate

Sulla base dell’esempio, il file .servbay.config supporta principalmente le seguenti tipologie di configurazioni:

1. Specifiche delle versioni degli ambienti:

   • PHP_VERSION: versione di PHP.
   • NODE_VERSION: versione di Node.js.
   • RUBY_VERSION: versione di Ruby.
   • JAVA_VERSION: versione di Java (OpenJDK).
   • PYTHON_VERSION: versione di Python.
   • DOTNET_VERSION: versione di .NET.
   • GO_VERSION: versione di Go.
   • (Consulta la documentazione di ServBay o l’interfaccia dell’app per l’elenco aggiornato degli ambienti e i relativi nomi delle variabili di configurazione.)

2. Configurazione dei gestori di pacchetti (Node.js):

   • YARN_CONFIG_REGISTRY: indirizzo registry mirror di Yarn.
   • NPM_CONFIG_REGISTRY: indirizzo registry mirror di NPM.
   • NPM_CONFIG_CACHE: percorso della directory cache locale di NPM.
   • YARN_CONFIG_CACHE: percorso della directory cache locale di Yarn.

3. Configurazione del proxy dei moduli Go:

   • GOPROXY: indirizzo del server proxy per i moduli Go.

Questi parametri ti permettono di isolare l’ambiente di ogni progetto senza interferenze reciproche tra progetti diversi.

Uso pratico e verifica

Dopo aver creato il file .servbay.config, assicurati che ServBay abbia caricato correttamente il tuo progetto (deve risultare nella lista “Siti” di ServBay). Il file di configurazione verrà letto ogni volta che il sito viene caricato o ricaricato.

Per verificare il corretto funzionamento delle configurazioni, puoi procedere come segue:

1. Controllo dall’interfaccia di ServBay: ServBay potrebbe mostrare nell’interfaccia del sito i dettagli sulle versioni ambientali in uso per il progetto.

2. Verifica da linea di comando: Apri il terminale (Terminal) integrato di ServBay, assicurati di trovarti nella root del progetto e lancia i comandi per controllare le versioni:

   • Per PHP: php -v
   • Per Node.js: node -v
   • Per Yarn: yarn -v
   • Per NPM: npm -v
   • Per Python: python -V o python3 -V
   • Per Go: go version
   • Per Java: java -version
   • Per .NET: dotnet --version
   • Per Ruby: ruby -v Confronta l’output dei comandi con quanto specificato in .servbay.config.

3. Verifica tramite pagina web (PHP): Nella root del tuo progetto, crea un file PHP semplice (ad esempio info.php) con il contenuto <?php phpinfo(); ?>. Accedi al file tramite browser (ad esempio, http://your-project.servbay.demo/info.php) e controlla la voce relativa alla versione PHP in phpinfo, per confermare che sia quella selezionata.

L’immagine seguente mostra un esempio dell’interfaccia ServBay che riflette le configurazioni a livello di progetto:

(Fai sempre riferimento all’output reale dell’app ServBay per controllare il funzionamento delle impostazioni.)

Avvertenze

• Il nome del file .servbay.config deve essere scritto esattamente come indicato, senza errori.
• Il file va posto nella directory principale del progetto.
• Le versioni specificate devono essere effettivamente installate e supportate da ServBay.
• Ogni coppia di configurazione va scritta su una riga separata, con formato CHIAVE=VALORE.
• Errori sintattici possono causare l’ignoramento totale o parziale del file di configurazione.
• Le impostazioni in .servbay.config sovrascrivono quelle globali di ServBay solo per il progetto in questione.

Domande frequenti (FAQ)

D: Cosa succede se nella root del mio progetto non esiste il file .servbay.config?

R: In assenza del file, ServBay utilizza le impostazioni ambientali generali definite nell’app per eseguire il progetto.

D: Cosa succede se nel file .servbay.config indico una versione non installata in ServBay?

R: ServBay mostrerà un errore; il comportamento specifico può variare a seconda della versione e delle impostazioni di ServBay. Assicurati sempre di installare tramite l’app tutte le versioni necessarie prima di specificarle nel file.

D: Devo riavviare ServBay dopo aver modificato il file .servbay.config?

R: Nella maggior parte dei casi, basta ricaricare o fermare e avviare nuovamente il sito interessato tramite l’interfaccia ServBay, senza il bisogno di riavviare completamente l’app.

D: Le configurazioni nel file .servbay.config interessano anche gli altri miei progetti?

R: No. Le impostazioni di .servbay.config hanno effetto solo sulla cartella sito ServBay in cui il file si trova.

Conclusioni

Il file .servbay.config offre agli sviluppatori un potente strumento di gestione degli ambienti a livello di progetto in ServBay. Sia che tu debba mantenere progetti legacy con ambienti datati, sia che sviluppi con gli ultimi stack tecnologici, questo file consente di passare e isolare ambienti in modo rapidissimo e semplice, migliorando la flessibilità e l’efficienza dello sviluppo locale. Sfrutta al massimo questa funzionalità per rendere il tuo flusso di lavoro ancora più fluido ed efficace.