In breve: WP-CLI Error establishing a database connection — indica che WP-CLI non riesce ad aprire la connessione al database definita nella configurazione WordPress.
Indice dei contenuti
WP-CLI Error establishing a database connection: significato
Le prime ipotesi da verificare per “WP-CLI Error establishing a database connection” sono credenziali database errate; host o socket diverso per CLI.
Sintomi e cause probabili
Sintomi da verificare
- Il messaggio “WP-CLI Error establishing a database connection” compare durante un’operazione ripetibile.
- La funzione coinvolta in WP-CLI non raggiunge il risultato previsto.
- Il log dell’area WP-CLI registra un evento nello stesso minuto della prova.
- Il comportamento osservato in WP-CLI cambia in base a utente, rete, file o configurazione.
Cause probabili
- Credenziali database errate
- Host o socket diverso per CLI
- Servizio database non raggiungibile
- Wp-config.php condizionale in base all’ambiente
Diagnosi passo per passo
- Eseguire wp config get per i valori non sensibili
- Provare la connessione con il client MySQL
- Controllare host, porta e socket
- Verificare il percorso WordPress passato a WP-CLI
- Confrontare ambiente web e shell
Log e dati da controllare
- output completo del comando
- wp –info e percorso corrente
- error_log PHP o log del comando
Correzioni sicure
- Correggere host o socket
- Aggiornare le credenziali nel luogo previsto
- Rendere disponibile la configurazione anche alla CLI
- Avviare o ripristinare il servizio database
- Usare il percorso WordPress corretto
Verifica finale
- Il comando termina con exit code zero
- Il numero di oggetti modificati è quello previsto
- Il sito usa la stessa installazione e versione PHP
- Non risultano modifiche parziali inattese
Errori da evitare
- Non disattivare globalmente WAF, ModSecurity, antispam o verifica TLS per aggirare il sintomo
- Non impostare permessi 777 e non cambiare proprietari in modo ricorsivo senza conoscere la struttura dell’account
- Non cancellare database, chiavi Redis, cache o file di sistema senza backup e senza aver identificato l’oggetto coinvolto
- Non ripetere pagamenti, import o webhook reali finché non hai verificato l’idempotenza
Guide Xlogic correlate
- WP-CLI: db import file not found
- WP-CLI: database connection error dopo cambio PHP
- WP-CLI: Permission denied
Fonti tecniche
Domande frequenti
Che cosa significa “WP-CLI Error establishing a database connection”?
WP-CLI Error establishing a database connection — indica che WP-CLI non riesce ad aprire la connessione al database definita nella configurazione WordPress.
Da cosa può dipendere “WP-CLI Error establishing a database connection”?
Le cause da verificare per “WP-CLI Error establishing a database connection” sono: credenziali database errate; host o socket diverso per CLI; servizio database non raggiungibile.
Quali controlli eseguire per “WP-CLI Error establishing a database connection”?
Per diagnosticare “WP-CLI Error establishing a database connection”, controlla nell’ordine: eseguire wp config get per i valori non sensibili; provare la connessione con il client MySQL; controllare host, porta e socket. La soluzione è confermata quando il comando termina con exit code zero; il numero di oggetti modificati è quello previsto.