Configurazione e ambiente

WP Staging CLI genera automaticamente i file di configurazione Docker quando crei un sito. Questa guida illustra le opzioni di configurazione avanzate e la generazione manuale dei file.

File di configurazione

Quando crei un sito, WP Staging CLI genera questi file in ~/wpstaging/sites/<hostname>/:

• docker-compose.yml – Configurazione principale di Docker Compose
• .env – Variabili d’ambiente
• nginx/ – Configurazione di Nginx e certificati SSL
• php/ – Configurazione di PHP-FPM
• mariadb/ – Configurazione e dati di MariaDB

Aggiornare il file hosts

Aggiunge o aggiorna le voci nel file hosts del sistema per la risoluzione dei domini locali:

wpstaging update-hosts-file

In alternativa usa l’alias breve:

wpstaging uhf

Questo comando:

• Legge tutti i siti configurati
• Aggiunge voci a /etc/hosts (Linux/macOS) oppure a C:\Windows\System32\drivers\etc\hosts (Windows)
• Mappa ogni hostname all’indirizzo IP configurato

Generare il file Compose

Rigenera il file docker-compose.yml per un sito specifico:

wpstaging generate-compose-file mysite.local

In alternativa usa l’alias breve:

wpstaging gcf mysite.local

Usa questa opzione quando hai bisogno di:

• Ripristinare il file Compose alle impostazioni predefinite
• Aggiornare dopo modifiche manuali alla configurazione
• Diagnosticare problemi di Docker

Generare i file Docker

Rigenera tutti i file di configurazione Docker per un sito:

wpstaging generate-docker-file mysite.local

In alternativa usa l’alias breve:

wpstaging gdf mysite.local

Questa operazione rigenera:

• docker-compose.yml
• La configurazione di Nginx
• La configurazione di PHP-FPM
• Il file delle variabili d’ambiente

Gestione dei certificati SSL

WP Staging CLI usa mkcert per generare certificati SSL considerati attendibili in locale.

Reinstallare il certificato

Se riscontri problemi con il certificato, rigenera il certificato SSL del sito:

wpstaging reinstall-cert mysite.local

Reinstallare la Certificate Authority

Se il browser non considera attendibili i certificati, reinstalla la CA di mkcert nel trust store di sistema:

wpstaging reinstall-cert mysite.local --reinstall-ca

Visualizzare la configurazione del sito

Mostra le variabili d’ambiente e la configurazione di un sito:

wpstaging compose-info mysite.local

Vengono mostrate le impostazioni di docker-compose.yml interpretate, comprese:

• Nomi e immagini dei container
• Le mappature delle porte
• I montaggi dei volumi
• Le variabili d’ambiente

Percorso personalizzato per gli ambienti

Per impostazione predefinita, tutti gli ambienti Docker vengono salvati in ~/wpstaging. Puoi indicare un percorso personalizzato:

wpstaging add mysite.local --env-path=/custom/docker/path

Usa poi lo stesso percorso in tutti i comandi successivi:

wpstaging start --env-path=/custom/docker/path
wpstaging list --env-path=/custom/docker/path

Percorso personalizzato del file Compose

Specifica una posizione personalizzata per il file docker-compose.yml:

wpstaging add mysite.local --compose-file=/custom/path/docker-compose.yml

Configurazione delle porte

Se le porte predefinite entrano in conflitto con altri servizi, personalizzale al momento della creazione del sito:

wpstaging add mysite.local \
  --http-port=8080 \
  --https-port=8443 \
  --db-port=3307 \
  --mailpit-http-port=8026

Configurazione degli indirizzi IP

Per impostazione predefinita, i siti utilizzano indirizzi IP nel range 127.3.2.x (indirizzi di loopback). Questo permette a più siti di essere eseguiti contemporaneamente sulle stesse porte (80/443).

wpstaging add mysite.local --container-ip=127.3.2.5

Alias IP su macOS

Su macOS, la CLI crea automaticamente gli alias IP per gli indirizzi nel range 127.3.2.x. Questa operazione richiede l’accesso sudo.

Riepilogo dei comandi di configurazione

Struttura delle directory

Struttura predefinita delle directory dell’ambiente:

~/wpstaging/
├── sites/
│   └── mysite.local/
│       ├── docker-compose.yml
│       ├── .env
│       ├── www/                    # WordPress files
│       ├── nginx/
│       │   ├── nginx.conf
│       │   └── ssl/
│       │       ├── mysite.local.crt
│       │       └── mysite.local.key
│       ├── php/
│       │   └── php.ini
│       └── mariadb/
│           └── data/               # Database files
└── shared/
    └── mkcert/                     # CA certificates

Prossimi passi

• Gestire i siti WordPress in Docker – Creare e gestire i siti
• Controllare i container Docker – Avvio, arresto e accesso ai container