Collegare WordPress a un database MySQL

Collegare WordPress a un database MySQL: configurare correttamente il file wp-config.php

WordPress richiede un database MySQL o MariaDB per memorizzare contenuti, utenti, impostazioni, commenti, menu e molti dati dei plugin. La connessione tra WordPress e il database viene gestita tramite il file wp-config.php.

Se queste credenziali di accesso sono errate, compare frequentemente il messaggio d'errore "Errore di connessione al database" (o “Error establishing a database connection”).

Importante: Modificate il file wp-config.php con la massima attenzione. Un solo carattere errato, una virgoletta mancante o una password sbagliata possono impedire a WordPress di stabilire la connessione con il database.

Quali dati sono richiesti da WordPress?

Per la connessione al database, WordPress necessita di quattro informazioni fondamentali: nome del database, utente del database, password e host del database.

Voce in WordPress	Significato	Esempio
`DB_NAME`	Nome del database	`utente_wordpress`
`DB_USER`	Utente del database	`utente_wpuser`
`DB_PASSWORD`	Password dell'utente del database	La password del database da voi impostata
`DB_HOST`	Server del database	`localhost`

Nota: Nelle normali installazioni di WordPress su hosting cPanel, l'host del database è quasi sempre localhost. Utilizzate un valore diverso solo se espressamente specificato dal vostro ambiente di hosting.

Non dimenticare il prefisso cPanel

In cPanel, ai nomi dei database e agli utenti del database viene spesso assegnato automaticamente un prefisso. Questo prefisso si basa solitamente sul nome utente del cPanel ed è seguito da un carattere di sottolineatura (underscore).

Se ad esempio nell'assistente database inserite wordpress come nome del database, il nome completo in cPanel potrebbe apparire così:

utente_wordpress

È esattamente questo nome completo che dovrà essere inserito in seguito nel file wp-config.php. Lo stesso vale per l'utente del database.

Inserimento nell'assistente	Nome completo cPanel	Da usare in WordPress?
`wordpress`	`utente_wordpress`	Sì, utilizzare il nome completo
`wpuser`	`utente_wpuser`	Sì, utilizzare il nome completo

Modificare il file wp-config.php

Il file wp-config.php si trova normalmente nella cartella principale (root) della vostra installazione di WordPress. Potete modificarlo tramite il Gestione file di cPanel o via FTP.

Accedete al cPanel.
Aprite il Gestione file.
Spostatevi nella cartella del vostro sito WordPress, spesso public_html o una sottocartella dedicata.
Individuate il file wp-config.php.
Create una copia di backup del file prima di modificarlo.
Aprite il file per la modifica.
Verificate o modificate le voci del database.
Salvate il file e testate il sito web.

Raccomandazione: Salvate sempre una copia del file prima di apportare modifiche, ad esempio come wp-config-backup.php. Assicuratevi tuttavia di non lasciare tali copie di backup permanentemente accessibili al pubblico.

Esempio per le voci del database in wp-config.php

Le righe rilevanti nel file wp-config.php si presentano tipicamente così:

define( 'DB_NAME', 'utente_wordpress' );
define( 'DB_USER', 'utente_wpuser' );
define( 'DB_PASSWORD', 'LaVostraPasswordDelDatabase' );
define( 'DB_HOST', 'localhost' );

Sostituite i valori di esempio con i dati effettivi del vostro database, prestando attenzione a rispettare l'esatta grafia presente nel cPanel.

Assegnare l'utente al database

Un errore comune consiste nel creare il database e l'utente senza però collegare l'utente al database stesso. In questo caso, WordPress non sarà in grado di connettersi nonostante il nome e la password siano corretti.

Come verificare l'associazione:

In cPanel, aprite la funzione Database MySQL.
Cercate la sezione Aggiungi utente al database.
Selezionate l'utente del database corrispondente.
Selezionate il database corretto.
Cliccate su Aggiungi.
Per WordPress, selezionate di norma TUTTI I PRIVILEGI.
Salvate la selezione.

Senza i privilegi appropriati, WordPress non può leggere, scrivere o aggiornare le tabelle. Ciò può causare errori di installazione, problemi di aggiornamento o errori di connessione al database.

Errori frequenti con la connessione al database di WordPress

Errore	Possibile causa	Soluzione
Errore di connessione al database	Nome database, nome utente o password errati	Verificare le voci nel file `wp-config.php`
Access denied	L'utente non è assegnato o la password è errata	Verificare i privilegi utente in Database MySQL
Unknown database	Il nome del database è errato o inserito senza prefisso	Utilizzare il nome completo del database presente nel cPanel
Schermata bianca (White Screen of Death)	Errore PHP, conflitto di plugin o errore di configurazione	Controllare i registri degli errori (Error Logs) e annullare le ultime modifiche

Controlli da effettuare dopo il trasferimento di WordPress

Dopo una migrazione o un ripristino di WordPress, il database e i file devono corrispondere perfettamente. È particolarmente importante che il database importato sia lo stesso configurato nel file wp-config.php.

Database importato? Verificate in phpMyAdmin se le tabelle sono presenti.
È impostato il database corretto? Controllate DB_NAME.
È impostato l'utente corretto? Controllate DB_USER.
La password è aggiornata? Se avete modificato la password nel cPanel, essa deve essere aggiornata anche in WordPress.
I privilegi utente sono corretti? L'utente deve essere associato al database.
Il dominio è cambiato? In caso di cambio di dominio, potrebbero essere necessarie modifiche aggiuntive agli URL di WordPress all'interno del database.

Nota in caso di cambio di dominio: Se WordPress continua a reindirizzare al vecchio dominio dopo un trasferimento, ciò di solito non dipende dalla connessione al database stessa, ma dagli URL di WordPress memorizzati nel database o dai reindirizzamenti presenti nella configurazione del sito.

Prefisso delle tabelle in WordPress

Oltre alle credenziali di accesso al database, il file wp-config.php contiene anche il prefisso delle tabelle. Questo stabilisce con quale prefisso iniziano le tabelle di WordPress nel database.

$table_prefix = 'wp_';

Il prefisso delle tabelle deve corrispondere a quello delle tabelle effettive presenti nel database. Se ad esempio le vostre tabelle si chiamano wp_posts, wp_options e wp_users, il valore wp_ è corretto. Se le tabelle utilizzano un prefisso diverso, questo valore deve essere modificato di conseguenza.

Attenzione: Non modificate il prefisso delle tabelle in modo arbitrario. Se questo valore non corrisponde alle tabelle reali nel database, WordPress non sarà più in grado di trovare correttamente i propri contenuti e le proprie impostazioni.

Sicurezza relativa a wp-config.php

Il file wp-config.php contiene dati di accesso sensibili al database. Trattate pertanto questo file con estrema cautela.

Non divulgate pubblicamente il contenuto del file.
Non salvate le password del database in note non protette o file pubblici.
Utilizzate password del database forti e univoche.
Eliminate le copie non necessarie del file wp-config.php dopo aver completato le modifiche.
Modificate la password del database solo se siete pronti ad aggiornarla immediatamente anche in WordPress.

Riepilogo

La connessione tra WordPress e il vostro database MySQL o MariaDB è interamente gestita attraverso il file wp-config.php. Gli elementi determinanti sono il nome completo del database, l'utente completo del database, la password corretta e l'host del database corrispondente.

Con l'hosting cPanel è particolarmente importante non dimenticare il prefisso automatico assegnato ai nomi dei database e agli utenti. Inoltre, l'utente deve essere associato al database corretto e disporre di privilegi sufficienti.

Il vostro sito WordPress mostra un errore di connessione al database o non funziona correttamente dopo un trasferimento?
Il team tecnico di CURIAWEB è a vostra completa disposizione per verificare il file wp-config.php, l'accesso al database e i privilegi utente.

Apri un ticket di supporto

Collegare WordPress a un database MySQL