Come risolvere l'errore "Sembra che all'installazione di PHP manchi l'estensione MySQL" in WordPress?

Se vi è mai capitato di provare a installare o caricare WordPress e di visualizzare l'errore "Sembra che alla tua installazione di PHP manchi l'estensione MySQL, necessaria per WordPress", non siete i soli. Questo errore relativo alla mancanza dell'estensione MySQL in WordPress blocca completamente il vostro sito e può sembrare scoraggiante a prima vista.

La buona notizia è che quasi sempre si tratta di un problema relativo al driver PHP o alla configurazione del server MySQL. Seguendo i passaggi corretti, è possibile risolverlo anche senza conoscenze tecniche avanzate.

In breve: estensione MySQL mancante: ecco cosa devi sapere

• PHP non riesce a trovare il driver del database necessario per comunicare con MySQL, pertanto WordPress non si carica. Si tratta di un errore di caricamento dell'estensione PHP a livello del server.

• L'errore è solitamente causato da un aggiornamento di PHP, una migrazione del server o un file php.ini configurato in modo errato, che impedisce il caricamento del sito WordPress per tutti i visitatori.

• Nella maggior parte dei casi, l'attivazione dell'estensione MySQLi o PDO_MySQL in PHP risolve il problema.

• Se le modifiche a livello di server esulano dalle tue competenze, il tuo provider di hosting può implementare la soluzione rapidamente.

Panoramica dell'errore "Sembra che alla tua installazione di PHP manchi l'estensione MySQL" in WordPress

Questo errore si verifica quando WordPress non riesce a connettersi al database perché un'estensione MySQL necessaria è mancante o disabilitata nella configurazione PHP.

Che significato ha il messaggio di errore in WordPress?

Il messaggio di errore completo recita: "Sembra che alla tua installazione di PHP manchi l'estensione MySQL, necessaria per WordPress."

In parole semplici, PHP non riesce a trovare la libreria necessaria per comunicare con il database MySQL. Questa mancanza di un'estensione PHP causa un errore del database di WordPress prima che qualsiasi contenuto possa essere visualizzato.

Senza quella connessione, WordPress non può caricare alcun contenuto, impostazione o parte del tuo sito. L'intero sito web diventa inaccessibile.

Non si tratta di un bug di WordPress. È un problema a livello di server. WordPress si limita a rilevare il componente mancante e a segnalarlo.

Esempio del messaggio di errore "Estensione MySQL mancante"

Quando si verifica questo errore, di solito viene visualizzato uno dei seguenti messaggi su una schermata bianca vuota. Questa schermata bianca di WordPress spesso non fornisce ulteriori spiegazioni:

• "Sembra che alla tua installazione di PHP manchi l'estensione MySQL, necessaria per WordPress."

• “Non siamo riusciti a connetterci a MySQL.”

• Impossibile selezionare il database

Questi messaggi compaiono in genere prima del caricamento del pannello di amministrazione di WordPress. Potresti visualizzare questo errore anche durante una nuova installazione di WordPress, quando lo script di installazione non riesce a connettersi al database.

Perché questo errore compromette il tuo sito web WordPress?

WordPress è interamente basato su database. Ogni caricamento di pagina attiva una query PHP al database MySQL. Una connessione MySQL interrotta impedisce a WordPress di eseguire le seguenti operazioni:

• Recupera articoli, pagine, categorie o commenti.
• Carica le impostazioni e le configurazioni dei widget del tema attivo.
• Autenticare gli accessi degli utenti.
• Esegui le funzionalità di qualsiasi plugin installato.

Il risultato è un sito web completamente non funzionante. I visitatori visualizzano una schermata di errore anziché i contenuti.

Relazione tra PHP, MySQL e la connessione al database di WordPress

PHP è il linguaggio di scripting alla base di WordPress. MySQL è il database relazionale che memorizza tutti i dati del tuo sito: articoli, utenti, impostazioni, dati dei plugine altro ancora.

Questi due sistemi comunicano tramite un'estensione PHP che funge da ponte. WordPress gestisce internamente questa comunicazione attraverso il suo livello di astrazione del database, la classe wpdb.

Ogni volta che un visitatore accede al tuo sito, PHP invia query a MySQL tramite la classe wpdb, recupera i dati pertinenti e restituisce i risultati come pagina HTML. Se l'estensione PHP necessaria per questa comunicazione è mancante o disabilitata, l'intero processo fallisce.

WordPress verifica la presenza di questa estensione all'avvio. Se non la trova, genera immediatamente un errore di tipo "estensione MySQL mancante".

MySQL vs MySQLi vs PDO: una spiegazione di MySQL

Tre estensioni PHP sono in grado di gestire le connessioni al database MySQL:

• MySQL: L'estensione MySQL originale per PHP. È stata deprecata in PHP 5.5 e rimossa definitivamente in PHP 7.0. Anche WordPress ha interrotto il supporto per essa contemporaneamente. Se il tuo server utilizza PHP 7.0 o versioni successive (come dovrebbe), questa estensione non è disponibile. Il suo utilizzo non è mai stata una soluzione a lungo termine.

• MySQLi: l'estensione "migliorata" di MySQL (la "i" sta per improved, migliorata). È possibile abilitare MySQLi in PHP tramite php.ini o il pannello di controllo del proprio hosting. Supporta sia la programmazione orientata agli oggetti che quella procedurale. Aggiunge inoltre funzionalità come le istruzioni preparate e le istruzioni multiple. WordPress utilizza MySQLi per impostazione predefinita quando è disponibile.

• PDO_MySQL: PHP Data Objects, un'interfaccia di database più astratta. Supporta diversi sistemi di database tramite un'unica API coerente. WordPress può utilizzare PDO_MySQL come soluzione di ripiego quando MySQLi non è disponibile.

Le versioni moderne di WordPress richiedono l'installazione e l'attivazione di MySQLi o PDO_MySQL. In assenza di uno dei due, viene visualizzato immediatamente l'errore relativo all'estensione MySQL mancante.

Quali sono le cause dell'errore "Estensione MySQL mancante" in WordPress?

Diversi scenari distinti possono innescare questo errore. Identificare la causa principale è il primo passo per trovare la soluzione corretta.

• Aggiornamento di PHP senza trasferimento delle estensioni: Quando si aggiorna PHP, ad esempio da PHP 7.4 a PHP 8.1 o 8.2, la nuova installazione di PHP potrebbe non includere automaticamente tutte le estensioni precedentemente attive. Il pacchetto php-mysqli deve spesso essere reinstallato separatamente. L'estensione MySQLi può essere omessa dalla nuova installazione, anche se era attiva nella precedente. Questa è una delle cause più comuni di errore negli ambienti di produzione.

• Migrazione del server: il trasferimento del sito WordPress su un nuovo server o il cambio di provider di hosting possono comportare una configurazione errata dell'ambiente PHP. Non tutte le configurazioni dello stack server abilitano MySQLi per impostazione predefinita. Il nuovo server potrebbe eseguire PHP senza di esso.

• File php.ini danneggiato o incompleto. Il file php.ini controlla ogni aspetto del tuo ambiente PHP, inclusi i tipi di estensioni che vengono caricate e la posizione in cui PHP le cerca tramite la extension_dir . Se questo file è danneggiato, incompleto o manca la riga corretta per l'estensione MySQLi, PHP genererà un errore all'avvio e WordPress non sarà in grado di trovare il driver necessario.

• Esecuzione simultanea di più versioni di PHP. Alcuni server eseguono più versioni di PHP contemporaneamente. Se WordPress punta alla versione errata di PHP, ovvero a una versione priva di MySQLi, verrà visualizzato questo errore anche se altri siti sullo stesso server funzionano correttamente. Questo conflitto di versione di PHP è facile da non notare perché il pannello di controllo dell'hosting potrebbe mostrare la versione corretta mentre il server web ne utilizza una diversa.

• Installazione pulita su un server personalizzato: le nuove installazioni di WordPress su server locali configurati su misura, come XAMPP, MAMP, Laragon o container Docker, spesso non abilitano MySQLi per impostazione predefinita. Gli sviluppatori che configurano ambienti locali si imbattono frequentemente in questo problema perché l'estensione php-mysqli deve essere abilitata manualmente nella maggior parte delle configurazioni predefinite di XAMPP e MAMP.

• Modifiche alla configurazione del provider di hosting: i provider di hosting a volte modificano le configurazioni dei server durante le finestre di manutenzione o gli aggiornamenti dell'infrastruttura. Queste modifiche possono disabilitare inavvertitamente estensioni precedentemente attive.

Metodi per risolvere l'errore "Estensione MySQL mancante" in WordPress

È possibile risolvere questo problema abilitando l'estensione MySQL, aggiornando PHP o correggendo le impostazioni di configurazione sul server.

Metodo 1: Installare o abilitare l'estensione MySQLi in PHP

Questa è la soluzione più diretta. Su un server Linux, è possibile installare l'estensione MySQLi tramite il gestore di pacchetti. Il pacchetto si chiama in genere php-mysqli sui sistemi basati su Debian.

Per Ubuntu o Debian (installare php-mysqli):

sudo apt install php-mysqli sudo service apache2 restart

Per CentOS o RHEL:

sudo yum install php-mysqli sudo systemctl restart httpd

Dopo l'installazione, riavvia il server web. Quindi ricarica il tuo sito WordPress per verificare se l'errore è stato risolto.

Se utilizzi un hosting condiviso, cerca la sezione "Estensioni PHP" o "Seleziona estensioni PHP" nel tuo pannello di controllo (cPanel, Plesk o simili). Individua mysqli nell'elenco e abilitalo, quindi salva. La modifica di solito ha effetto immediato.

Metodo 2: Verifica e aggiorna o effettua il downgrade della versione di PHP

Una versione di PHP incompatibile è una causa frequente. WordPress raccomanda ufficialmente PHP 8.1 o superiore.

L'esecuzione di una versione non supportata, soprattutto se priva di estensioni fondamentali, causa questo errore. Sia PHP 8.1 che PHP 8.2 includono MySQLi di default sui server configurati correttamente.

Per verificare e modificare la versione di PHP:

• Accedi al pannello di controllo del tuo hosting.

• Cerca "Versione PHP", "MultiPHP Manager" o un'opzione simile (in cPanel, si trova sotto "Software").

• Passa a PHP 8.1 o 8.2, entrambi i quali includono MySQLi di default.

Se un recente aggiornamento ha causato problemi al tuo sito, puoi ripristinare temporaneamente la versione precedente per poter indagare. Alcuni provider di hosting consentono la selezione della versione di PHP per ciascun dominio.

Prima di applicare le modifiche alla versione di PHP in produzione, testale sempre su un sito di staging. Un'incompatibilità di versione può causare malfunzionamenti di plugin e temi, oltre a provocare errori nel database.

Metodo 3: Aggiornare il core di WordPress, i temi e i plugin

File di base, temi o plugin obsoleti a volte causano errori di compatibilità, inclusi malfunzionamenti a livello del database PHP.

WordPress aggiorna regolarmente la sua classe di astrazione del database interna (wpdb) per supportare le versioni più recenti di PHP e i requisiti di compatibilità con MySQL.

Per aggiornare WordPress:

• accedi a Dashboard → Aggiornamenti Nel pannello di amministrazione,
• Fai clic su Aggiorna ora per il core di WordPress.
• Successivamente, aggiorna tutti i plugin e i temi attivi.

Se non riesci ad accedere al pannello di amministrazione perché l'errore lo blocca, aggiorna tramite FTP caricando i file di WordPress più recenti scaricati direttamente da WordPress.org. Questo è un metodo sicuro per aggiornare i file principali senza modificare la cartella wp-content.

Eseguite sempre un backup completo del sito e del database prima di effettuare qualsiasi aggiornamento. In questo modo proteggerete i vostri dati in caso di problemi durante il processo.

Metodo 4: Verificare la configurazione PHP utilizzando phpinfo()

La phpinfo() genera un report dettagliato dell'ambiente PHP del server. Eseguire un controllo con phpinfo() su WordPress è uno dei modi più rapidi per verificare se è caricato MySQLi o PDO_MYSQL.

• Crea un nuovo file chiamato info.php nella directory principale di WordPress.
• Aggiungi questa singola riga: <?php phpinfo(); ?>
• Visita yourdomain.com/info.php nel tuo browser.
• Utilizza CTRL+F per cercare "mysqli" o "pdo_mysql" nell'output.

Se visualizzi una sezione intitolata "mysqli" con lo stato "abilitato", l'estensione è caricata. Se non è presente, l'estensione non è installata e deve essere aggiunta.

Nota sulla sicurezza: eliminate immediatamente il info.php dopo aver effettuato il controllo. Lasciarlo accessibile espone dati dettagliati sulla configurazione del server a chiunque visiti l'URL.

Metodo 5: Risolvere i problemi di configurazione del file php.ini

Il file php.ini determina quali estensioni PHP vengono caricate all'avvio. Un carattere di commento (punto e virgola) all'inizio della riga dell'estensione ne impedisce il caricamento. La riga che stai cercando è extension=mysqli.

• Accedi al tuo server tramite FTP o SSH.
• Individua il tuo file php.ini. I percorsi più comuni includono /etc/php/8.1/apache2/php.ini o /etc/php.ini.
• Cerca la riga: ;extension=mysqli
• Rimuovi il punto e virgola per decommentarlo: extension=mysqli
• Salva il file e riavvia il server web.

Se il tuo provider di hosting limita l'accesso diretto al file php.ini, crea un .user.ini nella directory principale di WordPress. Aggiungi la riga `extension=mysqli` e salva. PHP rileverà automaticamente questo .user.ini sulla maggior parte delle piattaforme di hosting condiviso.

Metodo 6: Risolvere i conflitti tra versioni multiple di PHP

Sui server che eseguono più versioni di PHP, WordPress potrebbe essere assegnato alla versione sbagliata. Se tale versione non include MySQLi, viene visualizzato l'errore.

Per risolvere questo problema:

• Verifica quale versione di PHP sta utilizzando il tuo sito (tramite phpinfo() come descritto nel Metodo 4).

• Nel pannello di controllo cPanel, apri MultiPHP Manager e assegna la versione corretta di PHP al tuo dominio.

• Apri Seleziona Estensioni PHP e assicurati che mysqli sia abilitato per quella specifica versione.

Su un server autogestito, usa `php -v` nel terminale per verificare la versione attiva e `php -m | grep mysqli` per verificare se MySQLi è caricato per quel binario. Se `php -m | grep mysqli` non restituisce nulla, l'estensione non è presente per quella versione.

Metodo 7: Reinstallare PHP e le estensioni necessarie

Se l'attivazione di MySQLi non riesce, l'installazione di PHP potrebbe essere danneggiata. Una reinstallazione pulita di PHP e del modulo mysqli risolve il problema.

Su Ubuntu o Debian:

sudo apt purge php8.1 php8.1-mysql sudo apt install php8.1 php8.1-mysqli sudo service apache2 restart

Su CentOS o RHEL:

sudo yum remove php php-mysql sudo yum install php php-mysqli sudo systemctl restart httpd

Dopo la reinstallazione, esegui il comando `php -m | grep mysqli` nel terminale per verificare che l'estensione sia ora attiva. Dovresti vedere "mysqli" nell'output.

Metodo 8: Verifica della configurazione dello stack del server (Apache o Nginx e MySQL)

Il server web deve instradare correttamente le richieste PHP all'interprete PHP appropriato. Una configurazione errata in questo ambito può impedire il caricamento delle estensioni, anche se installate.

• Per Apache: verifica che mod_php o php-fpm siano configurati correttamente. Apache mod_php carica PHP direttamente come modulo, mentre PHP-FPM viene eseguito come processo separato. Controlla la configurazione del tuo VirtualHost per confermare che sia assegnato il gestore PHP corretto.

• Per Nginx: Nginx non esegue PHP nativamente e richiede sempre PHP-FPM. Verifica che la fastcgi_pass nel blocco server punti al file socket PHP-FPM corretto. Assicurati che il pool PHP-FPM esegua la versione che supporta MySQLi.

Dopo aver apportato qualsiasi modifica, riavviare sia il server web che PHP-FPM:

sudo systemctl restart nginx sudo systemctl restart php8.1-fpm

Per saperne di più: Apache vs Nginx: qual è la soluzione migliore per l'hosting di WordPress?

Metodo 9: Contatta il tuo provider di hosting per ricevere assistenza

Se uno qualsiasi dei metodi sopra descritti vi sembra troppo tecnico, il vostro provider di hosting è la via più rapida per risolvere il problema. La maggior parte dei provider di hosting WordPress gestito risolve i problemi relativi alle estensioni PHP in pochi minuti, come parte del supporto standard.

Quando contatti l'assistenza, includi le seguenti informazioni:

• Il messaggio di errore esatto che stai visualizzando.

• La versione di PHP attualmente utilizzata dal tuo sito (da phpinfo o cPanel).

• L'errore si è verificato per la prima volta dopo un aggiornamento, una migrazione o una manutenzione del server.

I provider che offrono hosting WordPress gestito si occupano per conto dell'utente delle configurazioni PHP a livello di server, incluso il supporto per le estensioni PHP.

Su hosting condiviso, il team di supporto può abilitare MySQLi dal lato server senza richiedere alcuna azione da parte vostra.

Risoluzione avanzata dell'errore "Estensione MySQL mancante" in WordPress

Se i metodi standard sopra descritti non hanno risolto l'errore, queste tecniche avanzate possono aiutare a individuare il problema.

Controlla il tuo file wp-config.php. Anche con MySQLi installato, credenziali di database errate nel file wp-config.php impediranno la connessione. Apri wp-config.php e verifica le seguenti impostazioni del database:

define( 'DB_NAME', 'your_database_name' ); define( 'DB_USER', 'your_database_username' ); define( 'DB_PASSWORD', 'your_database_password' ); define( 'DB_HOST', 'localhost' );

Un valore errato in uno qualsiasi di questi campi, in particolare in DB_HOST, può generare errori che a prima vista sembrano essere errori di estensione mancante.

Alcuni provider di hosting utilizzano un nome host specifico al posto di localhoste l'utilizzo di un valore errato blocca la connessione anche quando MySQLi è installato correttamente.

Attiva la modalità di debug di WordPress. Aggiungi queste righe al wp-config.php per attivare la segnalazione dettagliata degli errori. WP_DEBUG_LOG salva tutti gli errori in un file anziché visualizzarli pubblicamente:

definisci( 'WP_DEBUG', vero ); definisci( 'WP_DEBUG_LOG', vero ); definisci( 'WP_DEBUG_DISPLAY', falso );

Il file WP_DEBUG_LOG viene salvato in wp-content/debug.log. Cerca in questo file messaggi relativi all'estensione PHP o errori di avvio di PHP. Le righe che menzionano mysqli_connect, "Call to undefined function"o nomi di moduli mancanti indicano direttamente un problema con l'estensione.

Esamina i log degli errori del server. Apache memorizza i log degli errori in /var/log/apache2/error.log. Nginx utilizza /var/log/nginx/error.log. Questi log degli errori del server spesso riportano il motivo esatto per cui un'estensione PHP non è stata caricata, ad esempio una libreria condivisa mancante, un extension_dir o un problema di permessi di file che impedisce la lettura dell'estensione.

Verifica la presenza di software di sicurezza in conflitto. I firewall per applicazioni web (WAF), gli antivirus a livello di server e i plugin di sicurezza aggressivi di WordPress possono occasionalmente interferire con il caricamento delle estensioni PHP o bloccare le richieste di handshake del database. Disabilitali temporaneamente e riprova. Se l'errore scompare, la causa era lo strumento di sicurezza. Riattivalo e aggiungi la porta di connessione al database (in genere la 3306) alla whitelist per ripristinare la protezione senza conflitti.

Esegui i test in un ambiente di staging. Non testare mai le modifiche a livello di server direttamente su un sito attivo. Utilizza un ambiente di staging per applicare e verificare le correzioni prima di implementarle in produzione. La maggior parte dei provider di hosting gestito include l'ambiente di staging nei propri piani.

Procedure consigliate per prevenire errori di estensione MySQL in WordPress

Prevenire è sempre più economico e meno stressante che rimediare. Queste pratiche riducono la probabilità che questo errore si verifichi sul tuo sito WordPress.

• Mantieni PHP aggiornato e conforme ai requisiti di WordPress. Utilizza sempre una versione di PHP che corrisponda alle raccomandazioni attuali di WordPress (PHP 8.1 o superiore a partire dal 2024-2025). Quando aggiorni PHP, verifica che tutte le estensioni richieste, MySQLi e PDO_MySQL siano esplicitamente incluse nella nuova installazione. Consulta la pagina ufficiale dei requisiti PHP di WordPress prima di ogni aggiornamento.

• Testa gli aggiornamenti PHP su un sito di staging. Prima di aggiornare PHP sul tuo sito live, esegui la nuova versione su un ambiente di staging. Effettua un test di compatibilità PHP con WordPress utilizzando strumenti come il plugin PHP Compatibility Checker. Verifica che MySQLi si carichi correttamente e che tutti i plugin e i temi rimangano compatibili prima di implementare le modifiche in produzione.

• Utilizza un hosting WordPress gestito. I provider di hosting gestito si occupano automaticamente della configurazione PHP a livello di server. Mantengono PHP e le sue estensioni aggiornati e configurati correttamente, riducendo notevolmente il rischio di questo tipo di errore.

• Effettua regolarmente backup del sito. Mantieni sempre copie di backup aggiornate sia dei file di WordPress che del database. Se una modifica al server causa questo errore, un backup ti permette di ripristinare uno stato funzionante mentre risolvi la causa principale.

• Monitora il tuo sito con il monitoraggio del tempo di attività. Il monitoraggio in tempo reale del tempo di attività di WordPress ti avvisa non appena il tuo sito va offline. Un avviso di inattività significa che puoi individuare un errore dell'estensione MySQL in pochi minuti anziché in ore. Ridurre al minimo i tempi di inattività protegge i tuoi visitatori, il posizionamento sui motori di ricerca e i tuoi ricavi.

• Documenta la tua infrastruttura server. Se gestisci il server in autonomia, conserva registrazioni dettagliate di tutte le estensioni PHP e le configurazioni in uso. Questa documentazione semplifica notevolmente la replica dell'ambiente dopo migrazioni o aggiornamenti importanti.

• Segui una routine di manutenzione regolare per WordPress. Una routine di manutenzione strutturata, che includa aggiornamenti del core, dei plugin e dei temi, controlli della versione di PHP e ottimizzazione del database di WordPress, previene modifiche alla configurazione e individua i problemi di compatibilità prima che causino errori sul sito attivo. Pianifica una revisione mensile della configurazione di PHP insieme alle normali attività di manutenzione.

Considerazioni finali

L'errore "Sembra che alla tua installazione di PHP manchi l'estensione MySQL" è fastidioso ma risolvibile. Nella maggior parte dei casi, il problema è dovuto a un'estensione MySQLi disabilitata o mancante nella configurazione di PHP, un problema relativo all'estensione del database di PHP piuttosto che a un problema di WordPress.

Iniziate con la soluzione più semplice: verificate se MySQLi è abilitato nel pannello di controllo del vostro hosting e, in caso contrario, abilitatelo. Se questo non risolve il problema, procedete con i metodi successivi in ​​ordine, controllando la versione di PHP, modificando il file php.ini con la riga `extension=mysqli`e, se necessario, reinstallando PHP.

Quando le modifiche a livello di server esulano dalle tue competenze, il tuo provider di hosting è solitamente in grado di risolverle in pochi minuti.

Ancora più importante, è fondamentale creare le condizioni ottimali per evitare che questo errore si ripeta. Mantieni PHP aggiornato, utilizza un hosting WordPress gestito e impegnati in una regolare manutenzione. Un sito WordPress ben gestito evita la maggior parte di questi errori prima che raggiungano i tuoi visitatori e si ripristina rapidamente quando si verificano.

Domande frequenti sulla risoluzione dell'errore "Sembra che all'installazione di PHP manchi l'estensione MySQL"