Il file wp-config.php contiene credenziali del database e costanti fondamentali di WordPress. Un errore di sintassi può bloccare il sito e il file completo non deve essere condiviso perché contiene informazioni riservate.
Credenziali del database e costanti fondamentali di WordPress. Un errore di sintassi può bloccare il sito e il file completo non deve essere condiviso perché contiene informazioni riservate.
Questa guida mostra come diagnosticare wp-config.php con un metodo ordinato, senza cancellazioni casuali e senza disattivare in modo permanente le protezioni. Prima di intervenire annota il sintomo, l’orario e l’ultima modifica eseguita.
Come riconoscere il problema
Il problema relativo a wp-config.php può apparire in modo costante oppure soltanto su un dispositivo, una rete, un indirizzo o una funzione. Verifica se coinvolge tutti gli utenti, se è iniziato dopo una modifica e se il messaggio cambia ripetendo lo stesso test.
- prova da una finestra anonima o da un secondo client;
- annota il testo integrale dell’errore;
- registra data, ora, URL, casella o record coinvolto;
- controlla se il problema riguarda un solo elemento o l’intero servizio;
- non modificare la configurazione prima di aver salvato lo stato iniziale.
Che cosa significa wp-config.php
Credenziali del database e costanti fondamentali di WordPress. Un errore di sintassi può bloccare il sito e il file completo non deve essere condiviso perché contiene informazioni riservate.
Il messaggio visibile non identifica sempre la causa. Occorre separare applicazione, rete, DNS, server, client e servizi esterni. Un test eseguito in un solo punto può essere influenzato da cache, credenziali salvate o configurazioni locali.
Cause più frequenti
1. Errore di sintassi
Questa causa va verificata con dati concreti e non soltanto in base al messaggio del browser o del client. Confronta configurazione attuale, log disponibili e comportamento da un secondo contesto prima di applicare la correzione.
2. Costante duplicata
Questa causa va verificata con dati concreti e non soltanto in base al messaggio del browser o del client. Confronta configurazione attuale, log disponibili e comportamento da un secondo contesto prima di applicare la correzione.
3. Codice inserito nel punto sbagliato
Questa causa va verificata con dati concreti e non soltanto in base al messaggio del browser o del client. Confronta configurazione attuale, log disponibili e comportamento da un secondo contesto prima di applicare la correzione.
4. Credenziali database modificate
Questa causa va verificata con dati concreti e non soltanto in base al messaggio del browser o del client. Confronta configurazione attuale, log disponibili e comportamento da un secondo contesto prima di applicare la correzione.
5. Snippet non affidabile
Questa causa va verificata con dati concreti e non soltanto in base al messaggio del browser o del client. Confronta configurazione attuale, log disponibili e comportamento da un secondo contesto prima di applicare la correzione.
6. Permessi o proprietario errati
Questa causa va verificata con dati concreti e non soltanto in base al messaggio del browser o del client. Confronta configurazione attuale, log disponibili e comportamento da un secondo contesto prima di applicare la correzione.
Diagnosi passo per passo
- Crea una copia del file. Esegui il controllo senza cambiare altre impostazioni. Salva il risultato, l’orario e l’eventuale messaggio tecnico; questi dati permettono di confrontare il passaggio successivo e di fornire informazioni utili all’assistenza.
- Usa php -l per la sintassi. Esegui il controllo senza cambiare altre impostazioni. Salva il risultato, l’orario e l’eventuale messaggio tecnico; questi dati permettono di confrontare il passaggio successivo e di fornire informazioni utili all’assistenza.
- Cerca costanti duplicate. Esegui il controllo senza cambiare altre impostazioni. Salva il risultato, l’orario e l’eventuale messaggio tecnico; questi dati permettono di confrontare il passaggio successivo e di fornire informazioni utili all’assistenza.
- Controlla il punto di inserimento. Esegui il controllo senza cambiare altre impostazioni. Salva il risultato, l’orario e l’eventuale messaggio tecnico; questi dati permettono di confrontare il passaggio successivo e di fornire informazioni utili all’assistenza.
- Leggi error_log. Esegui il controllo senza cambiare altre impostazioni. Salva il risultato, l’orario e l’eventuale messaggio tecnico; questi dati permettono di confrontare il passaggio successivo e di fornire informazioni utili all’assistenza.
- Confronta con il backup. Esegui il controllo senza cambiare altre impostazioni. Salva il risultato, l’orario e l’eventuale messaggio tecnico; questi dati permettono di confrontare il passaggio successivo e di fornire informazioni utili all’assistenza.
- Verifica permessi. Esegui il controllo senza cambiare altre impostazioni. Salva il risultato, l’orario e l’eventuale messaggio tecnico; questi dati permettono di confrontare il passaggio successivo e di fornire informazioni utili all’assistenza.
Procedura di risoluzione
- Attiva debug senza mostrarlo ai visitatori. Applica l’intervento soltanto dopo aver verificato la causa e conserva una copia della configurazione precedente. Ripeti lo stesso test e controlla che non siano comparsi effetti collaterali su altri servizi.
- Imposta memoria entro i limiti reali. Applica l’intervento soltanto dopo aver verificato la causa e conserva una copia della configurazione precedente. Ripeti lo stesso test e controlla che non siano comparsi effetti collaterali su altri servizi.
- Usa url forzati soltanto consapevolmente. Applica l’intervento soltanto dopo aver verificato la causa e conserva una copia della configurazione precedente. Ripeti lo stesso test e controlla che non siano comparsi effetti collaterali su altri servizi.
- Gestisci wp-cron con una sola strategia. Applica l’intervento soltanto dopo aver verificato la causa e conserva una copia della configurazione precedente. Ripeti lo stesso test e controlla che non siano comparsi effetti collaterali su altri servizi.
- Ruota salts dopo compromissione. Applica l’intervento soltanto dopo aver verificato la causa e conserva una copia della configurazione precedente. Ripeti lo stesso test e controlla che non siano comparsi effetti collaterali su altri servizi.
- Proteggi credenziali. Applica l’intervento soltanto dopo aver verificato la causa e conserva una copia della configurazione precedente. Ripeti lo stesso test e controlla che non siano comparsi effetti collaterali su altri servizi.
- Ripristina subito il backup se necessario. Applica l’intervento soltanto dopo aver verificato la causa e conserva una copia della configurazione precedente. Ripeti lo stesso test e controlla che non siano comparsi effetti collaterali su altri servizi.
Metodo di verifica consigliato
Dopo la correzione non limitarti a ricaricare una sola pagina. Ripeti il test originale, prova un secondo contesto e controlla il log o lo strumento che aveva mostrato il problema. Per DNS confronta resolver e autoritativi; per email confronta Webmail, client e Track Delivery; per WordPress verifica frontend, amministrazione e log; per cPanel ricontrolla quote e percorsi.
Attendi il tempo tecnico necessario soltanto quando esiste una cache o una coda reale. Non usare la “propagazione” come spiegazione generica per configurazioni che risultano ancora errate nei sistemi autoritativi.
Prevenzione
- mantieni un inventario aggiornato di domini, caselle, servizi e integrazioni;
- conserva backup verificati prima di modifiche importanti;
- usa password uniche e autenticazione a due fattori quando disponibile;
- aggiorna WordPress, plugin, temi e client supportati;
- monitora quota, log, DNS e consegna della posta;
- documenta ogni modifica con data, autore e motivo;
- rimuovi configurazioni, account e ambienti non più utilizzati.
Errori da evitare
- cambiare più impostazioni contemporaneamente;
- cancellare file, messaggi o database senza backup;
- disattivare globalmente firewall, WAF, TLS o sistemi di sicurezza;
- ripetere decine di tentativi che possono causare un blocco;
- copiare comandi o configurazioni senza comprenderne l’effetto;
- inviare password, codici 2FA, token, chiavi private o file completi nei ticket.
Quando contattare l’assistenza Xlogic
Apri un ticket quando il problema persiste dopo i controlli di base, coinvolge più servizi oppure richiede log o configurazioni non disponibili nel pannello. Indica dominio o casella, URL, data e ora, IP pubblico quando pertinente, errore completo e operazioni già eseguite.
Non inviare credenziali. L’assistenza può iniziare la diagnosi usando dati tecnici e, se necessario, indicarti una procedura sicura per ulteriori verifiche.
Fonti tecniche ufficiali
Domande frequenti su wp-config.php
Qual è il primo controllo per wp-config.php?
Annota il messaggio completo, la data e l’ora e verifica il comportamento da un secondo contesto. Poi controlla la configurazione specifica senza modificare più elementi insieme.
Posso risolvere modificando più impostazioni contemporaneamente?
È sconsigliato. Cambiare una sola impostazione alla volta consente di capire quale intervento ha prodotto il risultato e rende possibile il rollback.
Quando è necessario creare un backup?
Prima di modificare database, file di configurazione, DNS, caselle, redirect o dati che non possono essere ricostruiti facilmente.
Quali dati devo inviare all’assistenza Xlogic?
Dominio o casella coinvolta, URL, data e ora, messaggio completo, IP pubblico quando pertinente e controlli già eseguiti. Non inviare password.
Come verifico che il problema sia davvero risolto?
Ripeti lo stesso test, controlla log e risultato atteso e prova da un secondo dispositivo, rete, destinatario o resolver quando pertinente.